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


基础用法
页面 .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 |
其他说明
无