@wines/radio

Radio 单选框

用于展现一组可选项单项选择，或者单独用于切换到选中状态，预设 9 种颜色 light, stable, positive, calm, assertive, balanced, energized, royal, dark 可选用。

使用指南

在 page.json 中引入组件

{
  "navigationBarTitleText": "Radio",
  "usingComponents": {
    "wux-radio": "@wines/radio",
    "wux-radio-group": "@wines/radio-group"
  }
}

示例

<view class="page">
    <view class="page__hd">
        <view class="page__title">Radio</view>
        <view class="page__desc">单选框</view>
    </view>
    <view class="page__bd">
        <form bindsubmit="formSubmit">
            <wux-radio-group
             name="a"
             value="{{ value1 }}"
             title="Default"
             bind:change="onChange1"
            >
                <wux-radio color="light" title="Light" value="1" />
                <wux-radio color="stable" title="Stable" value="2" />
                <wux-radio color="positive" title="Positive" value="3" />
                <wux-radio color="calm" title="Calm" value="4" />
                <wux-radio color="balanced" title="Balanced" value="5" />
                <wux-radio color="energized" title="Energized" value="6" />
                <wux-radio color="assertive" title="Assertive" value="7" />
                <wux-radio color="royal" title="Royal" value="8" />
                <wux-radio color="dark" title="Dark" value="9" />
            </wux-radio-group>
            <wux-radio-group
             name="b"
             value="{{ value2 }}"
             title="Label"
             bind:change="onChange2"
            >
                <wux-radio title="Java" label="details" value="1" />
                <wux-radio title="PHP" label="details" value="2" />
            </wux-radio-group>
            <wux-radio-group
             name="c"
             value="{{ value3 }}"
             title="Thumb"
             bind:change="onChange3"
            >
                <wux-radio thumb="http://cdn.skyvow.cn/logo.png" title="Java" value="1" />
                <wux-radio thumb="http://cdn.skyvow.cn/logo.png" title="PHP" value="2" />
            </wux-radio-group>
            <wux-radio-group
             name="d"
             value="{{ value4 }}"
             title="Trigger onChange"
             bind:change="onChange4"
            >
                <wux-radio title="Java" value="1" />
                <wux-radio title="PHP" value="2" />
            </wux-radio-group>
            <wux-radio-group name="e" title="Disabled" value="1">
                <wux-radio title="AV" value="1" disabled />
                <wux-radio title="PHP" value="2" disabled />
            </wux-radio-group>
            <wux-radio-group
             name="f"
             value="{{ value5 }}"
             options="{{ options }}"
             title="Options"
             bind:change="onChange5"
            />
            <view class="btn-area">
                <button formType="submit">Submit</button>
            </view>
        </form>
    </view>
</view>

import './index.less';
import { RadioGroupOnChangeValue } from '@wines/radio-group';

Page({
  data: {
    value1: '1',
    value2: '1',
    value3: '1',
    value4: '1',
    value5: '1',
    options: [
      { title: 'Java', value: '1' },
      { title: 'PHP', value: '2' },
    ],
    // options: ['1', '2'],
  },
  onChange(field, e) {
    const detail = e.detail as RadioGroupOnChangeValue;
    this.setData({
      [field]: detail.value,
    });

    console.log('radio发生change事件，携带value值为：', e.detail);
  },
  onChange1(e) {
    this.onChange('value1', e);
  },
  onChange2(e) {
    this.onChange('value2', e);
  },
  onChange3(e) {
    this.onChange('value3', e);
  },
  onChange4(e) {
    this.onChange('value4', e);
  },
  onChange5(e) {
    this.onChange('value5', e);
  },
  formSubmit(e) {
    console.log('form发生了submit事件，携带数据为：', e.detail.value);
  },
});

API

RadioGroup props

参数	类型	描述	默认值
prefixCls	string	自定义类名前缀	wux-radio-group
cellGroupPrefixCls	string	自定义 cellGroup 类名前缀	wux-cell-group
name	string	在表单中的字段名	-
value	string	在表单中的字段值（当前选中项的值）	-
title	string	标题	-
label	string	描述	-
options	array	以配置形式设置子元素，优先级高于 slot	[]
bind:change	function	change 事件触发的回调函数	-

Radio props

参数	类型	描述	默认值
prefixCls	string	自定义类名前缀	wux-radio
cellPrefixCls	string	自定义 cell 类名前缀	wux-cell
selectablePrefixCls	string	自定义 selectable 类名前缀	wux-selectable
thumb	string	左侧缩略图	-
title	string	左侧标题	-
label	string	标题下方的描述信息	-
value	string	当前项的值	-
checked	boolean	是否默认选中	false
disabled	boolean	是否不可修改	false
color	string	主题色，可选值为 light、stable、positive、calm、assertive、balanced、energized、royal、dark	balanced
bind:change	function	change 事件触发的回调函数，优先级低于父级 change 事件	-