ant-design/components/radio/index.zh-CN.md

---
category: Components
subtitle: 单选框
type: Data Entry
title: Radio
---

单选框。

## 何时使用

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

## API

### Radio

| 参数           | 说明                                     | 类型       |  可选值 | 默认值 |
|----------------|------------------------------------------|------------|---------|--------|
| checked        | 指定当前是否选中                         | boolean    |         | false  |
| defaultChecked | 初始是否选中                             | boolean    |         | false  |
| value          | 根据 value 进行比较，判断是否选中        | any     |         | 无     |

### RadioGroup

单选框组合，用于包裹一组 `Radio`。

| 参数           | 说明                             | 类型              | 可选值 | 默认值 |
|----------------|----------------------------------|-------------------|--------|--------|
| name | RadioGroup 下所有 `input[type="radio"]` 的 `name` 属性 | string |  | 无 |
| onChange       | 选项变化时的回调函数             | Function(e:Event) | 无     | 无     |
| value          | 用于设置当前选中的值             | any            | 无     | 无     |
| defaultValue   | 默认选中的值                     | any            | 无     | 无     |
| size           | 大小，只对按钮样式生效           | string            | `large` `default` `small` | `default` |
| options        | 以配置形式设置子元素             | string[] \| Array<{ label: string value: string disabled?: boolean }>            | 无     | 无     |
-												docs: update documentation format

											
										
										
											2016-03-31 14:17:09 +08:00
+								---
 								category: Components
-												docs: translation of Rate && Radio (#2440)


											
										
										
											2016-07-21 10:10:04 +08:00
+								subtitle: 单选框
-												docs: 调整组件导航结构 (#3758)

- Layout 更名为 Grid
											
										
										
											2016-11-09 14:43:32 +08:00
+								type: Data Entry
-												docs: translation of Rate && Radio (#2440)


											
										
										
											2016-07-21 10:10:04 +08:00
+								title: Radio
-												docs: update documentation format

											
										
										
											2016-03-31 14:17:09 +08:00
+								---
-												add radio

											
										
										
											2015-07-16 18:23:25 +08:00
-												update radio API document

											
										
										
											2015-07-28 20:22:37 +08:00
+								单选框。
-												add radio

											
										
										
											2015-07-16 18:23:25 +08:00
+								## 何时使用
-												update radio demos

											
										
										
											2015-07-16 22:40:49 +08:00
+								- 用于在多个备选项中选中单个状态。
 								- 和 Select 的区别是，Radio 所有选项默认可见，方便用户在比较中选择，因此选项不宜过多。
-												add radio

											
										
										
											2015-07-16 18:23:25 +08:00
+								## API
-												Add radio group

											
										
										
											2015-07-17 16:06:46 +08:00
+								### Radio
-												update radio API document

											
										
										
											2015-07-28 20:22:37 +08:00
+								| 参数           | 说明                                     | 类型       |  可选值 | 默认值 |
-												Add radio group

											
										
										
											2015-07-17 16:06:46 +08:00
+								|----------------|------------------------------------------|------------|---------|--------|
-												docs: Unify type naming (#4636)

* Unify name of ReactNode type in document

* Lowser all string type name

* Lowercase all number type name

* Lowercase all boolean type name

* Unify array type

* Lowercase all object type name

* Unify mutilple types

											
										
										
											2017-01-20 20:10:50 +08:00
+								| checked        | 指定当前是否选中                         | boolean    |         | false  |
 								| defaultChecked | 初始是否选中                             | boolean    |         | false  |
-												docs: update document (#4263)


											
										
										
											2016-12-16 16:38:14 +08:00
+								| value          | 根据 value 进行比较，判断是否选中        | any     |         | 无     |
-												Add radio group

											
										
										
											2015-07-17 16:06:46 +08:00
 								### RadioGroup
-												update radio API document

											
										
										
											2015-07-28 20:22:37 +08:00
+								单选框组合，用于包裹一组 `Radio`。
-												fix radiogroup api

											
										
										
											2015-07-20 22:36:49 +08:00
-												update radio API document

											
										
										
											2015-07-28 20:22:37 +08:00
+								| 参数           | 说明                             | 类型              | 可选值 | 默认值 |
 								|----------------|----------------------------------|-------------------|--------|--------|
-												Radiogroup with `name` (#7009)

* Add a name property for RadioGroup

* Add document for RadioGroup's name property

* Add test case for RadioGroup name property

											
										
										
											2017-07-31 11:33:47 +08:00
+								| name | RadioGroup 下所有 `input[type="radio"]` 的 `name` 属性 | string |  | 无 |
-												update radio API document

											
										
										
											2015-07-28 20:22:37 +08:00
+								| onChange       | 选项变化时的回调函数             | Function(e:Event) | 无     | 无     |
-												optimize Radio declaration (#4260)

chore: optimize Radio declaration (#4260)
											
										
										
											2016-12-15 16:25:15 +08:00
+								| value          | 用于设置当前选中的值             | any            | 无     | 无     |
 								| defaultValue   | 默认选中的值                     | any            | 无     | 无     |
-												docs: Unify type naming (#4636)

* Unify name of ReactNode type in document

* Lowser all string type name

* Lowercase all number type name

* Lowercase all boolean type name

* Unify array type

* Lowercase all object type name

* Unify mutilple types

											
										
										
											2017-01-20 20:10:50 +08:00
+								| size           | 大小，只对按钮样式生效           | string            | `large` `default` `small` | `default` |
-												fix jslint (#5514)


											
										
										
											2017-03-28 11:56:38 +08:00
+								| options        | 以配置形式设置子元素             | string[] \| Array<{ label: string value: string disabled?: boolean }>            | 无     | 无     |