Radio / RadioGroup

单选项用 Radio，成组用 RadioGroup（value / onChange 为 string）。不要把单独的 Radio 直接放进 Form.Item（会覆盖选项 value）。

文档站 Demo 跟随 Rspress 明暗主题（亮色用 admin，暗色自动切 dark）。

基础用法

<RadioGroup name="channel" defaultValue="web" onChange={console.log}>
  <Radio value="web">Web</Radio>
  <Radio value="app">App</Radio>
</RadioGroup>

实时演示

含受控组与 Form.Item asFieldset 校验。

与 Form 联用

<Form.Item name="channel" label="渠道" asFieldset required>
  <RadioGroup name="channel">
    <Radio value="web">Web</Radio>
    <Radio value="app">App</Radio>
  </RadioGroup>
</Form.Item>

asFieldset 将 label 渲染为 legend，适合单选组语义。

API

RadioGroupProps

属性	类型	默认值	说明
name	`string`	—	传给子 Radio
value	`string`	—	受控值
defaultValue	`string`	`""`	非受控初始
disabled	`boolean`	—	禁用整组
onChange	`(value: string) => void`	—	选中变化
onBlur	`FocusEventHandler<input>`	—	下传到子 Radio
children	`ReactNode`	—	仅识别直接子级 `Radio`
id / aria-*	—	—	挂在 radiogroup 容器
className	`string`	—	追加类名

RadioProps

属性	类型	说明
value	`string`	选项值
checked	`boolean`	通常由 RadioGroup 注入
name / id / disabled	—	原生属性
children	`ReactNode`	标签
onChange	`(value: string) => void`	选中时回调该 value

ON THIS PAGE

Radio / RadioGroup#

基础用法#

实时演示#

与 Form 联用#

API#

RadioGroupProps#