TUI

Select 下拉选择框
基础下拉选择框组件,支持单选、禁用、自定义内容等。
基础用法
默认 type 值为 text,支持 v-model 双向绑定。
北京
示例代码
vue
一键清空
使用 clearable 属性即可得到一个可一键清空的选择器
北京
示例代码
vue
禁用状态
通过disabled 属性控制组件是否可用。或者optionItem 的 disabled 属性。
广州
请选择城市
示例代码
vue
多选选项
通过multiple 实现多选功能
北京
上海
示例代码
vue
筛选选项
通过 filterable 来快速筛选label、value 的匹配项。
广州
示例代码
vue
错误状态
通过 error 和 展示错误提示。
请选择城市
示例代码
vue
不同尺寸
通过 size 属性可设置下拉框尺寸,支持 smallmediumlargex-large 四种预设值。 若不传入则默认使用 medium 尺寸。
小尺寸
默认尺寸
大尺寸
超大尺寸
示例代码
vue
自定义字段名
通过field-names 属性可以自定义选项的字段名,以适配不同的数据格式。
请选择城市
示例代码
vue
属性 Props
属性名
说明
类型
可选值
默认值
版本说明
v-model
绑定值
string | number
options
下拉数据列表
Array<SelectOptionItem>
[]
fieldNames
自定义字段名映射,用于适配不同的数据结构
SelectFieldNames
{ label: 'label', value: 'value', disabled: 'disabled'}
added 0.5.5
multiple
是否多选
boolean
false
filterable
是否筛选
boolean
false
disabled
是否禁用
boolean
true / false
false
placeholder
占位符提示文本
string
changed 0.3.6 变更为空字符串
required
是否必填
boolean
true / false
false
clearable
是否一键清除
boolean
false
error
是否显示错误状态
boolean
true / false
false
errorText
错误提示信息内容
string
deprecated 0.5.0
errorFixed
错误提示是否固定占位
boolean
false
deprecated 0.5.0
scrollIntoView
是否滚动到选中项
boolean
true / false
false
centerSelectedOnOpen
打开时选中项是否居中
boolean
true / false
true
directionFollow
下拉框是否跟随滚动调整方向
boolean
true / false
true
dropBorder
是否显示下拉框边框
boolean
true / false
true
事件 Events
事件名
说明
回调参数
版本说明
change
值变化时触发
(value: string | number | boolean | null | undefined)=> void
clear
清空值时触发
(value: null)=> void
插槽 Slots
插槽名
说明
版本说明
suffix-icon
下拉图标插槽
FieldNames Type
属性名
说明
类型
可选值
默认值
版本说明
label
指定选项标签为选项对象的某个属性值
string
label
added 0.5.5
value
指定选项的值为选项对象的某个属性值
string
value
added 0.5.5
disabled
指定选项的禁用状态为选项对象的某个属性值
string
disabled
added 0.5.5
SelectOptionItem Type
属性名
说明
类型
可选值
默认值
版本说明
label
选项展示文本
string
value
选项绑定值
string | number | boolean
disabled
该选项是否禁用
boolean
true / false
false
基础用法
一键清空
禁用状态
多选选项
筛选选项
错误状态
不同尺寸
自定义字段名
属性 Props
事件 Events
插槽 Slots
FieldNames Type
SelectOptionItem Type