Radio 单选框
WebH5
单选框。通常放在 RadioGroup 内使用(选中态由组值 === value 决定);也可单独使用,通过 v-model:checked 绑定。
何时使用
与 RadioGroup 配合做互斥单选;或单独作为布尔开关项。
何时不使用
多选用 Checkbox;状态开关用 Switch。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
value | string | number | - | 选项值;在 RadioGroup 内时与组 modelValue 比对决定选中态 |
label | string | "" | 标签文本;默认插槽存在时被覆盖 |
disabled | boolean | false | 禁用;RadioGroup 禁用时一并禁用 |
checked | boolean | false | 单独使用(不在 RadioGroup 内)时的选中态,对应 v-model:checked |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
click | MouseEvent | 点击时触发;disabled 时不触发 |
update:checked | boolean | 单独使用时点击触发,用于 v-model:checked;在组内不触发 |
change | boolean | 单独使用时点击触发;在组内由 RadioGroup 的 change 代替 |
Slots
| 名称 | 说明 |
|---|---|
default | 标签内容,覆盖 label 文本 |
示例
组内使用
示例加载中…
单独使用
示例加载中…
选中值回显 + 禁用项
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Radio 文档(含手机预览)。