本文旨在解决在使用 Yii2 的 Select2 组件时，当同一人员属于多个部门时，在下拉列表中重复显示的问题。通过对数据进行预处理，生成包含唯一人员信息的数据源，从而避免重复显示，提升用户体验。本文提供详细的代码示例，帮助开发者快速实现该功能。
在使用 Yii2 框架的 Select2 组件时，有时会遇到这样的情况：同一个用户可能属于多个部门，导致在下拉选择框中该用户的信息重复出现，影响用户体验。本文将提供一种解决方案，通过在将数据传递给 Select2 组件之前，对数据进行预处理，确保每个用户只出现一次。
问题分析
问题的根源在于 Tasks::getAllStaffsGroupOffice() 方法返回的数据结构。该方法返回一个以部门为键，部门内人员为值的嵌套数组。如果同一个人同时属于多个部门，那么这个人的信息就会在多个部门的数组中重复出现。
解决方案
解决思路是：在将数据传递给 Select2 组件之前，对数据进行处理，生成一个包含所有人员信息，且每个人员信息只出现一次的数组。
代码示例
以下是一个 PHP 代码示例，展示了如何将原始数据转换为包含唯一人员信息的数组：
[
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 = [];
$newUniqueList = [];
foreach ($allStaffsGroupOffice as $office => $staffList) {
foreach ($staffList as $staffId => $staffName) {
if (!in_array($staffId, $repeatedStaff)) {
$repeatedStaff[] = $staffId;
$newUniqueList[$staffId] = $staffName; // 修改此处，不再按部门分组
}
}
}
// $newUniqueList 现在包含唯一的人员信息，可以传递给 Select2 组件
// 打印结果用于调试
print_r($newUniqueList);
?>代码解释
- $allStaffsGroupOffice: 这是原始数据，包含了按部门分组的人员信息。
- $repeatedStaff: 这是一个数组，用于记录已经出现过的人员 ID，防止重复添加。
- $newUniqueList: 这是最终生成的新数组，包含了所有人员的信息，且每个人员只出现一次。
- foreach 循环: 代码使用两个嵌套的 foreach 循环遍历原始数据。
- in_array() 函数: 在内层循环中，in_array() 函数用于检查当前人员的 ID 是否已经存在于 $repeatedStaff 数组中。
- $repeatedStaff[] = $staffId: 如果当前人员的 ID 不存在于 $repeatedStaff 数组中，说明该人员是第一次出现，将其添加到 $repeatedStaff 数组中。
- $newUniqueList[$staffId] = $staffName: 将当前人员的信息添加到 $newUniqueList 数组中。 关键点在于此处直接使用 $staffId 作为键，不再按照部门进行分组。
修改 Select2 组件的配置
在获得了包含唯一人员信息的 $newUniqueList 数组后，需要修改 Select2 组件的配置，将 data 属性设置为 $newUniqueList。
form->field($this->model, 'observers')->widget(Select2::className(),
[
'data' => $newUniqueList, // 使用处理后的数据
'disabled' => !$this->can['changeObservers'],
'options' => [
'multiple' => true,
'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,
]);
?>注意事项
- 确保 $newUniqueList 数组的键值对符合 Select2 组件的要求。通常情况下，键应该是人员的 ID，值应该是人员的名称。
- 如果需要显示部门信息，可以在 $newUniqueList 数组的值中包含部门信息，例如：$newUniqueList[$staffId] = $staffName . ' (' . $office . ')'。
- 根据实际情况调整代码，例如，如果人员 ID 不是整数，需要修改 $repeatedStaff 数组的比较方式。
总结
通过对数据进行预处理，可以有效地解决 Yii2 Select2 组件中同一人员在多个部门重复显示的问题。这种方法不仅可以提高用户体验，还可以避免数据冗余，提高应用程序的性能。 在实际应用中，可以根据具体需求对代码进行调整，例如，可以添加缓存机制，避免每次都重新生成 $newUniqueList 数组。
