# Radio 单选框

# Radio 概述

基本组件-单选框。主要用于一组可选项的单选，或者单独用于切换到选中状态。

使用 v-model 可以双向绑定数据。

使用 Radio-group实现一组互斥的选项组。在组合使用时， Radio 使用 label 来自动判断。每个 Radio 的内容可以自定义，如不填写则默认使用 label 的值。

通过设置 disabled属性来禁用单选框

设置属性 vertical 可以垂直显示，按钮样式下无效。

组合使用时可以设置属性 type为 button 来应用按钮的样式。

通过设置属性 size 为 large 或 small 将按钮样式设置为大和小尺寸，不设置为默认(中)尺寸。

属性 canCancel ,默认为false，设为true后，再次点击该radio选项就可以取消选择。

属性	说明	类型	默认值
value	只在单独使用时有效。可以使用 `v-model` 双向绑定数据	Boolean	false
label	只在组合使用时有效。指定当前选项的 value 值，组合会自动判断当前选择的项目	String \| Number	-
disabled	是否禁用当前项	Boolean	false
size	多选框的尺寸，可选值为 large、small、default 或者不设置	String	-
true-value	选中时的值，当使用类似 1 和 0 来判断是否选中时会很有用	String, Number, Boolean	true
false-value	没有选中时的值，当使用类似 1 和 0 来判断是否选中时会很有用	String, Number, Boolean	false
tabindex	设置输入框tabindex (v1.0.47)	String \| Number	0
canCancel	再次点击该radio选项是否可以取消选择 (v1.0.72)	Boolean	false

事件名	说明	返回值
on-change	在选项状态发生改变时触发，返回当前状态。通过修改外部的数据改变时不会触发	...
on-click	点击时触发（此属性只支持1.0.19版本以及以上）	...
on-focus	聚焦时触发（此属性只支持1.0.49版本以及以上）	...
on-blur	失焦时触发（此属性只支持1.0.49版本以及以上）	...

属性	说明	类型	默认值
value	指定当前选中的项目数据。可以使用 `v-model` 双向绑定数据	String \| Number	-
type	可选值为 button 或不填，为 button 时使用按钮样式	String	-
size	尺寸，只对按钮样式生效，可选值为`large`和`small`或者不设置	String	-
vertical	是否垂直排列，按钮样式下无效	Boolean	false
btnIcon	是否显示按钮样式下的单选图标【此属性仅在1.0.21及其以上版本使用】	Boolean	false
btnIconOnlyChecked	当显示按钮样式下的图标时，是否仅显示选中状态下的单选图标【此属性仅在1.0.21及其以上版本使用】	Boolean	false
text	显示文字，层级高于label，低于slot(v1.0.39)	String, Number	null
tabindex	设置输入框tabindex（v1.0.47）	String \| Number	0
canCancel	再次点击该radio-group下radio选项是否可以取消选择（v1.0.72）	Boolean	false

事件名	说明	返回值
on-change	在选项状态发生改变时触发，返回当前选中的项。通过修改外部的数据改变时不会触发	...
on-click	点击时触发（此属性只支持1.0.19版本以及以上）	...

方法	说明	返回值
focus	鼠标聚焦 RadioGroup 下的 radio 组件，聚焦时可以左右切换选中（该键盘操作由浏览器提供，目前已知 ie 不支持）（v1.0.40）	无
blur	RadioGroup 下的 radio 组件失去焦点（v1.0.40）	无