Skip to content

下拉选项 Select

基本的下拉选项

绑定对象值(需指定【value-key】属性)

禁用状态

可清空所选值

过滤选项

可开启远程搜索

多选

合并多选的值以便于节省空间

不同尺寸的下拉选项

API

Select Props

参数名说明类型可选值默认值
modelValue下拉框的值(通过 v-model 绑定)string / boolean / number / object / array必填
multiple是否开启多选booleanfalse
disabled是否禁用下拉框booleanfalse
valueKeymodelValue 的值为对象类型,该值为 modelValue 的唯一 keystring
clearable是否可清空所选值booleanfalse
collapseTags在多选状态下,选中多个值,合并为一个展示,可节省空间booleanfalse
multipleLimit多选状态下,限制选择的数量number-1
placeholderstring请选择内容
remotePlaceholderstring请输入关键字
filterable是否启用本地模糊搜索booleanfalse
remote是否启用远程搜索booleanfalse
loading下拉框的加载状态booleanfalse
loadingText加载时显示的文本string获取数据中
noMatchTextfilterable 状态下,没有匹配的数据时显示的文本string无匹配数据
noDataTextremote 或选项为空的状态下显示的文本string无数据
filterMethod自定义本地过滤的方法functionnull
remoteMethod自定义远程搜索的方法functionnull
size下拉框的尺寸stringsmall / medium / largemedium

Select Events

事件名说明回调参数
visible下拉框显示 / 隐藏时触发(isVisible: boolean)
change下拉选项的值发生变化时触发(value: string/boolean/number/object/array)

Select Slots

插槽名说明子标签
default默认插槽SelectOption

SelectOption Props

事件名说明类型可选值默认值
label显示的文本string
value绑定的值string / boolean / number / object必填
disabled是否禁用当前选项booleanfalse