JeecgBoot中JSelectUserByDept组件处理已冻结用户的解决方案

问题背景

在JeecgBoot-Vue3 3.6.3版本中，使用部门选择用户组件(JSelectUserByDept)时，会遇到一个常见的业务场景：当已选中的用户被停用(删除)后，组件回显处理不够完善。具体表现为：

1. 组件默认会回显用户的ID而不是名称
2. 被停用用户仍然显示在选择列表中
3. 业务需求希望显示表中存储的用户名称而非ID
4. 再次选择时应自动过滤掉已被停用的用户

技术分析

JSelectUserByDept组件是JeecgBoot框架中一个常用的用户选择器，它基于部门树形结构来筛选用户。在默认实现中，该组件主要关注于用户选择功能，但对于用户状态变化的处理不够细致。

当用户被停用(删除)后，系统通常会将用户标记为非活跃状态，但组件默认实现不会自动感知这种状态变化。这导致了两个主要问题：

1. 回显问题：组件默认使用用户ID进行回显，而不是更友好的用户名
2. 过滤问题：被停用用户仍然出现在可选列表中

解决方案

1. 自定义回显逻辑

要实现使用用户名而非ID回显，可以修改组件的value显示逻辑。JeecgBoot的表中通常同时存储了用户ID和用户名，我们可以利用这些已有数据：

// 在父组件中自定义回显逻辑
const selectedUsers = ref([]);

// 从接口获取数据时，使用name而非id
onMounted(() => {
  api.getUserList().then(res => {
    selectedUsers.value = res.result.map(item => ({
      value: item.id,
      label: item.name,
      disabled: item.status === '0' // 0表示停用状态
    }));
  });
});

2. 过滤停用用户

在JSelectUserByDept组件的选中回调中，需要添加对停用用户的过滤逻辑：

// 修改JSelectUserByDept组件的handleSelectUser方法
const handleSelectUser = (users) => {
  // 过滤掉停用用户
  const validUsers = users.filter(user => user.status !== '0');
  
  // 触发回调
  emit('update:value', validUsers.map(user => user.id));
  emit('change', validUsers.map(user => user.id), validUsers);
};

3. 完整实现方案

对于更完整的解决方案，建议按照以下步骤实现：

1. 数据准备阶段：

   • 从接口获取用户列表时，同时获取用户状态信息
   • 将停用用户标记为disabled

2. 组件回显阶段：

   • 使用表中存储的用户名进行回显
   • 对于停用用户，显示特殊标记(如灰色文字)

3. 用户选择阶段：

   • 在选择器中自动过滤掉停用用户
   • 或者在UI上明确区分活跃用户和停用用户

4. 数据提交阶段：

   • 确保只提交活跃用户的数据
   • 可以添加校验逻辑防止提交包含停用用户的数据

最佳实践建议

1. 状态管理：建议在全局状态中维护用户状态信息，确保组件能实时感知用户状态变化

2. UI反馈：对于停用用户，除了过滤外，也可以考虑在UI上给予明显提示，帮助用户理解为什么某些用户不可选

3. 性能考虑：如果用户数据量很大，建议在后端进行过滤，减少前端数据处理压力

4. 兼容性处理：对于历史数据中可能存在的已停用用户，建议添加兼容处理逻辑

通过以上方案，可以很好地解决JSelectUserByDept组件在处理已停用用户时的各种问题，提升用户体验和系统健壮性。