JeecgBoot高级查询中部门选择组件配置单选的实现方法

背景介绍

在JeecgBoot 3.7.1版本中，开发者在使用高级查询功能时，经常会需要添加部门选择组件。默认情况下，部门选择组件(departId)支持多选操作，但在某些业务场景下，我们可能需要限制用户只能选择单个部门。

问题分析

通过查看源码和社区反馈，我们发现直接在superQuerySchema配置中添加multiple: false属性并不能生效。这是因为JeecgBoot的部门选择组件有其特定的配置方式，需要采用不同的参数来控制多选行为。

解决方案

正确的配置方法是在fieldExtendJson属性中设置multiSelect参数。具体配置示例如下：

export const superQueryConfig = {
  userId: { 
    title: '用户ID', 
    order: 1, 
    view: 'list', 
    type: 'string', 
    dictTable: 'sys_user', 
    dictCode: 'id', 
    dictText: 'realname' 
  },
  roleId: { 
    title: '角色ID', 
    order: 2, 
    view: 'list', 
    type: 'string', 
    dictTable: 'sys_role', 
    dictCode: 'id', 
    dictText: 'role_name' 
  },
  departId: { 
    title: '部门ID', 
    order: 3, 
    view: 'sel_depart', 
    type: 'string', 
    fieldExtendJson: '{"multiSelect":false}' 
  },
};

实现原理

JeecgBoot的部门选择组件实际上是一个独立的Vue组件，它通过解析fieldExtendJson中的JSON配置来控制组件的行为。当设置multiSelect为false时，组件内部会禁用多选功能，确保用户只能选择单个部门。

注意事项

1. fieldExtendJson必须是一个有效的JSON字符串
2. 参数名是multiSelect而不是multiple
3. 布尔值需要使用小写形式(false/true)
4. 整个JSON字符串需要用单引号包裹

扩展应用

这种配置方式不仅适用于部门选择组件，JeecgBoot中的其他组件也可以通过fieldExtendJson来传递额外的配置参数。开发者可以查阅相关组件的文档，了解更多的可配置项。

通过以上方法，开发者可以灵活地控制部门选择组件的多选行为，满足不同业务场景的需求。