Jeecg-Boot高级查询中部门选择组件的多选配置详解

在Jeecg-Boot 3.7.1版本中，开发者在使用高级查询功能时，经常会遇到需要配置部门选择组件的需求。本文将深入探讨如何正确配置部门选择组件的多选功能，帮助开发者更好地理解和使用这一特性。

部门选择组件的基本配置

Jeecg-Boot的高级查询功能通过superQuerySchema对象来定义查询字段。对于部门选择组件，基础配置如下：

export const superQuerySchema = {
  departId: { 
    title: '部门ID', 
    order: 3, 
    view: 'sel_depart', 
    type: 'string' 
  }
};

这种配置会默认启用多选功能，用户可以在弹出的部门选择框中选择多个部门。

单部门选择的需求场景

在某些业务场景下，我们可能只需要用户选择一个部门，而不是多个。例如：

• 员工所属部门查询
• 部门领导查询
• 部门预算统计等

这些场景下，限制用户只能选择单个部门更为合理。

单部门选择的配置方法

要实现部门选择的单选框功能，不能简单地添加multiple: false属性。正确的做法是使用fieldExtendJson属性来传递额外的配置参数：

export const superQueryConfig = {
  departId: { 
    title: '部门ID', 
    order: 3, 
    view: 'sel_depart', 
    type: 'string', 
    fieldExtendJson: '{"multiSelect":false}' 
  }
};

配置解析

1. fieldExtendJson：这是一个JSON字符串格式的属性，用于传递组件特定的扩展配置
2. multiSelect：设置为false时，部门选择组件将变为单选模式
3. JSON格式：必须确保JSON字符串格式正确，包括引号和括号的匹配

实现原理

Jeecg-Boot的部门选择组件底层基于Ant Design的TreeSelect组件实现。当配置multiSelect:false时，组件内部会：

1. 禁用多选模式
2. 将选择器变为单选状态
3. 用户只能选择一个部门节点

最佳实践建议

1. 统一命名：建议将配置对象统一命名为superQueryConfig而非superQuerySchema，保持项目一致性
2. 注释说明：对于特殊配置，添加注释说明配置目的
3. 格式校验：使用JSON格式化工具确保fieldExtendJson的格式正确
4. 组件测试：配置后务必测试组件行为是否符合预期

常见问题排查

如果配置后仍然出现多选情况，可以检查：

1. JSON字符串格式是否正确
2. 属性名是否正确拼写（注意大小写）
3. 是否在正确的配置对象中添加了配置
4. 浏览器控制台是否有错误提示

通过以上配置和注意事项，开发者可以灵活控制Jeecg-Boot高级查询中部门选择组件的单选/多选行为，满足不同业务场景的需求。