@xwink/ui

RadioGroup

单选组,行为层是 Reka 的 RadioGroup:整组一个 Tab 位,方向键移动并选中。每项可带一句说明(description),经 aria-describedby 挂到那一项上,读屏念完名字接着念说明。整项包在 <label> 里,点名字、点说明都选中这一项。

选项少、要并排对比说明时用它;选项多用 Select,工具条里的图标互斥用 ToggleGroup,页签式的视图切换用 Segmented。

带说明

默认竖排——带说明时一项一行读起来顺。

导出排法

横排

orientation="horizontal",放不下时自动换行。

横排 / 整组禁用

API

Props

名称类型默认值说明
options 必填 RadioGroupOption<TValue>[]——
orientation"vertical" | "horizontal" | undefined"vertical"竖排(默认,带说明时读起来顺)/ 横排
labelstring | undefinedundefined整组的读屏名
disabledboolean | undefinedfalse—
size"mini" | "small" | "medium" | "large" | "super" | undefinedundefined尺寸:mini / small / medium(默认) / large / super;不传则跟随环境 data-size
modelValueTValue | undefined——

Emits

事件载荷说明
update:modelValue[value: TValue | undefined]—