| modelValue/v-model | string/string[] | -- | ''/[] | 绑定值, 单选是字符串, 多选是字符串数组 |
| options | Item[] | -- | [] | 下拉列表选项数组, item 类型{id:string,name:string} |
| disabled | boolean | -- | false | 禁用整个组件 |
| caption | string | -- | '' | 前置标签 |
| clearable | boolean | -- | true | 是否可以清空 |
| filterable | boolean | -- | false | 是否支持搜索 |
| multiple | boolean | -- | false | 是否多选 |
| showSelectCount | boolean | true/false | false | 仅开启多选有效,是否仅仅显示选中数量,默认显示tag |
| placeholder | string | -- | '请选择' |
|
| maxTagCount(新规范已废弃) | number | -- | 1 | 最多显示多少个,默认显示一个, tag 剩余的显示+n ,0 表示全部展开 |
| trigger | string | click/hover | click | 触发方式 |
| popoverClass | string | -- | '' | 设置下拉框的class |
| rangeSeparator | string | -- | ' / ' | 选中结果连接符 |
| width | number/string | 数字/auto | 240 | 自定义选择框宽度(下拉看板每一层级的宽度为该宽度的一半、且最小宽为120px) |
| maxWidth | number | -- | 360 | 设置触发器中选中值部分的最大宽度, 此属性需配合 width='auto'来使用 |
| lastStage | boolean | -- | false | 设置lastStage属性为true,设置仅仅末级显示复选框 |
| checkStrictly | boolean | -- | false | 设置checkStrictly属性为true,可取消子父级联动,从而达到选择任意一级 |
| valueKey | string | -- | id | 属性自定义数据字段 |
| labelKey | string | -- | name | 属性自定义数据字段 |
| childrenKey | string | -- | children | 属性自定义数据字段 |
| multipleTagsMaxHeight(新规范已废弃) | number | -- | 0 | 多选tags最大高度,超出出现滚动条,默认高度自动撑开 |
| dropPanelSingleWidth | number | -- | 0 | 下拉看板每一层级的宽度,默认为width的一半,width=auto时为120px,hasConfirm=true时最小宽度为165px |
| placeholderStyle | object | -- | "{color: 'var(--gray-400)'}" | 自定义placeholder样式(目前仅支持自定义color) |
| teleportTo | string,object | -- | body | 下拉看板渲染到指定元素下 |
| simpleStyle | boolean | -- | false | 开启简易样式 |
| loadData | function | -- | -- | 懒加载(与filterable不可同时使用) |
| popoverAttrs | PopoverProps | {} | -- | popover组件的属性 属性参考 Popover props |
| hasConfirm | boolean | false/true | false | 多选添加取消、确认按钮 |
| loading | boolean | false/true | false | 数据为空时,是否显示loading动画 |
| autoClearSearch | boolean | -- | true | 失去焦点后自动清空筛选 |
| tipsTagHandleName | (name,index,items) => any | -- | undefined | 自定义 select 多选 tips 中的 tag 文案 |
| hasCheckAll | boolean | false/true | false | 多选添加全选 |