Select 选择器
基础使用
设置属性 variant
,修改选择器风格。有 underlined
、outlined
、filled
三种风格,默认情况下为 underlined
。设置属性 label
表示选择器相关信息。设置 value
属性,或绑定 v-model:value
来表示所选值。
可清空
设置 clearable
属性,可开启一键清空内容功能。
禁用状态
设置 disabled
属性,选择器进入不可编辑状态。
加载状态
设置 loading
属性,选择器进入加载状态,表示正在执行一些操作。
多选
设置属性 multiple
属性即可启用多选。
纸片化
可以设置 chips
属性将选中项纸片化,进一步加强交互能力。如果开启了纸片化,还可以显示关闭按钮和选项折叠,需要分别设置 chips-closable
和 chips-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 /filled | underlined | No |
loading | 是否加载中 | Boolean | false | No |
clearable | 是否可以清空选项 | Boolean | false | No |
disabled | 是否禁用 | Boolean | false | No |
multiple | 是否多选 | Boolean | false | No |
labelKey | 选项的标签 | String | label | No |
valueKey | 选项的值 | String | value | No |
object | 以选项对象作为值 | Boolean | false | No |
filterable | 是否开启筛选功能 | Boolean | false | No |
filter-query | 筛选文本 | String | - | No |
chips | 选中项为纸片样式 | Boolean | false | No |
chips-closable | 选中项是否可关闭(chips 下有效) | Boolean | false | No |
chips-collapse ✖ | 多个选中是否进行折叠(chips 下有效) | Boolean | false | No |
prefix-icon | 前缀图标 | String | - | No |
prefix-outer-icon | 外部前缀图标 | String | - | No |
suffix-icon | 后缀图标 | String | - | No |
suffix-outer-icon | 外部后缀图标 | String | - | No |
error-message | 错误提示信息 | String | - | No |