Yii2 Select2 多办公室人员去重显示教程-php教程-PHP中文网

Yii2 Select2 多办公室人员去重显示教程

霞舞

发布： 2025-10-19 11:12:01

原创

258人浏览过

Yii2 Select2 多办公室人员去重显示教程

本教程旨在解决yii2 select2组件在处理多办公室人员数据时，因同一人员归属多个办公室而导致重复显示的问题。核心方案是通过预处理原始数据，确保在将数据传递给select2之前，每位工作人员只出现一次，从而优化用户体验并保持数据一致性。

问题剖析：Yii2 Select2中的重复数据挑战

在使用Yii2框架的Select2组件时，我们经常需要从复杂的数据源中填充下拉列表。一个常见场景是，当数据源将人员按办公室分组时，如果同一位工作人员隶属于多个办公室，那么在Select2的下拉列表中，该工作人员的姓名可能会重复出现多次。这不仅造成视觉上的混乱，也可能导致用户选择时的困惑。

例如，原始数据结构可能如下所示，其中ID为2和3的员工在不同办公室中重复出现：

$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组件：

echo $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,
        ]);

登录后复制

由于数据源中存在重复的员工ID，Select2会按照其在数据中出现的顺序，在每个对应的办公室分组下显示这些重复的员工，从而导致用户界面出现冗余。

解决方案核心：数据预处理实现唯一性

要解决Select2中人员重复显示的问题，关键在于在将数据传递给Select2组件之前，对数据进行预处理，确保每位工作人员的ID只出现一次。这意味着我们需要遍历原始的分组数据，并构建一个新的、去重后的数据结构。

我们的策略是：

维护一个已处理员工ID的列表。
遍历原始的办公室分组数据。
对于每个员工，检查其ID是否已在已处理列表中。
如果该员工ID尚未处理，则将其添加到新的数据结构中，并记录其ID为已处理。
如果已处理，则跳过，不再将其添加到新的数据结构中。

通过这种方式，即使原始数据中员工ID在不同办公室下重复，最终传递给Select2的数据也将保证每个员工ID的唯一性。

轻舟办公

基于AI的智能办公平台

194

查看详情

去重逻辑实现

以下是实现数据去重逻辑的PHP代码示例：

<?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"
    ]
];

// 用于记录已经处理过的员工ID，确保唯一性
$repeatedStaff = [];
// 存储去重后的新数据列表
$newUniqueList = [];

// 遍历原始的办公室分组数据
foreach ($allStaffsGroupOffice as $officeName => $staffList) {
    // 遍历当前办公室下的所有员工
    foreach ($staffList as $staffId => $staffName) {
        // 检查当前员工ID是否已经存在于 $repeatedStaff 列表中
        if (!in_array($staffId, $repeatedStaff)) {
            // 如果不存在，则将该员工ID添加到 $repeatedStaff，标记为已处理
            $repeatedStaff[] = $staffId;
            // 将该员工添加到新的 $newUniqueList 中，保留办公室分组
            // 注意：员工会归属于其首次出现的办公室
            $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"
  ]
]
*/

// 现在 $newUniqueList 可以安全地传递给 Select2 组件

登录后复制

在这段代码中，$repeatedStaff 数组充当了一个“黑名单”或“已访问”列表。每当我们遇到一个员工ID时，首先检查它是否已经在这个列表中。如果不在，说明这是我们第一次遇到这个员工，我们就将其添加到 $newUniqueList 中，并把它的ID加入到 $repeatedStaff。如果已经在列表中，说明我们之前已经处理过这个员工，就直接跳过，避免重复添加。

将去重数据应用于Select2

完成数据预处理后，只需将生成的 $newUniqueList 赋值给Select2组件的 data 属性即可。

<?php
use kartik\select2\Select2;
use yii\helpers\ArrayHelper;
use Yii; // 假设 Yii 框架的组件已可用

// ... (此处放置上文所示的数据预处理代码，生成 $newUniqueList) ...

echo $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组件将接收到一份经过处理的、确保员工ID唯一性的数据。最终，用户在下拉列表中将看到每个员工只出现一次，即使他们可能在后台数据中关联到多个办公室。

注意事项与最佳实践

数据处理位置： 建议将数据预处理逻辑封装在模型层（例如，在 Tasks 模型中添加一个方法 getUniqueStaffsGroupedByOffice()）或一个专门的数据提供者类中。这样可以保持控制器和视图层的简洁，提高代码的可维护性和复用性。
性能考量： 对于非常庞大的数据集（例如，成千上万的员工），in_array() 函数的性能可能会成为瓶颈，因为它需要线性遍历数组。在这种情况下，可以考虑使用关联数组（哈希表）来存储已处理的员工ID，以实现更快的 O(1) 平均时间复杂度查找。例如，将 $repeatedStaff 声明为 $repeatedStaff = [];，然后使用 if (!isset($repeatedStaff[$staffId])) { $repeatedStaff[$staffId] = true; ... }。
显示逻辑的灵活性： 本教程提供的去重方法，会将重复的员工归属于其首次出现在原始数据中的办公室。如果业务需求是：
- 扁平化列表： 不按办公室分组，只显示一个所有员工的唯一列表。
- 显示所有归属办公室： 员工只出现一次，但其名称旁边能提示其所属的所有办公室。需要根据具体需求调整去重逻辑和数据结构的构建方式。例如，对于扁平化列表，可以先将所有员工收集到一个数组，然后使用 array_unique() 或 array_flip() 结合 array_keys() 来去重。
用户体验： 确保去重后的数据显示逻辑符合用户的预期。如果用户习惯于看到员工在每个办公室下都列出，那么强制去重可能会改变他们的使用习惯。在实施前，应与产品经理或用户进行沟通。

总结

在Yii2中使用Select2组件处理复杂、分组且可能包含重复项的数据时，通过在数据渲染前进行预处理是解决显示重复问题的有效策略。通过精心设计的去重逻辑，我们可以确保Select2下拉列表的数据准确、唯一且用户友好。同时，考虑到性能和业务需求，选择合适的去重方法和数据处理位置，是构建健壮应用程序的关键。

以上就是Yii2 Select2 多办公室人员去重显示教程的详细内容，更多请关注php中文网其它相关文章！