高级选择
介绍
高级选择组件适用于大数据量,不能一次性加载所有的数据,需要根据查询条件动态搜索数据进行选择的组件。
API
Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
默认状态 | 支持变量绑定 | 默认 / 禁用 / 隐藏 / 只读 | 默认 |
显示标题 | 是否显示左侧标题 | boolean | ture |
标题 | 支持变量绑定 | 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 | |
必填 | 未输入内容时校验不通过 | boolean | false |
自定义函数 | 自定义校验函数 | boolean | false |
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 值在选项数据中对应的字段名 | string | key |
title | 指定 title 在选项数据中对应的字段名 | string | value |
... | 指定其他字段名,可根据需要自行定义,组件存取值会根据该对象配置进行扩展 | string | - |