Select 选择器
当选项过多时,使用下拉菜单展示并选择内容。
基础用法
适用广泛的基础单选
有禁用选项
禁用状态
选择器不可用状态
可清空单选
包含清空按钮,可将选择器清空为初始状态
基础多选
适用性较广的基础多选,用 Tag 展示已选项
自定义模板
可以自定义备选项
分组
备选项进行分组展示
可搜索
可以利用搜索功能快速查找选项
远程搜索
从服务器搜索数据,输入关键字进行查找
Select Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
multiple | 是否多选 | boolean | — | false |
disabled | 是否禁用 | boolean | — | false |
clearable | 单选时是否可以清空选项 | boolean | — | false |
name | select input 的 name 属性 | string | — | — |
placeholder | 占位符 | string | — | 请选择 |
filterable | 是否可搜索 | boolean | — | false |
filterMethod | 自定义过滤方法 | function | — | — |
remote | 是否为远程搜索 | boolean | — | false |
remoteMethod | 远程搜索方法 | function | — | — |
loading | 是否正在从远程获取数据 | boolean | — | false |
Select Events
事件名称 | 说明 | 回调参数 |
---|---|---|
onChange | 选中值发生变化时触发 | 目前的选中值 |
onVisibleChange | 下拉框出现/隐藏时触发 | 出现则为 true,隐藏则为 false |
onRemoveTag | 多选模式下移除tag时触发 | 移除的tag值 |
onClear | 可清空的单选模式下用户点击清空按钮时触发 | - |
Option Group Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
label | 分组的组名 | string | — | — |
disabled | 是否将该分组下所有选项置为禁用 | boolean | — | false |
Option Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
value | 选项的值 | string/number/object | — | — |
label | 选项的标签,若不设置则默认与 value 相同 | string/number | — | — |
disabled | 是否禁用该选项 | boolean | — | false |