Skip to content

高级选择

image

介绍

高级选择组件适用于大数据量,不能一次性加载所有的数据,需要根据查询条件动态搜索数据进行选择的组件。

API

Props

参数说明类型默认值
默认状态支持变量绑定默认 / 禁用 / 隐藏 / 只读默认
显示标题是否显示左侧标题booleanture
标题支持变量绑定string高级选择
选项数据支持变量绑定Record<string, any>[]
指定字段名选项数据中 key 和 title 对应的取值字段FieldNames
当前选中项对应的值默认选中值(支持变量绑定)FieldNames[][]
选择器标题支持变量绑定string请选择
选项类型组件是否支持树形配置默认 / 树形默认
节点异步加载函数异步加载函数,可自定义返回 promise 对象(ctx, params:currentOption) => Promise
选择模式支持变量绑定单选 / 多选单选
支持全选多选模式下boolean
最小选择数量多选模式下(支持变量绑定)number
最大选择数量多选模式下(支持变量绑定)number
自定义选项内容jsx 渲染函数,可自定义选项渲染内容(ctx, params: FieldNames) => jsx
描述文字多选模式下,选择器底部描述(支持变量绑定)string
唯一标识表单字段名string"DYMAMICSELECT_随机八位字符"
气泡提醒表单项气泡提醒string
自定义输入框jsx 渲染函数(ctx, params) => jsx
必填未输入内容时校验不通过booleanfalse
自定义函数自定义校验函数booleanfalse

events

事件名说明回调参数
onClick组件点击时ctx, params: {value: FieldNames[]}
onChange选择值变化时ctx, params: {value: FieldNames[]}
onClickOption点击选项时触发ctx, params: Record<string, any>
onSearch搜索时触发ctx, params: string
onConfirm选择器点击完成按钮时触发ctx, params: FieldNames[]
onClickLeftIcon点击左侧图标时ctx, params:{value: FieldNames[]}
onClickRightIcon点击右侧图标时ctx, params:{value: FieldNames[]}

Type

FieldNames

参数说明类型默认值
key指定 key 值在选项数据中对应的字段名stringkey
title指定 title 在选项数据中对应的字段名stringvalue
...指定其他字段名,可根据需要自行定义,组件存取值会根据该对象配置进行扩展string-