m-radio 单选项
简述
m-radio 表示一组互斥选项中的一个选项,须作为 m-radio-group 的子节点使用;选中状态由父级 v-model 与子项 value 是否一致决定。
IMPORTANT
本组件为 mmsUnix 自研;请勿与外部未授权商业组件源码混用或逐字对照非本库文档,以免授权风险。
注意
请以 uni_modules/m-unix 与本文为准;各端差异以 uni-app 与各平台官方文档为准。涉及隐私能力(相册、定位、剪贴板、手机号等)需在 manifest 与后台完成配置。
平台差异说明
| App(vue) | App(nvue) | H5 | 小程序 |
|---|---|---|---|
| √ | √ | √ | √ |
演示地址
与线上 H5 演示基座 分包一致(文档站右下角预览 iframe 亦指向同一路径)。
| 类型 | 地址 |
|---|---|
| 分包路径 | pages_demo/radio/radio |
| 线上 H5(hash) | 打开演示 |
基本使用
完整写法与组级 v-model 见 m-radio-group。典型结构:
uvue
<m-radio-group v-model="payType" direction="row">
<m-radio value="wx">
<text>微信支付</text>
</m-radio>
<m-radio value="ali">
<text>支付宝</text>
</m-radio>
</m-radio-group>注意:不要脱离 m-radio-group 单独使用;value 建议为非空字符串。
Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
value | 选项值,选中时写入 group 的 modelValue | string | '' |
disabled | 单项禁用(组 disabled 为 true 时全部禁用) | boolean | false |
color | 选中填充色;checkOnly 时为对号颜色 | string | ''(继承组或 #5677fc) |
borderColor | 未选中时的描边颜色 | string | ''(继承组或 #cccccc) |
checkMarkColor | 实心圆内对号颜色 | string | #ffffff |
size | 圆(或对号区)尺寸,rpx | number | string | 40 |
scale | 图标区域整体缩放倍数 | number | string | 1 |
checkOnly | 为 true 时选中仅显示对号,无实心圆填充 | boolean | false |
Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
click | 点击且成功切换选中时 | 当前项 value |
插槽
| 名称 | 说明 |
|---|---|
default | 选项文案(如图标 + 文字) |
与表单组合
可与 m-form、m-input 同页使用;演示路径见 m-radio-group。
