# Select 选择器

基础用法
显示代码
带有禁用选项
显示代码
禁用状态 & 只读状态
显示代码
多选
显示代码
多选限制选择数目上限
广州 北京
显示代码
清空选择
显示代码
尺寸
显示代码
自定义模板
显示代码
分组
显示代码
可搜索
搜索功能需要传入选项的label属性。
显示代码
自定义字段名
显示代码
Select Attributes
参数 说明 类型 可选值 默认值
value / v-model 绑定值 String Number - -
placeholder 占位符 String - 请选择
options 下拉选项([{ label, value }]) Array - []
size 尺寸 String medium small mini -
disabled 是否禁用 Boolean - false
readonly 是否只读 Boolean - false
clearable 是否可清空 Boolean - false
multiple 是否多选 Boolean - false
multiple-limit 多选时用户最多可以选择的项目数,为 0 则不限制 Number - 0
options-class-name 选项列表的 className String - -
options-width 选项宽度,不传默认跟随输入框 String - -
search 搜索功能 Boolean - false
search-placeholder 搜索输入框的占位文本 String - 搜索关键词
search-input-options 搜索输入框额外参数 Object - -
options-field 传入 options 时的自定义字段 Object - { label: 'label', value: 'value', disabled: 'disabled' }
option-height 选项高度 String - -
option-max-height 选项面板最大高度 String - -
option-align 选项字体对齐,即 text-align String - -
Select Events
事件名称 说明 回调参数
change 选中值发生变化时触发 当前选中值
visibleChange 下拉框出现/隐藏时触发 出现则为 true,隐藏则为 false
Option Attributes
参数 说明 类型 可选值 默认值
value 选项的值 String Number - -
label 选项的文案,不设置则默认为value String Number - -
disabled 是否禁用该选项 Boolean - false