Radio 单选框

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

使用指南

在 page.json 中引入组件

  1. {
  2. "navigationBarTitleText": "Radio",
  3. "usingComponents": {
  4. "wux-radio-group": "../../dist/radio-group/index",
  5. "wux-radio": "../../dist/radio/index"
  6. }
  7. }

示例

  1. <view class="page">
  2. <view class="page__hd">
  3. <view class="page__title">Radio</view>
  4. <view class="page__desc">单选框</view>
  5. </view>
  6. <view class="page__bd">
  7. <form bindsubmit="formSubmit">
  8. <wux-radio-group name="a" value="{{ value1 }}" title="Default" bind:change="onChange1">
  9. <wux-radio color="light" title="Light" value="1" />
  10. <wux-radio color="stable" title="Stable" value="2" />
  11. <wux-radio color="positive" title="Positive" value="3" />
  12. <wux-radio color="calm" title="Calm" value="4" />
  13. <wux-radio color="balanced" title="Balanced" value="5" />
  14. <wux-radio color="energized" title="Energized" value="6" />
  15. <wux-radio color="assertive" title="Assertive" value="7" />
  16. <wux-radio color="royal" title="Royal" value="8" />
  17. <wux-radio color="dark" title="Dark" value="9" />
  18. </wux-radio-group>
  19. <wux-radio-group name="b" value="{{ value2 }}" title="Label" bind:change="onChange2">
  20. <wux-radio title="Java" label="details" value="1" />
  21. <wux-radio title="PHP" label="details" value="2" />
  22. </wux-radio-group>
  23. <wux-radio-group name="c" value="{{ value3 }}" title="Thumb" bind:change="onChange3">
  24. <wux-radio thumb="https://wux.cdn.cloverstd.com/logo.png" title="Java" value="1" />
  25. <wux-radio thumb="https://wux.cdn.cloverstd.com/logo.png" title="PHP" value="2" />
  26. </wux-radio-group>
  27. <wux-radio-group name="d" value="{{ value4 }}" title="Trigger onChange" bind:change="onChange4">
  28. <wux-radio title="Java" value="1" />
  29. <wux-radio title="PHP" value="2" />
  30. </wux-radio-group>
  31. <wux-radio-group name="e" title="Disabled" value="1">
  32. <wux-radio title="AV" value="1" disabled />
  33. <wux-radio title="PHP" value="2" disabled />
  34. </wux-radio-group>
  35. <wux-radio-group name="f" value="{{ value5 }}" options="{{ options }}" title="Options" bind:change="onChange5" />
  36. <view class="btn-area">
  37. <button formType="submit">Submit</button>
  38. </view>
  39. </form>
  40. </view>
  41. </view>
  1. Page({
  2. data: {
  3. value1: '1',
  4. value2: '1',
  5. value3: '1',
  6. value4: '1',
  7. value5: '1',
  8. options: [{ title: 'Java', value: '1' }, { title: 'PHP', value: '2' }],
  9. // options: ['1', '2'],
  10. },
  11. onChange(field, e) {
  12. this.setData({
  13. [field]: e.detail.value
  14. })
  15. console.log('radio发生change事件,携带value值为:', e.detail)
  16. },
  17. onChange1(e) {
  18. this.onChange('value1', e)
  19. },
  20. onChange2(e) {
  21. this.onChange('value2', e)
  22. },
  23. onChange3(e) {
  24. this.onChange('value3', e)
  25. },
  26. onChange4(e) {
  27. this.onChange('value4', e)
  28. },
  29. onChange5(e) {
  30. this.onChange('value5', e)
  31. },
  32. formSubmit(e) {
  33. console.log('form发生了submit事件,携带数据为:', e.detail.value)
  34. },
  35. })

视频演示

Radio

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 事件 -