RadioGroup
单选组,行为层是 Reka 的 RadioGroup:整组一个 Tab 位,方向键移动并选中。每项可带一句说明(description),经 aria-describedby 挂到那一项上,读屏念完名字接着念说明。整项包在 <label> 里,点名字、点说明都选中这一项。
选项少、要并排对比说明时用它;选项多用 Select,工具条里的图标互斥用 ToggleGroup,页签式的视图切换用 Segmented。
带说明
默认竖排——带说明时一项一行读起来顺。
导出排法
横排
orientation="horizontal",放不下时自动换行。
横排 / 整组禁用
API
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
options 必填 | RadioGroupOption<TValue>[] | — | — |
orientation | "vertical" | "horizontal" | undefined | "vertical" | 竖排(默认,带说明时读起来顺)/ 横排 |
label | string | undefined | undefined | 整组的读屏名 |
disabled | boolean | undefined | false | — |
size | "mini" | "small" | "medium" | "large" | "super" | undefined | undefined | 尺寸:mini / small / medium(默认) / large / super;不传则跟随环境 data-size |
modelValue | TValue | undefined | — | — |
Emits
| 事件 | 载荷 | 说明 |
|---|---|---|
update:modelValue | [value: TValue | undefined] | — |