- 单项选择器 Radio-Group
- 单选项目 Radio
- 基础案例
- 示例代码
- 单个Radio布局方式
- 多个Radio布局方式
- 示例代码
- 设置选中项
- 示例代码
- 设置选中项的颜色
- 示例代码
- 设置禁用
- 示例代码
- 自定义Radio的内容部分
- 示例代码
- 单选组件属性(Radio Attributes)
- 单项选择器组件属性(Radio-Group Attributes)
- 单项选择器事件 (Radio-Group Events)
- 基础案例
单项选择器 Radio-Group
单项选择器,与原生组件
Radio-Group
用法类似,内部由多个l-radio
组件组成。
单选项目 Radio
单选项目,与原生组件
Radio
用法类似,内部可传入slot。与Radio-Group
搭配使用。
基础案例
单项选择器内部由多个l-radio
组成,linchange
事件能监听到选中项的变化。
示例代码
<l-radio-group current="{{current}}" bind:linchange="onChangeTap" >
<l-radio
wx:for-items="{{items}}"
wx:key="{{item.value}}"
value="{{item.value}}"
disabled="{{item.disabled}}">
</l-radio>
</l-radio-group>
data: {
current: '中国',
items: [
{ value: '美国' },
{ value: '中国' },
{ value: '巴西' },
{ value: '日本' },
{ value: '英国' },
{ value: '法国' },
]
}
根据具体需求,选择最佳的标签对齐方式(输入框标题和输入框部分)。
placement
默认值是 left
,即radio的选中图标居左显示。值为 right
时,图标居右显示。
单个Radio布局方式
根据具体需求,选择最佳的标签对齐方式(选中图标和内容部分)。
placement
默认值是 left
,即Radio
的选中图标居左显示。值为 right
时,图标居右显示。
多个Radio布局方式
根据具体需求,选择最佳的多个Radio
组件对齐方式,需要设置Radio-Group
组件的placement
属性。
placement
默认值是 column
,可选项为 row/column
。
示例代码
<l-radio-group bind:linchange="onChangeTap" >
<l-radio placement="right" value="中国" />
</l-radio-group>
设置选中项
当我们需要将某一个Radio
设置为当前选中项时,需要将当前Radio
的value
值传递到 Radio-Group
的current
属性当中,current
接收字符串。
注意事项
Radio-Group
的current
属性的类型是字符串。
示例代码
<l-radio-group current="中国" bind:linchange="onChangeTap" >
<l-radio value="中国" />
<l-radio value="美国" />
</l-radio-group>
设置选中项的颜色
当我们需要改变radio
选中时的颜色时,可以通过color
属性来设置
示例代码
<l-radio value="中国" color="red">
设置禁用
当我们需要将某一个选项禁用时,设置 disabled
为 true
即可。
示例代码
<l-radio value="中国" disabled="{{true}}" >
自定义Radio的内容部分
通过 <slot>
的方式可以自定义Radio
组件的右边部分,在此之前需要将custom
设置为true
示例代码
<l-radio custom="{{true}}" disabled="{{true}}" >
<view>
<image src="path/to/img.png" class="img"/>
<text>中国</text>
</view>
</l-radio>
单选组件属性(Radio Attributes)
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
value | 当前项的 value | String | ||
size | checkbox的大小 | String/Number | 36 | |
shape | checkbox的形状 | String | right/circle | 36 |
color | radio被选中时的颜色 | String | #38g9db | |
checked | 当前项是否选中/与Radio-Group 连用时失效。请查看Radio-Group的current属性介绍 | Boolean | true/false | false |
disabled | 设置是否禁用 | Boolean | true/false | false |
placement | 设置radio图标的位置 | String | left/right | left |
custom | 设置是否传入slot | Boolean | true/false | false |
l-class | 设置radio的外部样式类 | String | ||
l-title-class | 设置radio文字部分的外部样式类 | String | ||
tip-type | 校验错误提醒方式 | String | toast/message/text | - |
l-error-text | tipType 为 text 时,错误提示信息外部样式类 | String |
单项选择器组件属性(Radio-Group Attributes)
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
current | 如果radio组件的value值与current的值相等,那么该radio会标记选中 | String | ||
placement | 更改checkbox的flex布局 | String | row/column | column |
单项选择器事件 (Radio-Group Events)
事件名称 | 说明 | 返回值 | 备注 |
---|---|---|---|
bind:linchange | 键盘输入时触发 | 选中项发生变化时触发 linchange 事件,event.detail = {value: 选中项radio的value,id:选中项的index值} | - |