Yii2视图中如何自定义数组生成的Select2筛选下拉选项的显示文本？

核心思路 #

你现在的下拉选项只展示原始缩写，本质是构建选项数组时直接把数据库里的缩写字段值作为了展示内容。只要在生成下拉键值对时，把展示文本替换为自定义的「缩写+全称」格式，同时严格保证选项实际提交的筛选值还是原始缩写，就能在不改动现有GridView列配置、不破坏原有筛选逻辑的前提下实现需求。

具体实现步骤 #

1. 配置自定义展示映射规则 #

首先定义需要调整的缩写与对应展示文本的映射关系，不需要改动原有数据查询逻辑：

// 自定义缩写对应的下拉展示内容，未在映射里的选项会默认展示原始缩写
$ordineDisplayMap = [
    'OFMCap' => 'OFMCap - Ordo fratrum minorum capuccinorum',
    // 后续需要新增自定义展示的条目直接往这个数组追加即可
];

2. 调整选项数组的构建逻辑 #

把原来循环生成选项的代码修改为，生成展示文本时优先匹配自定义映射，匹配不到就回退使用原始缩写，同时保留选项的实际提交值为原始字段值：

$ordine_nome = [];
$ordini = Elenchi::find()->asArray()->orderBy(['Ordine' => SORT_ASC])->all();
foreach($ordini as $l){
    $rawOrdineValue = $l['Ordine'];
    // 优先取自定义映射的展示文本，无映射则使用原始值
    $displayText = $ordineDisplayMap[$rawOrdineValue] ?? $rawOrdineValue;
    $ordine_nome[] = [
        'id' => $rawOrdineValue, // 选项实际提交的value保持原始值，不破坏原有筛选逻辑
        'ordine' => $displayText // 下拉框内展示的自定义文本
    ];
}

修改完成后，原有GridView的列配置代码完全不需要调整——因为ArrayHelper::map($ordine_nome,'id','ordine')依然会生成「value=原始缩写，展示文本=自定义内容」的标准Select2下拉数组，和原有逻辑的兼容度100%。

适配场景：如果全称存储在数据库字段中 #

如果不需要硬编码映射，全称本身就存在Elenchi表的其他字段（比如full_name）里，只需要在查询时把对应字段取出，直接拼接展示文本即可：

$ordine_nome = [];
// 查询时把存全称的字段一起取出
$ordini = Elenchi::find()->asArray()
    ->select(['Ordine', 'full_name'])
    ->orderBy(['Ordine' => SORT_ASC])
    ->all();
foreach($ordini as $l){
    $rawOrdineValue = $l['Ordine'];
    // 拼接格式为「缩写 - 全称」，全称不存在时自动去掉连接符
    $displayText = trim($rawOrdineValue . ' - ' . ($l['full_name'] ?? ''), ' -');
    $ordine_nome[] = [
        'id' => $rawOrdineValue,
        'ordine' => $displayText
    ];
}

注意事项：

• 不要修改数组里id对应的原始值，这个值是筛选时提交给后端的匹配依据，一旦改动会出现筛选结果不匹配的问题
• Select2的清除按钮、占位符这些原有配置都会正常生效，不需要额外调整filterWidgetOptions的参数

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