Segmented 分段控制器

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

基础用法

设置v-model为选项值。

基础用法:通过 size 设置尺寸
禁用状态
Block 分段选择器:设置block为true以适应父元素的宽度

配置方向

设置 vertical 来改变方向。


自定义样式

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

自定义内容

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

API

属性

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

事件

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

Slots

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

类型声明

Show declarations
ts
type Option =
  | {
      label: string
      value: string | number | boolean
      disabled?: boolean
      [key: string]: any
    }
  | string
  | number
  | boolean

Copyright 2025 Winning Health 版权所有