Select 选择器
对多项内容进行选择。
基础使用
使用 v-model 绑定当前选中项,提供 options 数据渲染选项。
WARNING
注意:options 必须为 array,且元素必须为 object,且每个 object 中必须包含 label、value 这两个 key。
禁用状态
使用 disabled 属性,使 Select 进入禁用状态。
可清空的
使用 clearable 属性,是 Select 可清除,鼠标移入 Select 可查看效果。
可多选的
使用 multiple 属性,使 Select 可多选;同时,还可以使用 max 属性,设置最多选中数。
基础多选
设置最多选中数: 2
指定 key
使用 options-key 属性,指定渲染的 options 的 key 值。
TIP
在某些场景下,您可以需要使用类似 id 的 key 渲染 options,使得 options 数据可以被随意的操作。
在默认情况下,我们会使用 index 索引作为 key 进行渲染。
WARNING
注意:您所指定的 key 必须是 options 元素中存在的 key,否则无法正确设置。
此示例使用了 id 作为 key, 它目前是:
APIs
属性
| 属性名 | 说明 | 类型 | 默认值 | 是必需项 |
|---|---|---|---|---|
v-model | 当前激活的选择 | SelectOption['value'] | —— | true |
| options | 选择列表 | T extends SelectOption[] | —— | true |
| disabled | 禁用选择器 | boolean | false | false |
| clearable | 可清空的 | boolean | false | false |
| multiple | 可多选 | boolean | false | false |
| max | 最大可选中数(仅 multiple 可用) | number | Infinity | false |
| options-key | 为渲染的 options 指定 key | string | —— | false |