RadioGroup 单选组

宿主分别保存发布方式和日志保留时长；每个分组只产生一个明确结果。

发布方式

手动发布每次由维护者确认后发布。定时发布在维护窗口按计划执行。自动发布仅建议用于可回滚的低风险变更。

当前发布方式：手动发布

日志保留时长

7 天30 天90 天

日志保留：30 天

每个互斥选项可以补充影响说明，并保留不可选项的原因。

手动发布由维护者确认后发布。定时发布在指定时间自动执行。持续部署当前环境尚未开放。

必填错误提示需要完成选择，整体禁用用于上游策略锁定。

团队私有

export interface BaseRadioGroupProps extends Omit< HTMLAttributes<HTMLDivElement>, 'children' | 'className' | 'defaultValue' | 'onChange' | 'style' > { options?: BaseRadioOption[]; value?: string; defaultValue?: string; name?: string; form?: string; orientation?: 'horizontal' | 'vertical'; required?: boolean; invalid?: boolean; disabled?: boolean; controlSize?: BaseControlSize; appearance?: BaseAppearance; className?: string; classNames?: BaseRadioGroupClassNames; style?: CSSProperties; children?: ReactNode; onChange?: ChangeEventHandler<HTMLInputElement>; onValueChange?: (value: string, event: ChangeEvent<HTMLInputElement>) => void; }

属性	说明	类型	默认值
`options`	组件可供选择的选项列表。	`BaseRadioOption[]`	`[]`
`value`	单选组当前选中选项的受控值。	`string`	`—`
`defaultValue`	非受控模式下使用的初始值。	`string`	`—`
`name`	提交表单时使用的字段名称。	`string`	`—`
`form`	该字段关联的 form 元素 id。	`string`	`—`
`orientation`	内容或交互项的排列方向。	`'horizontal' \| 'vertical'`	`'vertical'`
`required`	是否将该字段标记为必填。	`boolean`	`false`
`invalid`	是否进入无效状态并应用相应的校验样式与语义。	`boolean`	`false`
`disabled`	是否禁用该组件及其可交互行为。	`boolean`	`false`
`controlSize`	内部表单控件使用的预设尺寸。	`BaseControlSize`	`—`
`appearance`	覆盖组件使用的外观令牌或局部样式配置。	`BaseAppearance`	`—`
`className`	追加到组件根元素的 CSS 类名。	`string`	`—`
`classNames`	按组件公开的结构插槽分别追加 CSS 类名。	`BaseRadioGroupClassNames`	`—`
`style`	追加到组件根元素的内联样式。	`CSSProperties`	`—`
`children`	在 BaseRadioGroup 内渲染的子内容；支持渲染函数时以对应的 Props 类型为准。	`ReactNode`	`—`
`onChange`	底层输入事件发生时调用的原生变更回调。	`ChangeEventHandler<HTMLInputElement>`	`—`
`onValueChange`	值变化时调用的回调；参数结构以当前组件的 Props 类型为准。	`(value: string, event: ChangeEvent<HTMLInputElement>) => void`	`—`

属性

说明

类型

默认值

options

组件可供选择的选项列表。

BaseRadioOption[]

[]

value

单选组当前选中选项的受控值。

string

—