跳到主要内容

Radio 单选框

用于在多个备选项中选中单个状态。

何时使用

  • 用于在多个备选项中选中单个状态。
  • 和 Select 的区别是,Radio 所有选项默认可见,方便用户在比较中选择,因此选项不宜过多。
提示

当选项配置有两个或三个且选择项需要唯一时,使用单选框组件。后处理单选框默认必须选中其中一个选项,选项间互斥。

代码示例

基本使用

最简单的用法。

组合使用

一组互斥的 Radio 配合使用。

禁用状态

Radio 不可用状态。

API

参数说明类型默认值
autoFocus自动获取焦点booleanfalse
checked指定当前是否选中booleanfalse
className样式类名string-
defaultChecked默认是否选中booleanfalse
disabled是否禁用booleanfalse
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;
}