输入类 · Radio
单选框
用户使用单选框来从少量的选项集合中选择单个选项
使用场景
单选框(Radio)也叫单选按钮,它允许用户在一组选项中选择其中一个。
当选项很多时,单选下拉菜单(Select)可能比较适合,因为它所占用的画面空间比单选按钮来得要少。
当选项很多时,单选下拉菜单(Select)可能比较适合,因为它所占用的画面空间比单选按钮来得要少。
代码演示
如何引入
基本用法
带辅助文本
通过
extra设置辅助文本,可以是任意类型的 ReactNode禁用
Radio 不可用
高级模式
高级模式(mode='advanced')checked 可以通过点击转换为 unchecked。
单选组合
一组互斥的 Radio 配合使用
垂直排列
可通过给 RadioGroup 设置
direction属性来决定 组内的 radio 元素水平排列或者垂直排列按钮样式
version: >=1.26.0
可以利用
type='button' 来设置 button 样式类型的单选器,并且,button 类型单选器支持三种尺寸大小。需要注意的是: button 类型的单选器暂不支持辅助文本(
extra)和垂直排列(direction='vertical')。卡片样式
version: >=1.30.0
可以给
RadioGroup 设置 type='card' 实现带有背景的卡片样式。无 radio 的纯卡片样式
version: >=1.30.0
可以给
RadioGroup 设置 type='pureCard' 实现带有背景且无 radio 的纯卡片样式。配置 options
通过配置 options 参数来渲染单选框
API 参考
Radio
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| addonClassName | 包裹内容容器的样式类名 v1.16.0 后提供 | string | |
| addonId | addon 节点 id,aria-labelledby 指向这个 id,若无设置会随机生成一个 id v2.11.0 后提供 | string | |
| addonStyle | 包裹内容容器的内联样式 v1.16.0 后提供 | CSSProperties | |
| aria-label | Radio 的 label | string | - |
| autoFocus | 自动获取焦点 | boolean | false |
| checked | 指定当前是否选中 | boolean | false |
| className | 样式类名 | string | |
| defaultChecked | 初始是否选中 | boolean | false |
| disabled | 禁选单选框 | boolean | false |
| extra | 副文本,只对type='default'生效 | ReactNode | - |
| extraId | 副文本的 id,aria-describedby 指向这个 id,若无设置会随机生成一个 id v2.11.0 后提供 | ReactNode | - |
| mode | 高级和普通模式,高级模式可以在 checked 时点击变成 unchecked,可选值 advanced | string | - |
| name | Radio组件中input[type="radio"]的name属性,具有相同name的Radio属于同一个RadioGroup,name属性可参考 MDN Radio | string | - |
| preventScroll | 指示浏览器是否应滚动文档以显示新聚焦的元素,作用于组件内的 focus 方法 | boolean | |
| style | 内联样式 | CSSProperties | |
| type | 设置 radio的样式类型,可选值为:default、button、card、pureCard 该 api 在 v2.18.0 后提供 | string | default |
| value | 根据 value 进行比较,判断是否选中 | string | number | - |
| onChange | 选项变化时的回调函数 | function(e:Event) | - |
| onMouseEnter | 鼠标移入选项时的回调函数 | function(e:Event) | - |
| onMouseLeave | 鼠标移出选项时的回调函数 | function(e:Event) | - |
RadioGroup
单选框组合,用于包裹一组
Radio。| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| aria-label | RadioGroup 的 label | string | - |
| buttonSize | type='button'的radio的尺寸大小,可选值为:small、middle、large v1.26.0 后提供 | string | middle |
| className | 样式类名 | string | |
| defaultValue | 默认选中的值 | string | number | - |
| direction | radio 排列方向, 只对type='default'生效,可选值horizontal、vertical v0.31.0 后提供 | string | horizontal |
| disabled | 禁选所有子单选器 | boolean | false |
| mode | 高级和普通模式,可以在 checked 时点击变成 unchecked,可选值 advanced v1.9.0 后提供 | string | - |
| name | RadioGroup 下所有 input[type="radio"] 的 name 属性 | string | - |
| options | 以配置形式设置子元素 | Array | - |
| style | 内联样式 | CSSProperties | |
| value | 用于设置当前选中的值 | string | number | - |
| type | 设置所有radio的样式类型,可选值为:default、button、card、pureCard 该 api 在 v1.26.0 后提供,其中 card 和 pureCard 在 v1.30.0 后提供 | string | default |
| onChange | 选项变化时的回调函数 | function(e:Event) | - |
Methods
Radio
| 名称 | 描述 |
|---|---|
| blur() | 移除焦点 |
| focus() | 获取焦点 |
Accessibility
ARIA
aria-label:用于解释 Radio 或 RadioGroup 的作用aria-labelledby默认指向 addon 节点,用于解释 Radio 的内容aria-describedby默认指向 extra 节点,用于补充解释 Radio 的内容
键盘和焦点
- RadioGroup 可以被获取焦点,初始焦点设置:
- 当 RadioGroup 中没有被选择项时,初始焦点为第一个 Radio 项上
- 当 RadioGroup 中有选中项时,初始焦点为选中的 Radio 项上
- 在同一个 radiogroup 内
- 可以通过
右箭头或下箭头将焦点移动到下一个 Radio 项上,同时取消先前的 Radio 项的选中状态,并选中当前聚焦的 Radio 项 - 可以通过
左箭头或上箭头将焦点移动到上一个 Radio 项上,同时取消先前的 Radio 项的选中状态,并选中当前聚焦的 Radio 项
- 可以通过
- 若 RadioGroup 中没有选中项,可以
Space键选中初始焦点
文案规范
- 首字母大写
- 不使用标点符号