Radio 单选框
用于在多个备选项中选中单个状态。
何时使用
- 用于在多个备选项中选中单个状态。
- 和 Select 的区别是,Radio 所有选项默认可见,方便用户在比较中选择,因此选项不宜过多。
提示
当选项配置有两个或三个且选择项需要唯一时,使用单选框组件。后处理单选框默认必须选中其中一个选项,选项间互斥。
代码示例
基本使用
最简单的用法。
组合使用
一组互斥的 Radio 配合使用。
禁用状态
Radio 不可用状态。
API
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
autoFocus | 自动获取焦点 | boolean | false |
checked | 指定当前是否选中 | boolean | false |
className | 样式类名 | string | - |
defaultChecked | 默认是否选中 | boolean | false |
disabled | 是否禁用 | boolean | false |
name | 原生 name 属性 | string | - |
options | 指定可选项 | { label: string, value: string | number }[] | - |
value | 根据 value 进行比较 | string | number | - |
onChange | 变化时回调函数 | function(e:Event) | - |
options
interface RadioOption {
label: React.ReactNode;
value: string;
disabled?: boolean;
}