Segmented 分段控制器

展示多个互斥选项,并允许用户选择其中一项。

基础用法

v-model 绑定到当前选中项的值。

纵向布局

设置 vertical 可改为纵向排列。



禁用

将分段控制器或某个选项的 disabled 设为 true 即可禁用。

自定义选项字段

options 数据字段名与默认不一致时,可通过 props 配置别名。

撑满宽度

block 设为 true 可使宽度跟随父级。

自定义内容

使用默认插槽自定义每一项的展示内容。

自定义样式

通过 CSS 变量覆盖样式。

分段控制器 API

分段控制器 属性

名称说明类型默认值
model-value / v-model绑定值string / number / boolean
options选项数据array[]
props字段映射配置,见下表object
size尺寸enum''
block是否宽度撑满父级booleanfalse
disabled是否禁用booleanfalse
validate-event是否触发表单校验booleantrue
name原生 namestring
id原生 idstring
aria-label a11y原生 aria-labelstring
direction排列方向enumhorizontal

props

属性说明类型默认值
value选项对象中作为取值的字段名stringvalue
label选项对象中作为展示文案的字段名stringlabel
disabled选项对象中表示禁用态的字段名stringdisabled

分段控制器 事件

事件名说明类型
change选中值变化时触发,参数为当前值Function

分段控制器 插槽

名称说明类型
default自定义选项渲染object

类型声明

展开类型声明
ts
type Option = Record<string, any> | string | number | boolean