# label

可以通过绑定表单内的组件,用来改进表单组件的可用性。

  • 使用 for 属性找到对应的 id,或者将控件放在该标签下,当点击时,就会触发对应的控件。
  • for 优先级高于内部控件,内部有多个控件的时候默认触发第一个控件。
  • 目前可以绑定的控件有:button, checkbox, radio, switch
属性 类型 默认值 必填 说明
for string 绑定控件的 id

# 使用效果

label

# 示例代码

<!-- qxml -->
<view class="page-section page-section-gap">
  <view class="page-section-title">表单组件在label内</view>
  <checkbox-group class="group" bindchange="checkboxChange">
    <view class="label-1" qa:for="{{checkboxItems}}">
      <label>
        <checkbox value="{{item.name}}" checked="{{item.checked}}"></checkbox>
        <text class="label-1-text">{{item.value}}</text>
      </label>
    </view>
  </checkbox-group>
</view>

<view class="page-section page-section-gap">
  <view class="page-section-title">label用for标识表单组件</view>
  <radio-group class="group" bindchange="radioChange">
    <view class="label-2" qa:for="{{radioItems}}">
      <radio id="{{item.name}}" value="{{item.name}}" checked="{{item.checked}}"></radio>
      <label class="label-2-text" for="{{item.name}}"><text>{{item.name}}</text></label>
    </view>
  </radio-group>
</view>

<view class="page-section page-section-gap">
  <view class="page-section-title">label内有多个时选中第一个</view>
  <label class="label-3">
    <checkbox class="checkbox-3">选项一</checkbox>
    <checkbox class="checkbox-3">选项二</checkbox>
    <view class="label-3-text">点击该label下的文字默认选中第一个checkbox</view>
  </label>
</view>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// js
Page({
  data: {
    checkboxItems: [{ name: 'USA', value: '美国' }, { name: 'CHN', value: '中国', checked: 'true' }],
    radioItems: [{ name: 'USA', value: '美国' }, { name: 'CHN', value: '中国', checked: 'true' }],
    hidden: false
  },

  checkboxChange(e) {
    const checked = e.detail.value
    const changed = {}
    for (let i = 0; i < this.data.checkboxItems.length; i++) {
      if (checked.indexOf(this.data.checkboxItems[i].name) !== -1) {
        changed['checkboxItems[' + i + '].checked'] = true
      } else {
        changed['checkboxItems[' + i + '].checked'] = false
      }
    }
    this.setData(changed)
  },

  radioChange(e) {
    const checked = e.detail.value
    const changed = {}
    for (let i = 0; i < this.data.radioItems.length; i++) {
      if (checked.indexOf(this.data.radioItems[i].name) !== -1) {
        changed['radioItems[' + i + '].checked'] = true
      } else {
        changed['radioItems[' + i + '].checked'] = false
      }
    }
    this.setData(changed)
  },

  tapEvent() {
    console.log('按钮被点击')
  }
})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
/* css */
.label-1,
.label-2 {
  margin: 30rpx 0;
}
.label-3-text {
  color: #576b95;
  font-size: 28rpx;
}
.checkbox-3 {
  display: block;
  margin: 30rpx 0;
}
1
2
3
4
5
6
7
8
9
10
11
12
13

在线客服