@tanzhenxing/zx-label v1.0.4

zx-label 组件

介绍

zx-label 用于改进表单组件的可用性。使用 for 属性找到对应 id 的控件，或者将控件放在该标签下，当点击时，就会触发对应的控件。

注意事项：

• for 属性优先级高于内部控件
• 内部有多个控件时默认触发第一个控件

属性说明

使用示例

1. 直接包裹控件（默认触发第一个控件）

<zx-label>
  <zx-checkbox v-model="value1">选项1</zx-checkbox>
</zx-label>

2. 使用for属性指定控件ID

<zx-label for="myCheckbox">
  <text>点我选中</text>
</zx-label>
<zx-checkbox v-model="value1" id="myCheckbox">选项1</zx-checkbox>

3. 多个控件包裹（触发第一个控件）

<zx-label>
  <!-- 默认触发第一个控件，此例中会触发zx-checkbox -->
  <zx-checkbox v-model="value1">选项1</zx-checkbox>
  <zx-radio v-model="value2">选项2</zx-radio>
</zx-label>

4. 设置样式

<zx-label padding="20rpx" margin="10rpx" isFull>
  <zx-switch v-model="switchValue"></zx-switch>
  <text>开启/关闭</text>
</zx-label>

5. 配合按钮使用

<zx-label for="submitBtn">
  <text>点击提交</text>
</zx-label>
<zx-button id="submitBtn" type="primary" @click="submit">提交</zx-button>

实现原理

zx-label 组件通过以下方式工作：

1. 包裹控件方式：将子组件注册到 childrens 数组中，点击时调用第一个子组件的 labelClick 方法。

2. for属性方式：通过 uni.createSelectorQuery() 查找指定 id 的元素，并模拟点击事件。

参考

该组件实现参考了uni-app的label组件。