本文针对yii2框架中select2多选组件在处理多分组数据源时，同一员工在不同分组中重复显示的问题，提供了一种高效的数据预处理解决方案。通过遍历原始分组数据，并利用已访问id列表进行去重，确保每个员工在select2下拉列表中仅显示一次，从而提升用户体验和数据展示的准确性。
Yii2 Select2 多分组数据去重教程
在使用Yii2框架的Select2组件时，我们经常需要处理分组数据，例如按部门或办公室列出员工。然而，当某个员工同时属于多个分组时，Select2默认的渲染方式可能会导致该员工在下拉列表中重复出现，这不仅影响用户体验，也可能造成数据混淆。本教程将详细介绍如何通过数据预处理，确保Select2组件在显示多分组数据时，每个唯一的实体（如员工）只出现一次。
问题描述
假设我们有一个Select2多选组件，用于选择任务的观察者（observers）。其数据源 Tasks::getAllStaffsGroupOffice() 返回的是一个按办公室分组的员工列表，结构大致如下：
[
"main office" => [
2 => "123 123"
],
"office 1" => [
3 => "staff_1",
6 => "staff_2",
2 => "123 123" // 员工ID为2的"123 123"在此处再次出现
],
"office 3" => [
4 => "staff_3",
3 => "staff_1" // 员工ID为3的"staff_1"在此处再次出现
],
"office 2" => [
5 => "staff_4",
3 => "staff_1"
]
]可以看到，员工ID为2的"123 123"和员工ID为3的"staff_1"在多个办公室中都有出现。如果直接将此数据传递给Select2，它们将在下拉列表中显示多次，导致用户在选择时看到重复的选项。
原始的Select2配置可能如下：
return $this->form->field($this->model, 'observers')
->widget(Select2::className(),
[
'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,
]);解决方案：数据预处理
解决此问题的核心思想是在将数据传递给Select2组件之前，对其进行预处理，确保每个唯一的员工ID只出现一次。我们可以遍历原始的分组数据，并维护一个已添加员工ID的列表，以避免重复。
以下是实现数据去重的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"
]
];
// 用于存储已添加的员工ID，避免重复
$repeatedStaffIds = [];
// 用于存储处理后的唯一员工列表（保留分组结构）
$newUniqueList = [];
foreach ($allStaffsGroupOffice as $officeName => $staffList) {
foreach ($staffList as $staffId => $staffName) {
// 检查当前员工ID是否已在repeatedStaffIds中
if (!in_array($staffId, $repeatedStaffIds)) {
// 如果未添加，则将其ID加入已添加列表
$repeatedStaffIds[] = $staffId;
// 将员工添加到新的唯一列表中，并保留其所在办公室的分组
$newUniqueList[$officeName][$staffId] = $staffName;
}
}
}
// $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" => [] // 或者根据逻辑，如果一个办公室所有员工都被去重了，这个分组可能为空或被移除
]
*/
// 注意：上述示例中，如果一个办公室的所有员工都在之前的办公室中被去重，该办公室下的员工列表将为空。
// 如果希望每个办公室至少显示一个员工（即使该员工在其他办公室已出现），则需要调整去重逻辑。
// 但本教程的目标是确保“每个员工只显示一次”，因此当前逻辑是正确的。
// 如果需要一个扁平化的唯一员工列表（不保留办公室分组），可以进一步处理 $newUniqueList：
$flatUniqueStaffs = [];
foreach ($newUniqueList as $officeName => $staffList) {
foreach ($staffList as $staffId => $staffName) {
$flatUniqueStaffs[$staffId] = $staffName;
}
}
// $flatUniqueStaffs 现在是 [2 => "123 123", 3 => "staff_1", 6 => "staff_2", 4 => "staff_3", 5 => "staff_4"]
// Select2可以直接使用这种扁平结构，或者保留分组结构，但确保组内员工唯一。集成到Select2组件
将处理后的 $newUniqueList 或 $flatUniqueStaffs 数据传递给Select2组件的 data 属性。
方案一：保留分组结构，但组内员工唯一
如果希望Select2依然显示办公室分组，但每个员工在整个下拉列表中只出现一次，可以使用 $newUniqueList。
return $this->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,
]);方案二：扁平化列表，不显示分组
如果不需要在Select2中显示办公室分组，只希望有一个唯一的员工列表供选择，可以使用 $flatUniqueStaffs。
return $this->form->field($this->model, 'observers')
->widget(Select2::className(),
[
'data' => $flatUniqueStaffs, // 使用扁平化的唯一员工列表
'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,
]);注意事项与总结
- 去重逻辑的选择： 上述去重逻辑是基于“首次出现原则”。即，如果一个员工在“main office”和“office 1”都存在，他将只在“main office”分组中被添加到 $newUniqueList，而在“office 1”中则会被跳过。如果业务逻辑要求员工必须显示在其“主要”办公室，或者需要更复杂的去重规则，则需要相应调整 foreach 循环内的判断逻辑。
- 数据源效率： 这种预处理方式是在服务器端进行的，确保了发送到前端的数据已经是去重后的。对于大型数据集，应考虑在数据库查询层面就进行去重优化，减少PHP层面的处理负担。
- 用户体验： 确保Select2下拉列表中每个选项的唯一性，极大地提升了用户的选择效率和界面的清晰度。用户不再需要困惑于为何同一个名字出现多次。
通过以上数据预处理方法，我们可以有效地解决Yii2 Select2组件在处理多分组数据时重复显示选项的问题，从而提供一个更专业、更友好的用户界面。
