ant-design/components/radio/index.zh-CN.md
afc163 e027cbec1c
docs: format all markdown (#38629)
* chore: add prettier-ignore in markdown demo

* docs: format markdown api table

* docs: format markdown api table
2022-11-17 17:31:26 +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: string 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() 获取焦点