Form

Radio单选框

用于互斥选项之间的选择,一般用于在一组选项中选择一个值。

用于互斥选项之间的选择,一般用于在一组选项中选择一个值。

示例图

基础用法

页面 .json 文件 usingComponents 中引入组件

// json
{
    "usingComponents": {
        "mx-radio": "/components/mxwui/radio/index"
    }
}

页面 .wxml 文件中使用组件

<mx-radio />

更多用法示例

文案 text

属性:text,标签文案。

<mx-radio text="自定义文案" />

文案颜色 textColor

属性:textColor,默认 #040A23,支持任何合法的颜色值。

<mx-radio text="标签" textColor="#1677FF" />

是否选中 checked

属性:checked,默认 false 不选中。

  • 选中
<mx-radio checked />

<mx-radio checked="{{true}}" />
  • 未选中
<mx-radio />

<mx-radio checked="{{false}}" />

是否禁用 disabled

属性:disabled,默认 false 不禁用。

  • 禁用
<mx-radio disabled />

<mx-radio disabled="{{true}}" />
  • 未禁用
<mx-radio />

<mx-radio disabled="{{false}}" />

单选框位置 radioPosition

属性:radioPosition,可选 after、before,默认 before 在标签文案之后。

  • 在标签之前
<mx-radio />

<mx-radio radioPosition />

<mx-radio radioPosition="before" />
  • 在标签之后
<mx-radio radioPosition="after" />

单选框未选中颜色 radioColor

属性:radioColor,默认 #9AA0B1,只支持十六进制颜色值。

<mx-radio radioColor="#000" />

单选框选中颜色 radioSelectColor

属性:radioSelectColor,默认 #CA0E2D,只支持十六进制颜色值。

<mx-radio radioSelectColor="#1677FF" />

单选框大小 radioSize

属性:radioSize,默认 48,数字,不带单位,默认使用rpx。

<mx-radio radioSize="32" />

自定义事件

事件:bind:radio_change,变更事件,返回字段 checked,值为 true 或 false。

<mx-radio 
    bind:radio_change="handleChange" 
/>

参数

参数 类型 必填 可选值 默认值 参数描述
text String 是 文案
textColor String 颜色值 #040A23 文案颜色,支持任何合法的颜色值
checked Boolean true、false false 是否选中
disabled Boolean true、false false 是否禁用
radioPosition String after、before before 单选框位置
radioColor String 颜色值 #9AA0B1 单选框未选中颜色,只支持十六进制颜色值
radioSelectColor String 颜色值 #CA0E2D 单选框未选中颜色,只支持十六进制颜色值
radioSize Number 数字 48 单选框大小,不带单位,默认使用rpx

事件

事件名称 类型 返回值 事件说明
bind:radio_change Change event.detail 变更事件,返回字段 checked,值为 true 或 false

其他说明

无