# 列表选择器
# 使用场景
快速实现列表选择模块功能。 通常用于关联数据的相互绑定。
# 安装命令
npm run widgets list-picker
1
执行命令后,工具生成在项目的 ".my/widgets/list-picker"
路径下;
生成文件目录如下:
core.vue
(选择器组件)index.vue
(选择器+表单+弹窗组件)
# 基础用法
常规使用组件
# 自定义选项内容与查询条件
# 表格模式
# 结合表单
# 直接使用内部
使用选择器内部
# 属性参数
组件基于my-select-field组件和my-list组件封装,
# 表单弹窗参数
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
value | 用作v-model双向绑定 | array | — | [] |
fieldProps | my-select-field组件的参数 | object | - | - |
optionsPropsMap | 选项表单与选项列表的共同字段映射 | object | - | { label: 'name', id: 'id', value: 'id' } |
keepPickerState | 打开选择器时是否回填当前选择数据 | boolean | - | true |
# 表单弹窗参数
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
listLoad | Function | |||
optionsPropsMap | 选项的字段映射 | Object | - | { label: 'name', id: 'id', value: 'id' } |
selItemShowMax | 选中最多显示的数量 | Number | - | 5 |
isShowResult | 是否显示选中结果 | Boolean | - | true |
isShowSubmit | 是否显示提交按钮 | Boolean | - | true |
isMultiSel | 是否多选 | Boolean | - | true |
# 其他参数
支持 my-table 除 loader 外其他参数
# API method
# Picker (整体组件)方法
参数 | 说明 | 参数 | 输出 |
---|---|---|---|
openPicker | 打开弹窗(dialog)的函数 | - | - |
closePicker | 关闭弹窗(dialog)的函数 | - | - |
filterSubmitHandle | 查询表单的提交函数 | query 表单查询数据 | - |
# PickerCore (选择器组件) 方法
参数 | 说明 | 参数 | 输出 |
---|---|---|---|
removeItemSel | 删除选中的选项 | item选项数据 | - |
getSelectItems | 获取选中的选项 | - | 选中数据数组 |
setSelectItems | 设置选中的选项 | items 选项数据数组 | - |
clearSelectItems | 清空选中的选项 | - | - |
← 部门人员关联选择器 面板节点模板工具函数 →