Segmented 分段控制器

展示多个选项并允许用户从中选择单个选项。

基础用法

通过设置 v-model 来指定被选中的选项值。

排列方向 2.8.7

设置 vertical 属性来改变排列方向。



禁用状态

设置分段控制器或选项的 disabledtrue 以禁用。

自定义选项别名 2.9.8

当你的 options 格式与默认格式不同时,你可以通过 props 属性自定义 options 的别名。

适应父容器

设置 block 属性为 true 来撑满父元素的宽度。

自定义内容

设置默认插槽来渲染自定义内容。

自定义样式

使用 CSS 变量设置自定义样式。

API

属性

名称描述类型默认值
model-value / v-model绑定值string / number / boolean
options选项的数据array[]
props 2.9.8配置选项,请参见下表object
size组件的大小枚举''
block撑满父元素的宽度booleanfalse
disabled分段控制器是否禁用booleanfalse
validate-event是否触发表单验证booleantrue
名称原生的 name 属性string
id原生 id 属性string
aria-label 无障碍原生 aria-label 属性string
排列方向 2.8.7显示方向枚举horizontal

props

属性描述类型默认值
value指定节点对象的哪个键用作节点的值stringvalue
label指定节点对象的哪个键用作节点的标签stringlabel
disabled指定节点对象的哪个键用作节点的禁用stringdisabled

事件

名称描述类型
change当选中值发生变化时触发,参数为当前选中的值Function

插槽

名称描述类型
default选项渲染器object

类型声明

显示声明
ts
type Option = Record<string, any> | string | number | boolean

来源

组件样式文档

贡献者