Checkbox 复选框

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

使用指南

在 page.json 中引入组件

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

示例

  1. <view class="page">
  2. <view class="page__hd">
  3. <view class="page__title">Checkbox</view>
  4. <view class="page__desc">复选框</view>
  5. </view>
  6. <view class="page__bd">
  7. <form bindsubmit="formSubmit">
  8. <wux-checkbox-group name="a" value="{{ value1 }}" title="Default" bind:change="onChange1">
  9. <wux-checkbox color="light" title="Light" value="1" />
  10. <wux-checkbox color="stable" title="Stable" value="2" />
  11. <wux-checkbox color="positive" title="Positive" value="3" />
  12. <wux-checkbox color="calm" title="Calm" value="4" />
  13. <wux-checkbox color="balanced" title="Balanced" value="5" />
  14. <wux-checkbox color="energized" title="Energized" value="6" />
  15. <wux-checkbox color="assertive" title="Assertive" value="7" />
  16. <wux-checkbox color="royal" title="Royal" value="8" />
  17. <wux-checkbox color="dark" title="Dark" value="9" />
  18. </wux-checkbox-group>
  19. <wux-checkbox-group name="b" value="{{ value2 }}" title="Label" bind:change="onChange2">
  20. <wux-checkbox title="Java" label="details" value="1" />
  21. <wux-checkbox title="PHP" label="details" value="2" />
  22. </wux-checkbox-group>
  23. <wux-checkbox-group name="c" value="{{ value3 }}" title="Extra" bind:change="onChange3">
  24. <wux-checkbox title="Java" extra="extra" value="1" />
  25. <wux-checkbox title="PHP" extra="extra" value="2" />
  26. </wux-checkbox-group>
  27. <wux-checkbox-group name="d" value="{{ value4 }}" title="Trigger onChange" bind:change="onChange4">
  28. <wux-checkbox title="Java" value="1" />
  29. <wux-checkbox title="PHP" value="2" />
  30. </wux-checkbox-group>
  31. <wux-checkbox-group name="e" value="{{ ['1'] }}" title="Disabled">
  32. <wux-checkbox title="AV" value="1" disabled />
  33. <wux-checkbox title="PHP" value="2" disabled />
  34. </wux-checkbox-group>
  35. <wux-checkbox-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. const { value } = e.detail
  13. const data = this.data[field]
  14. const index = data.indexOf(value)
  15. const current = index === -1 ? [...data, value] : data.filter((n) => n !== value)
  16. this.setData({
  17. [field]: current,
  18. })
  19. console.log('checkbox发生change事件,携带value值为:', e.detail.value)
  20. },
  21. onChange1(e) {
  22. this.onChange('value1', e)
  23. },
  24. onChange2(e) {
  25. this.onChange('value2', e)
  26. },
  27. onChange3(e) {
  28. this.onChange('value3', e)
  29. },
  30. onChange4(e) {
  31. this.onChange('value4', e)
  32. },
  33. onChange5(e) {
  34. this.onChange('value5', e)
  35. },
  36. formSubmit(e) {
  37. console.log('form发生了submit事件,携带数据为:', e.detail.value)
  38. },
  39. })

视频演示

Checkbox

API

CheckboxGroup props

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

Checkbox props

参数 类型 描述 默认值
prefixCls string 自定义类名前缀 wux-checkbox
cellPrefixCls string 自定义 cell 类名前缀 wux-cell
selectablePrefixCls string 自定义 selectable 类名前缀 wux-selectable
title string 左侧标题 -
label string 标题下方的描述信息 -
extra 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 事件 -