Skip to content

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-modelm-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 的 modelValuestring''
disabled单项禁用(组 disabled 为 true 时全部禁用)booleanfalse
color选中填充色;checkOnly 时为对号颜色string''(继承组或 #5677fc
borderColor未选中时的描边颜色string''(继承组或 #cccccc
checkMarkColor实心圆内对号颜色string#ffffff
size圆(或对号区)尺寸,rpxnumber | string40
scale图标区域整体缩放倍数number | string1
checkOnly为 true 时选中仅显示对号,无实心圆填充booleanfalse

Events

事件名说明回调参数
click点击且成功切换选中时当前项 value

插槽

名称说明
default选项文案(如图标 + 文字)

与表单组合

可与 m-formm-input 同页使用;演示路径见 m-radio-group

Released under the MIT License.