跳到主要内容

Radio 单选框 ​

WebH5

单选框。通常放在 RadioGroup 内使用(选中态由组值 === value 决定);也可单独使用,通过 v-model:checked 绑定。

何时使用 ​

与 RadioGroup 配合做互斥单选;或单独作为布尔开关项。

何时不使用 ​

多选用 Checkbox;状态开关用 Switch。

Props ​

名称类型默认值说明
valuestring | number-选项值;在 RadioGroup 内时与组 modelValue 比对决定选中态
labelstring""标签文本;默认插槽存在时被覆盖
disabledbooleanfalse禁用;RadioGroup 禁用时一并禁用
checkedbooleanfalse单独使用(不在 RadioGroup 内)时的选中态,对应 v-model:checked

Events ​

名称载荷说明
clickMouseEvent点击时触发;disabled 时不触发
update:checkedboolean单独使用时点击触发,用于 v-model:checked;在组内不触发
changeboolean单独使用时点击触发;在组内由 RadioGroup 的 change 代替

Slots ​

名称说明
default标签内容,覆盖 label 文本

示例 ​

组内使用 ​

示例加载中…

单独使用 ​

示例加载中…

选中值回显 + 禁用项 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Radio 文档(含手机预览)。