# SegmentedControl 分段控制器
在几个互斥的选项中选择一个,适合切换视图、时间粒度这类立即生效的选择。
## 基础用法
选项可以直接写成字符串或数字,此时它既是值也是标签:
## 撑满宽度
`block` 让控件撑满父元素,各选项平分宽度。
## 自定义选项
`option` 插槽替换每个选项的内容,例如加上图标。插槽参数为 `{ option, checked }`。
## 尺寸与禁用
## 键盘与读屏
每个选项都是一个原生单选框,共享同一个 `name`:`Tab` 进入时聚焦当前选项,方向键在选项之间移动并立即选中,与单选框组完全一致。外层带有 `role="radiogroup"`;放在 [表单项](./form) 中时,由表单项的标签通过 `aria-labelledby` 命名。
## API
### Props
| 名称 | 说明 | 类型 | 默认值 |
| ------------ | ----------------------------------------------------------------------- | ------------------------------------------------ | ------- |
| `modelValue` | 选中值,配合 `v-model` | `string \| number \| boolean` | — |
| `options` | 选项;字符串或数字同时作为值和标签 | `(SegmentedControlOption \| string \| number)[]` | — |
| `size` | 尺寸,默认取表单或全局配置 | `'sm' \| 'md' \| 'lg'` | `'md'` |
| `block` | 撑满宽度,选项平分 | `boolean` | `false` |
| `disabled` | 禁用全部 | `boolean` | `false` |
| `readonly` | 只读:值照常显示、可以聚焦,但不能修改;Form 设置 `readonly` 时自动只读 | `boolean` | `false` |
| `invalid` | 标记为校验失败,边框显示危险色;在 FormItem 中校验失败时自动带上 | `boolean` | `false` |
| `name` | 原生 `name`,不传时自动生成 | `string` | — |
`SegmentedControlOption` 为 `{ value: string | number | boolean; label?: string; disabled?: boolean }`。
### Events
| 名称 | 说明 | 参数 |
| ------------------- | ---------------- | -------------------------------------- |
| `update:modelValue` | 值变化 | `(value: string \| number \| boolean)` |
| `change` | 用户选了另一个项 | `(value: string \| number \| boolean)` |
### Slots
| 名称 | 说明 |
| -------- | -------------------------------------- |
| `option` | 选项内容,参数为 `{ option, checked }` |
### CSS 变量
| 变量 | 说明 |
| -------------------------------------- | ------------------ |
| `--dou-segmented-control-height` | 高度 |
| `--dou-segmented-control-padding-x` | 选项水平内边距 |
| `--dou-segmented-control-inset` | 轨道与选中块的间距 |
| `--dou-segmented-control-bg` | 轨道底色 |
| `--dou-segmented-control-indicator-bg` | 选中块底色 |