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