Skip to content

Select 选择器

基础使用

设置属性 variant,修改选择器风格。有 underlinedoutlinedfilled 三种风格,默认情况下为 underlined。设置属性 label 表示选择器相关信息。设置 value 属性,或绑定 v-model:value 来表示所选值。

可清空

设置 clearable 属性,可开启一键清空内容功能。

禁用状态

设置 disabled 属性,选择器进入不可编辑状态。

加载状态

设置 loading 属性,选择器进入加载状态,表示正在执行一些操作。

多选

设置属性 multiple 属性即可启用多选。

纸片化

可以设置 chips 属性将选中项纸片化,进一步加强交互能力。如果开启了纸片化,还可以显示关闭按钮和选项折叠,需要分别设置 chips-closablechips-collapse

WARNING

chips-collapse 待实现...

图标

支持在选择器前后内外 —— 四个方位设置图标,为以下四个属性:前缀图标 prefix-icon、外部前缀图标 prefix-outer-icon、后缀图标 suffix-icon、外部后缀图标 suffix-outer-icon

筛选

设置 filterable 属性开启筛选功能,此外你还需要绑定 filter-query 筛选文本,来同步当前输入的筛选文本。利用较大的灵活性去支持额外的业务功能,例如以下本地过滤和远程数据加载示例。

键值设置

在默认情况下,value 绑定的值是选项里 key 值,例如:option['key']。如果想绑定整个选项 option,那么需要设置 object 属性。当你需要获取 option['key'] 以外的值或者未加载选项列表就想显示 label 值的情况下(例如:数据首次回显),object 属性会相对有效。

TIP

绑定的值为 option[valueKey],默认为 option['key']。可以通过修改 valueKey 属性来改变。 绑定的标签为 option[labelKey],默认为 option['label']。可以通过修改 labelKey 属性来改变。

错误信息

在录入用户信息时,需要对信息进行校验并反馈用户,那么可以设置 error-message 属性,来存放信息,提醒用户。

Select API

属性

属性名说明类型默认值是否必填
value绑定值String/Number/Object/Array-No
options列表选项Array[]No
label标签String''No
placeholder占位文字String-No
variant样式类型underlined/outlined/filledunderlinedNo
loading是否加载中BooleanfalseNo
clearable是否可以清空选项BooleanfalseNo
disabled是否禁用BooleanfalseNo
multiple是否多选BooleanfalseNo
labelKey选项的标签StringlabelNo
valueKey选项的值StringvalueNo
object以选项对象作为值BooleanfalseNo
filterable是否开启筛选功能BooleanfalseNo
filter-query筛选文本String-No
chips选中项为纸片样式BooleanfalseNo
chips-closable选中项是否可关闭(chips下有效)BooleanfalseNo
chips-collapse ✖多个选中是否进行折叠(chips下有效)BooleanfalseNo
prefix-icon前缀图标String-No
prefix-outer-icon外部前缀图标String-No
suffix-icon后缀图标String-No
suffix-outer-icon外部后缀图标String-No
error-message错误提示信息String-No