mms-radio 单选项
简述
mms-radio 表示一组互斥选项中的一个选项,须作为 mms-radio-group 的子节点使用;选中状态由父级 v-model 与子项 value 是否一致决定。
IMPORTANT
本组件为 mmsUnix 自研;请勿与外部未授权商业组件源码混用或逐字对照非本库文档,以免授权风险。
注意
注意: 请以 uni_modules/mms-unix 与本文为准;各端差异以 uni-app 与各平台官方文档为准。涉及隐私能力(相册、定位、剪贴板、手机号等)需在 manifest 与后台完成配置。
平台差异说明
| App(vue) | App(nvue) | H5 | 小程序 |
|---|---|---|---|
| √ | √ | √ | √ |
基本使用
完整写法与组级 v-model 见 mms-radio-group。典型结构:
uvue
<mms-radio-group v-model="payType" direction="row">
<mms-radio value="wx">
<text>微信支付</text>
</mms-radio>
<mms-radio value="ali">
<text>支付宝</text>
</mms-radio>
</mms-radio-group>注意:不要脱离 mms-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 | 选项文案(如图标 + 文字) |
与表单组合
可与 mms-form、mms-input 同页使用;演示路径见 mms-radio-group。
