Radio 单选框
从一组选项中选择一项。
基础用法
通过 RadioGroup.options 定义选项,使用 label、aria-label 或 aria-labelledby 为分组提供名称。选中边框使用主题色,按下时保持控件尺寸;选中圆点默认以 300ms 过渡显示。
basic.tsx
示例
受控选择
通过 value 控制选中的字符串,在 onChange 中读取 event.target.value。
当前选择:daily
controlled.tsx
纵向排列
设置 direction="vertical" 纵向排列选项。
vertical.tsx
卡片选项
设置 variant="card",展示包含图标和说明的选项。
surfaces.tsx
成组选项
使用 variant="list" 展示成组列表。extra 只放非交互状态,不放按钮或链接。
list.tsx
表单提交与重置
通过 name 提交选中项的 value,未选中或禁用的选项不提交。单独组合 Radio 时,同组使用相同的 name 和互不重复的值。
非受控选项组在表单重置时恢复 defaultValue;受控组需要同步重置应用状态。
API
Radio API
配置单个单选框的选中状态、提交值和禁用状态。
单个 Radio 支持原生 radio 属性。className 和 style 作用于标签容器。
RadioGroup API
管理一组选项的单选值和选项布局。
RadioOption
传入选项组的单个选项,包含提交值与显示内容。