ant-design/components/radio/index.zh-CN.md
Sagie501 3bdd9d0ff9
docs: Update Radio docs (#38957)
* Update index.en-US.md

* Update index.zh-CN.md

* Apply suggestions from code review

Co-authored-by: afc163 <afc163@gmail.com>
2022-11-24 23:51:00 +08:00

2.6 KiB
Raw Blame History

category subtitle group title cover demo
Components 单选框 数据录入 Radio https://gw.alipayobjects.com/zos/alicdn/8cYb5seNB/Radio.svg
cols
2

单选框。

何时使用

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

代码演示

基本 不可用 单选组合 Radio.Group 垂直 Radio.Group 组合 - 配置方式 按钮样式 单选组合 - 配合 name 使用 大小 填底的按钮样式 Badge style

API

Radio/Radio.Button

参数 说明 类型 默认值
autoFocus 自动获取焦点 boolean false
checked 指定当前是否选中 boolean false
defaultChecked 初始是否选中 boolean false
disabled 禁用 Radio boolean false
value 根据 value 进行比较,判断是否选中 any -

RadioGroup

单选框组合,用于包裹一组 Radio

参数 说明 类型 默认值 版本
buttonStyle RadioButton 的风格样式,目前有描边和填色两种风格 outline | solid outline
defaultValue 默认选中的值 any -
disabled 禁选所有子单选器 boolean false
name RadioGroup 下所有 input[type="radio"]name 属性 string -
options 以配置形式设置子元素 string[] | number[] | Array<{ label: ReactNode; value: string; disabled?: boolean; }> -
optionType 用于设置 Radio options 类型 default | button default 4.4.0
size 大小,只对按钮样式生效 large | middle | small -
value 用于设置当前选中的值 any -
onChange 选项变化时的回调函数 function(e:Event) -

方法

Radio

名称 描述
blur() 移除焦点
focus() 获取焦点