本文旨在解决yii2框架中select2多选框组件在处理包含重复数据源时，同一选项多次显示的问题。通过预处理数据源，确保传递给select2的数据项在分组显示时仍保持唯一性，从而优化用户体验并保持数据展示的准确性。
问题描述
在使用Yii2的Select2组件，并开启multiple多选模式时，我们常常需要从复杂的数据源中获取选项。一个常见场景是，数据源将员工按所属部门或办公室进行分组。例如，一个员工可能同时属于“主办公室”和“办公室1”。当Select2的data属性直接接收这种分组数据时，如果未进行特殊处理，该员工就会在不同的分组下重复显示，导致用户在选择时看到多个相同的选项，这不仅影响用户体验，也可能造成混淆。
以下是一个典型的分组数据结构示例，其中员工ID为2的“123 123”在“main office”和“office 1”中都出现了：
$allStaffsGroupOffice = [
"main office" => [
2 => "123 123"
],
"office 1" => [
3 => "staff_1",
6 => "staff_2",
2 => "123 123" // 重复项
],
"office 3" => [
4 => "staff_3",
3 => "staff_1"
],
"office 2" => [
5 => "staff_4",
3 => "staff_1"
]
];当这样的数据直接传入Select2时，最终的下拉列表会显示多个“123 123”选项，尽管它们代表的是同一个员工。
解决方案：数据预处理
解决此问题的核心思想是在将数据传递给Select2组件之前，对数据源进行预处理，确保每个唯一的员工只出现一次。这意味着我们需要遍历原始的分组数据，并在保持原有分组结构的同时，对重复的员工进行去重。
实现步骤
- 初始化辅助变量：创建一个空数组$repeatedStaff用于记录已经处理过的员工ID，以及一个空数组$newUniqueList用于存储去重后的新数据。
- 遍历原始数据：对外层（办公室）和内层（员工列表）进行嵌套遍历。
- 去重判断：在内层循环中，对于每个员工，检查其ID是否已存在于$repeatedStaff数组中。
- 添加唯一项：如果员工ID尚未被记录，则将其ID添加到$repeatedStaff中，并将其添加到$newUniqueList中对应的办公室分组下。
以下是实现此逻辑的PHP代码示例：
// 假设这是从 Tasks::getAllStaffsGroupOffice() 获取的原始数据
$allStaffsGroupOffice = [
"main office" => [
2 => "123 123"
],
"office 1" => [
3 => "staff_1",
6 => "staff_2",
2 => "123 123"
],
"office 3" => [
4 => "staff_3",
3 => "staff_1"
],
"office 2" => [
5 => "staff_4",
3 => "staff_1"
]
];
$repeatedStaff = []; // 用于记录已处理的员工ID
$newUniqueList = []; // 存储去重后的新数据
foreach ($allStaffsGroupOffice as $officeName => $staffList) {
foreach ($staffList as $staffId => $staffName) {
// 如果该员工ID尚未被添加到去重列表中
if (!in_array($staffId, $repeatedStaff)) {
// 记录该员工ID，表示已处理
$repeatedStaff[] = $staffId;
// 将该员工添加到新列表中，并保留其办公室分组
$newUniqueList[$officeName][$staffId] = $staffName;
}
}
}
// $newUniqueList 现在包含去重后的员工列表，并保持了办公室分组
/*
$newUniqueList 的示例输出：
array:4 [▼
"main office" => array:1 [▼
2 => "123 123"
]
"office 1" => array:2 [▼
3 => "staff_1"
6 => "staff_2"
]
"office 3" => array:1 [▼
4 => "staff_3"
]
"office 2" => array:1 [▼
5 => "staff_4"
]
]
*/请注意，上述代码的去重逻辑是：在遇到某个员工ID时，如果它尚未被添加，则将其添加到当前遍历到的第一个办公室分组下。后续即使在其他办公室分组中再次遇到该员工ID，也不会再次添加。 这样确保了每个员工只在Select2中出现一次，并且会显示在其第一次出现的办公室分组下。
集成到Yii2 Select2组件
获得去重后的$newUniqueList数组后，将其直接赋值给Select2组件的data属性即可。
use kartik\select2\Select2;
use yii\helpers\ArrayHelper;
use Yii;
// ... 前面处理 $allStaffsGroupOffice 得到 $newUniqueList ...
return $this->form->field($this->model, 'observers')
->widget(Select2::className(),
[
'data' => $newUniqueList, // 使用去重后的数据
'disabled' => !$this->can['changeObservers'],
'options' => [
'multiple' => true,
// 确保 'value' 属性也使用去重后的员工ID列表
'value' => ArrayHelper::map($this->model->observers, 'staff_id', 'staff_id'),
'placeholder' => Yii::t('tasks_forms', 'FORM_PLACEHOLDER_CHOOSE'),
'class' => 'hiddenInput'
],
'pluginOptions' => [
'allowClear' => true,
'closeOnSelect'=> false,
],
'pluginLoading' => false,
]);通过这种方式，Select2组件在渲染时将接收到一个已经去重且按办公室分组的数据源，从而避免了同一员工多次显示的问题。
注意事项与最佳实践
- 数据源的源头优化：如果可能，最理想的情况是在数据库查询或Tasks::getAllStaffsGroupOffice()方法内部就进行去重处理，这样可以减少PHP层面的额外计算。然而，如果业务逻辑要求原始数据必须包含重复项（例如用于其他目的），那么上述PHP预处理方法是有效的。
- 性能考量：对于非常庞大的员工列表（例如数万甚至数十万），in_array()的性能可能不是最优的。在这种情况下，可以考虑使用哈希表（关联数组）来记录已处理的ID，例如$repeatedStaff = [];改为$repeatedStaff = array_flip($repeatedStaff);，然后使用isset($repeatedStaff[$staffId])进行判断，其时间复杂度为O(1)，优于in_array()的O(n)。
- 去重策略：本教程的去重策略是保留员工在第一次出现的办公室分组下。如果业务需求是希望员工在所有相关的办公室分组下都显示，但只显示一次（这与Select2的分组逻辑冲突，Select2会根据分组显示），或者希望将所有员工扁平化显示（不分组），则需要调整去重逻辑。例如，如果不需要分组，可以直接生成一个$staffId => $staffName的扁平唯一列表。
总结
通过在Yii2 Select2组件接收数据之前，对包含重复项的分组数据源进行有效的预处理，我们可以轻松解决多选框中同一选项重复显示的问题。这种方法不仅保证了数据展示的准确性和唯一性，也显著提升了用户体验。在实际应用中，应根据具体的数据量和性能要求，选择最合适的去重策略和实现方式。
