我无法理解 MediaWiki HTMLForm 手册

I fail to understand MediaWiki HTMLForm manual

我想更改默认的 MediaWiki ContactPage 联系表单,这样我的表单 就不会 包含:

相反,我希望它只包含一个简单的 select 列表和(已经存在的)可输入电子邮件字段。

select 列表应该是这种模式:

<select name="fruits">
    <option value ="none">Nothing</option>
    <option value ="guava">Guava</option>
    <option value ="lychee">Lychee</option>
    <option value ="papaya">Papaya</option>
</select>

因为在 MediaWiki 中,可以通过任何 HTMLForm(模板引擎)模板自定义 PHP ContactPage 联系表单,
我尝试阅读 in HTMLForm manual 以了解用于 select 列表的模板;
我发现以下模板 omgaselectbox 最合适:

'omgaselectbox' => [
    'class' => 'HTMLSelectField',
    'label' => 'Select an oooption',
    'options' => [
        'Pirates' => 'pirate',
    'Ninjas' => 'ninja',
    'Back to the NINJAR!' => 'ninjars',
    ],
],

我的问题

我无法从 ContactForm 和 HTMLForm 手册中了解什么是 omgaselectbox - 如果它只是一个名称或命令,
我进一步不明白这些手册是否应该更改最终联系表格代码,包括:

'AdditionalFields' => array(
    'Text' => array(
        'label-message' => 'emailmessage',
            'type' => 'textarea',
            'rows' => 20,
            'required' => true,  // Either "true" or "false" as required
    ),
    'omgaselectbox' => [
        'class' => 'HTMLSelectField',
        'label' => 'Select an oooption',
        'options' => [
            'Pirates' => 'pirate',
        'Ninjas' => 'ninja',
        'Back to the NINJAR!' => 'ninjars',
        ],
    ],
),

只包括这个:

'AdditionalFields' => array(
    'omgaselectbox' => [
        'class' => 'HTMLSelectField',
        'label' => 'Select an oooption',
        'options' => [
            'Pirates' => 'pirate',
        'Ninjas' => 'ninja',
        'Back to the NINJAR!' => 'ninjars',
        ],
    ],
),

我的问题

omgaselectbox 是什么意思,我对最终联系表格代码的正确之处是什么?

数组键是字段名(即结果<input><select>name属性;也是值数组中的数组键在处理和验证表单提交后由 HTMLForm 返回)。大概它代表“OMG一个select盒子!”

您可以删除 Text 字段,但用户将无法编写消息,这可能不是您想要的。

以下"answer"只是我接受的user:Tgr答案的改写;
我以一种我觉得更有序、更清晰的方式重写了它;在我看来,它不应该被赞成或反对。
如果我有任何错误,我很抱歉 - 请对此类错误发表评论。


据推测,omgaselectbox中的omg代表“OMG,一个select框!”

数组键是字段名(即结果<input><select>name属性;也是值数组中的数组键在处理和验证表单提交后由 HTMLForm 返回)。大概它代表“OMG一个select盒子!” 数组键是字段名称(即结果 <input><select>name 属性;
同样,它是在处理表单提交后由 HTMLForm 与值数组一起返回的数组键。

也就是说,
您可以删除 Text 字段,但用户将无法编写消息,这可能不是您想要的。