本文针对yii2 select2组件在处理多部门或多分组数据时，同一人员可能重复显示的问题，提供了一种高效的数据预处理方案。通过遍历原始数据并利用一个辅助数组记录已添加的人员id，我们可以在将数据传递给select2之前，生成一个确保人员唯一性的新列表，从而优化用户体验并避免视觉上的冗余信息。
引言：Yii2 Select2与多分组数据的挑战
Yii2框架中常用的Select2组件为多选下拉列表提供了强大的功能和良好的用户体验。然而，当数据源是按部门、办公室或其他分组组织时，一个实体（例如，一个员工）可能同时存在于多个分组中。如果直接将这种包含重复实体的数据传递给Select2，用户界面上就会出现同一个实体被多次显示的情况，这不仅造成视觉上的冗余，也可能导致用户混淆。本教程将深入探讨这一问题，并提供一个实用的解决方案，确保Select2组件只显示唯一的实体。
问题重现：Select2的默认行为与重复显示
考虑一个场景，我们需要为任务分配观察者，这些观察者来自不同的办公室。Tasks::getAllStaffsGroupOffice() 方法返回的数据结构如下：
// 原始数据结构示例
$allStaffsGroupOffice = [
"main office" => [
2 => "123 123"
],
"office 1" => [
3 => "staff_1",
6 => "staff_2",
2 => "123 123" // 员工ID 2 在 'main office' 和 'office 1' 中重复
],
"office 3" => [
4 => "staff_3",
3 => "staff_1" // 员工ID 3 在 'office 1' 和 'office 3' 中重复
],
"office 2" => [
5 => "staff_4",
3 => "staff_1" // 员工ID 3 在 'office 1', 'office 3' 和 'office 2' 中重复
]
];当我们将这样的数据直接传递给Yii2 Select2组件时：
use kartik\select2\Select2;
use yii\helpers\ArrayHelper;
// ... 在视图或表单中
echo $this->form->field($this->model, 'observers')
->widget(Select2::class,
[
'data' => Tasks::getAllStaffsGroupOffice(), // 直接使用原始数据
'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,
]);由于数据源中存在重复的员工ID（例如，员工ID 2和3），Select2的下拉列表中将为每个出现重复的办公室都显示一次该员工，导致用户看到多个相同的员工选项，从而影响选择的准确性和用户体验。
解决方案核心：数据预处理
解决这个问题的关键在于，在将数据传递给Select2组件之前，对原始数据进行预处理，确保最终传递给Select2的数据中，每个员工只出现一次。这意味着我们需要遍历所有分组，识别并跳过已经添加过的员工。
实现步骤与代码示例
我们将创建一个新的数组，用于存储去重后的员工列表。在遍历原始分组数据时，我们会使用一个辅助数组来记录已经处理过的员工ID。
[
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"
]
];
// 用于记录已添加员工ID的辅助数组
$repeatedStaffIds = [];
// 存储去重后的新列表
$newUniqueList = [];
// 遍历每个办公室及其员工列表
foreach ($allStaffsGroupOffice as $officeName => $staffList) {
// 为每个办公室创建一个子数组，用于存储该办公室下唯一的员工
$newUniqueList[$officeName] = [];
foreach ($staffList as $staffId => $staffName) {
// 检查当前员工ID是否已经添加到我们的去重列表中
if (!in_array($staffId, $repeatedStaffIds)) {
// 如果未添加，则将其添加到当前办公室的列表中
$newUniqueList[$officeName][$staffId] = $staffName;
// 同时，将该员工ID记录到已添加列表中，防止后续重复添加
$repeatedStaffIds[] = $staffId;
}
}
// 如果某个办公室在去重后没有员工，可以考虑移除该办公室的键，使数据更整洁
if (empty($newUniqueList[$officeName])) {
unset($newUniqueList[$officeName]);
}
}
// $newUniqueList 现在包含了去重后的员工列表，每个员工只出现一次
/*
结果示例：
$newUniqueList = [
"main office" => [
2 => "123 123"
],
"office 1" => [
3 => "staff_1",
6 => "staff_2"
],
"office 3" => [
4 => "staff_3"
],
"office 2" => [] // 如果办公室在去重后没有新员工，此办公室可能为空或被移除
];
*/
// 注意：上述代码中的 `if (empty($newUniqueList[$officeName])) { unset($newUniqueList[$officeName]); }`
// 会移除空的办公室分组。如果需要保留所有办公室分组，即使它们在去重后变空，则可以移除此行。
// 最终 Select2 渲染时，会自动处理空的或不包含有效选项的分组。
?>代码解释：
- $repeatedStaffIds = [];: 这个数组用于存储所有已添加到 $newUniqueList 中的员工ID。它的作用是作为“已见过”的标记。
- $newUniqueList = [];: 这是最终将传递给Select2组件的数据结构，它将包含去重后的员工列表，并保留了原始的分组结构（办公室）。
- 外层 foreach 循环：遍历原始数据中的每个办公室。
- 内层 foreach 循环：遍历当前办公室下的每个员工。
- if (!in_array($staffId, $repeatedStaffIds)): 这是核心的去重逻辑。它检查当前员工的ID是否已经在 $repeatedStaffIds 数组中。
- 如果不在，说明这个员工是第一次遇到，将其添加到 $newUniqueList 中当前办公室的列表下，并将其ID添加到 $repeatedStaffIds。
- 如果已在，说明这个员工已经在之前的某个办公室中被添加过，我们将跳过它，不再重复添加。
- if (empty($newUniqueList[$officeName])) { unset($newUniqueList[$officeName]); }: 这一步是可选的优化，用于移除那些在去重后不再包含任何员工的办公室分组，使最终的数据结构更精简。
集成到Yii2 Select2组件
现在，我们有了去重后的 $newUniqueList 数组，可以直接将其传递给Select2组件的 data 属性：
use kartik\select2\Select2;
use yii\helpers\ArrayHelper;
// 假设 $newUniqueList 已经通过上述代码生成
// ...
echo $this->form->field($this->model, 'observers')
->widget(Select2::class,
[
'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,
]);通过这种方式，Select2组件在渲染时将只会显示每个员工一次，无论他们在原始数据中属于多少个办公室。
总结与最佳实践
处理UI组件中的重复数据显示问题，核心思想在于“数据准备优于UI渲染”。在将数据绑定到任何前端组件之前，进行必要的后端数据预处理是确保数据一致性、优化用户体验和减少前端复杂性的最佳实践。
注意事项：
- 性能考量： 对于非常庞大的数据集，这种遍历和 in_array 操作可能会有性能开销。如果数据集特别大（例如数十万条记录），可以考虑使用哈希表（关联数组）而非 in_array 来检查重复，因为哈希查找通常比线性查找更快。例如，isset($repeatedStaffIds[$staffId]) 会比 in_array($staffId, $repeatedStaffIds) 更高效。
- 数据源修改： 如果可能，最理想的解决方案是在 Tasks::getAllStaffsGroupOffice() 方法内部就处理好去重逻辑，直接返回一个已经去重的数据集，这样可以避免在每个使用该数据的视图或控制器中重复编写去重代码。
- 用户体验： 确保去重后的数据显示逻辑符合用户的预期。例如，如果用户期望看到每个办公室下的员工列表，但又希望员工不重复，那么上述保留办公室分组的去重方案是合适的。如果只需要一个扁平的、完全去重的员工列表（不按办公室分组），则可以在去重时直接将所有员工添加到一个单一的数组中。
通过上述数据预处理方法，我们可以有效解决Yii2 Select2组件在处理多分组数据时出现的重复显示问题，为用户提供一个更清晰、更专业的选择界面。
