Yii2.0.43+Bootstrap4环境下单选Select2搜索功能无法启用如何解决？

问题原因 #

该问题由两个常见原因导致：

• 你将class配置错误写在了Select2小部件的顶层参数中，该属性应该放入options数组内，错误的配置位置会引发样式冲突，导致单选模式下搜索输入框被遮挡/不可编辑
• 未指定Select2的主题适配Bootstrap4，默认主题和Bootstrap4的样式不兼容也会触发该异常

修复后的代码 #

<?php
echo '<label>Roles</label>';
try {
    echo Select2::widget([
        'id' => 'user-roles',
        'name' => 'roles',
        'data' => $listOfRoles,
        'options' => [
            'placeholder' => 'Roles',
            'class' => 'form-control', // class参数移入options数组
        ],
        'pluginOptions' => [
            'allowClear' => true,
            'theme' => 'bootstrap4', // 明确指定适配Bootstrap4的主题
            'minimumResultsForSearch' => 0 // 强制显示搜索框，不受选项数量限制
        ]
    ]);
} catch (Exception $e) {
    echo $e->getMessage();
}
?>

额外排查方案 #

如果修改后仍然存在问题，可以检查页面控制台是否有JS报错，确认是否存在重复加载Select2资源、JQuery版本不兼容的情况。

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