• 单项选择器 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事件能监听到选中项的变化。

    示例代码

    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值}-