Select 下拉选择框
规则
js
{
type: "select",
field: "cate_id",
title: "产品分类",
value: ["104","105"],
options: [
{"value": "104", "label": "生态蔬菜", "disabled": false},
{"value": "105", "label": "新鲜水果", "disabled": false},
],
props: {
multiple: true
},
}
value :Number | String | Array
Options
参数名 | 描述 | 类型 | 默认值 |
---|---|---|---|
value | 选项值 | OptionValue | - |
label | 选项内容 | string | - |
disabled | 是否禁用 | boolean | false |
tagProps | 选项对应的多选标签的属性 | any | - |
render | 自定义渲染 | RenderFunction | - |
Props
参数名 | 描述 | 类型 | 默认值 | 版本 |
---|---|---|---|---|
multiple | 是否开启多选模式(多选模式默认开启搜索) | boolean | false | |
size | 选择框的大小 | 'mini' | 'small' | 'medium' | 'large' | 'medium' | |
placeholder | 占位符 | string | - | |
loading | 是否为加载中状态 | boolean | false | |
disabled | 是否禁用 | boolean | false | |
error | 是否为错误状态 | boolean | false | |
allow-clear | 是否允许清空 | boolean | false | |
allow-search | 是否允许搜索 | boolean | { retainInputValue?: boolean } | `false (single) | true (multiple)` |
allow-create | 是否允许创建 | boolean | false | |
max-tag-count | 多选模式下,最多显示的标签数量。0 表示不限制 | number | 0 | |
popup-container | 弹出框的挂载容器 | string | HTMLElement | - | |
bordered | 是否显示输入框的边框 | boolean | true | |
popup-visible | 是否显示下拉菜单 | boolean | - | |
default-popup-visible | 弹出框默认是否可见(非受控模式) | boolean | false | |
unmount-on-close | 是否在下拉菜单关闭时销毁元素 | boolean | false | |
filter-option | 是否过滤选项 | boolean | ((inputValue: string, optionInfo: OptionInfo) => boolean) | true | |
options | 选项数据 | Option[] | [] | |
virtual-list-props | 传递虚拟列表属性,传入此参数以开启虚拟滚动 VirtualListProps | VirtualListProps | - | |
trigger-props | 下拉菜单的触发器属性 | TriggerProps | - | |
format-label | 格式化显示内容 | (data: OptionInfo) => string | - | |
fallback-option | 自定义值中不存在的选项 | boolean| ((value: string | number | Record<string, unknown>) => OptionData) | false | 2.10.0 | |
show-extra-options | 是否在下拉菜单中显示额外选项 | boolean | true | 2.10.0 |
value-key | 用于确定选项键值得属性名 | string | 'value' | 2.18.0 |
Events
事件名 | 描述 | 参数 |
---|---|---|
change | 值发生改变时触发 | - |
input-value-change | 输入框的值发生改变时触发 | - |
popup-visible-change | 下拉框的显示状态改变时触发 | - |
clear | 点击清除按钮时触发 | - |
remove | 点击标签的删除按钮时触发 | - |
search | 用户搜索时触发 | - |
dropdown-scroll | 下拉菜单发生滚动时触发 | - |
dropdown-reach-bottom | 下拉菜单滚动到底部时触发 | - |