Segmented 分段控制器

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

基础用法

设置v-model为选项值。

配置方向2.8.7

设置 vertical 来改变方向。



禁用状态

设置 disabled 属性来禁用一些选项。

自定义选项 2.9.8

当您的 options 格式不同于默认格式时,可通过 props 属性自定义 options

Block 分段选择器

设置blocktrue以适应父元素的宽度。

自定义内容

设置 default slot 位来渲染自定义内容。

自定义样式

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

API

属性

名称说明类型默认值
model-value / v-model绑定值string / number / boolean
options选项的数据array[]
props 2.9.8配置选项,详见下表object
size组件大小enum''
block撑满父元素宽度boolean
disabled是否禁用booleanfalse
validate-event是否触发表单验证booleantrue
name原生 name 属性string
id原生 id 属性string
aria-label a11y原生 aria-label 属性string
direction 2.8.7展示的方向enumhorizontal

自定义配置选项

属性说明类型默认值
value指定键为节点对象的某个属性值stringvalue
label指定标签为节点对象的某个属性值stringlabel
disabled指定禁用状态为节点对象的某个属性值stringdisabled

事件

名称说明类型
change当所选值更改时触发,参数是当前选中的值Function

Slots

名称说明类型
default自定义 Option 模板object

类型声明

Show declarations
ts
type Option = Record<string, any> | string | number | boolean

源代码

组件样式文档

贡献者