---
url: /components/segmented.md
---
# Segmented 分段控制

分段选择器：互斥选项的轻量切换控件，常用于视图切换（列表/卡片）、时间范围（今日/本周/本月）。滑块带位移过渡动画；支持 v-model 受控与无 v-model 的非受控使用。

## 基础用法

## 尺寸与圆角

## 对象选项与禁用项

options 支持 `{ label, value, disabled, icon }` 对象形态：

## 块级铺满

## Segmented API

| 名称 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| modelValue | String / Number | — | 选中值（v-model）；不传时组件内部维护选中态 |
| options | Array | `[]` | 纯值数组或 `{ label, value, disabled, icon }` |
| size | String | `middle` | large / middle / small |
| shape | String | `default` | default / round |
| block | Boolean | `false` | 铺满父容器宽度 |
| vertical | Boolean | `false` | 垂直排布 |
| disabled | Boolean | `false` | 整体禁用 |

事件：`change(value)`。