Yii2自定义下拉菜单渲染异常：选项转为optgroup而非带样式option

你遇到的问题核心有两点：

1. 视图传参格式错误：传入的选项结构不符合Yii2 dropDownList的要求，且自定义方法的参数接收逻辑不匹配，导致Yii将多维数组解析为optgroup嵌套结构。
2. 自定义方法未处理选项属性映射：直接将错误格式的数组传给原生方法，没有完成自定义格式到Yii2要求格式的转换。

Yii2原生dropDownList支持给单个<option>设置属性的标准格式为：

[
    '选项值1' => ['label' => '显示文本1', 'options' => ['属性名' => '属性值']],
    '选项值2' => ['label' => '显示文本2', 'options' => ['属性名' => '属性值']]
]

方案一：适配Yii2原生格式（最简方案） #

1. 保留现有自定义方法 #

无需修改方法逻辑，确保参数传递符合原生要求：

public function customDropdown($model, $attribute, $items = [], $options = [])
{
    $field = $this->field($model, $attribute, $options);
    return $this->staticOnly ? $field : $field->dropDownList($items);
}

2. 修正视图调用格式 #

按照Yii2标准结构传入选项，同时修正语法错误（选项数组间需加逗号）：

<?= $form->customDropdown($dpForm, 'color', [
    'red' => [
        'label' => 'red',
        'options' => ['style' => 'color: red']
    ],
    'blue' => [
        'label' => 'blue',
        'options' => ['style' => 'color: blue']
    ]
]) ?>

方案二：兼容自定义label/value/options格式 #

如果你更习惯用最初的label/value/options结构传参，可以在自定义方法中添加格式转换逻辑：

1. 修改自定义方法 #

public function customDropdown($model, $attribute, $rawItems = [], $options = [])
{
    // 将自定义格式转换为Yii2原生支持的格式
    $items = [];
    foreach ($rawItems as $item) {
        $items[$item['value']] = [
            'label' => $item['label'],
            'options' => $item['options'] ?? []
        ];
    }
    
    $field = $this->field($model, $attribute, $options);
    return $this->staticOnly ? $field : $field->dropDownList($items);
}

2. 视图调用（保持你习惯的格式） #

注意添加选项数组间的逗号：

<?= $form->customDropdown($dpForm, 'color', [
    [
        'label' => 'red',
        'value' => 'red',
        'options' => ['style' => 'color: red']
    ],
    [
        'label' => 'blue',
        'value' => 'blue',
        'options' => ['style' => 'color: blue']
    ]
]) ?>

两种方案都能渲染出你期望的HTML结构：

<option value="red" style="color: red">red</option>
<option value="blue" style="color: blue">blue</option>

内容的提问来源于stack exchange，提问作者TLausie