单项选择器 Radio-Group

单项选择器,与原生组件Radio-Group用法类似,内部由多个l-radio组件组成。

单选项目 Radio

单选项目,与原生组件Radio用法类似,内部可传入slot。与Radio-Group搭配使用。

基础案例

单项选择器内部由多个l-radio组成,linchange事件能监听到选中项的变化。

示例代码

  1. <l-radio-group current="{{current}}" bind:linchange="onChangeTap" >
  2. <l-radio
  3. wx:for-items="{{items}}"
  4. wx:key="{{item.value}}"
  5. value="{{item.value}}"
  6. disabled="{{item.disabled}}">
  7. </l-radio>
  8. </l-radio-group>
  1. data: {
  2. current: '中国',
  3. items: [
  4. { value: '美国' },
  5. { value: '中国' },
  6. { value: '巴西' },
  7. { value: '日本' },
  8. { value: '英国' },
  9. { value: '法国' },
  10. ]
  11. }

根据具体需求,选择最佳的标签对齐方式(输入框标题和输入框部分)。

placement 默认值是 left ,即radio的选中图标居左显示。值为 right 时,图标居右显示。

单个Radio布局方式

根据具体需求,选择最佳的标签对齐方式(选中图标和内容部分)。

placement 默认值是 left ,即Radio的选中图标居左显示。值为 right 时,图标居右显示。

多个Radio布局方式

根据具体需求,选择最佳的多个Radio组件对齐方式,需要设置Radio-Group组件的placement属性。

placement 默认值是 column ,可选项为 row/column

示例代码

  1. <l-radio-group bind:linchange="onChangeTap" >
  2. <l-radio placement="right" value="中国" />
  3. </l-radio-group>

设置选中项

当我们需要将某一个Radio设置为当前选中项时,需要将当前Radiovalue值传递到 Radio-Groupcurrent属性当中,current接收字符串。

注意事项

Radio-Groupcurrent属性的类型是字符串。

示例代码

<l-radio-group current="中国" bind:linchange="onChangeTap" >
  <l-radio  value="中国" />
  <l-radio  value="美国" />
</l-radio-group>

设置选中项的颜色

当我们需要改变radio选中时的颜色时,可以通过color 属性来设置

示例代码

<l-radio value="中国"  color="red">

设置禁用

当我们需要将某一个选项禁用时,设置 disabledtrue 即可。

示例代码

<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当前项的 valueString
sizecheckbox的大小String/Number36
shapecheckbox的形状Stringright/circle36
colorradio被选中时的颜色String#38g9db
checked当前项是否选中/与Radio-Group 连用时失效。请查看Radio-Group的current属性介绍Booleantrue/falsefalse
disabled设置是否禁用Booleantrue/falsefalse
placement设置radio图标的位置Stringleft/rightleft
custom设置是否传入slotBooleantrue/falsefalse
l-class设置radio的外部样式类String
l-title-class设置radio文字部分的外部样式类String
tip-type校验错误提醒方式Stringtoast/message/text-
l-error-texttipType 为 text 时,错误提示信息外部样式类String

单项选择器组件属性(Radio-Group Attributes)

参数说明类型可选值默认值
current如果radio组件的value值与current的值相等,那么该radio会标记选中String
placement更改checkbox的flex布局Stringrow/columncolumn

单项选择器事件 (Radio-Group Events)

事件名称说明返回值备注
bind:linchange键盘输入时触发选中项发生变化时触发 linchange 事件,event.detail = {value: 选中项radio的value,id:选中项的index值}-