级联选择

说明

说明项	内容
控件类	控件类
是否可排序	是
是否支持过滤	是
支持过滤器类型	单选：包含、不包含、等于、不等于、等于空、不等于空、在列表中、不在列表中

设置项

设置项	说明
允许不填写	设置该字段是否必填
多选	开启后该级联选择将支持多选，多选后会更改字段的存储类型
允许选择任意一级	开启后支持选择到中间节点
未填写时在表单中的占位符	在该字段未输入信息时展示在输入框内的文字信息
使用选项字典获取选项值	是否使用应用设置中的数据字典作为选项
选项字典分类	使用应用设置中的数据字典作为选项时，列表选择数据使用的数据字典分类
选项值类型	可使用系统预置的选项值 选项：默认、省、省市、省市区
选项值	可设置该字段的选项值，仅当选项值类型为默认时显示 支持操作：新增、从其它字段复制、添加子选项、删除选项
使用自动化设置待选列表	支持使用自动化对设置的选项值进行过滤
自动化输入参数	调用自动化待选值时，基于上下文传递给自动化的参数

注意事项

• 单选和多选的存储类型不同，在开启/关闭多选可能会丢失数据，需谨慎操作。转换规则可参考

• 添加选项值时会自动生成一个随机代码作为选项的ID，必须根据使用场景修改选项ID，以方便后续调用

• 使用自动化设置待选列表

  • 自动化返回值仅支持选项值的ID列表Array<String>
  • 自动化返回的ID列表，必须在选项值或数据字典的标识符范围内
  • 自动化返回的ID列表为null值时，将展示所有选项值

在数据库中的存储格式

选择类型	字段类型	说明
单选	text[]	数组
多选	jsonb	存储json数据结构

使用示例

基础使用

使用选项字典获取选项值

选项值字段配置可参考

选项值类型

系统内置了省、省市、省市区数据，可通过配置快速实现省市区的选择。

使用自动化设置待选列表

选项定义

层级	选项值	标识符
0	湖南省	1010
1	长沙市	1011
1	郴州市	1012
0	湖北省	1020
1	武汉市	1021
1	襄阳市	1022
0	广东省	2010
1	广州市	2011
1	深圳市	2012

返回仅有父级数据

不在范围内的数据将不展示；仅有父级数据，父级的子数据将不展示

${
    [
        "1010",
        "1011",
        "1012",
        "1020"
    ]
}

返回仅有子级数据

不在范围内的数据将不展示；仅返回子级数据，父级数据不会展示

${
    [
      "1011",
      "1012",
      "1021",
      "1022",
      "2011",
      "2012"
    ]
}