Checkbox 复选框

使用指南

  1. import { Checkbox, CheckboxGroup } from 'vant';
  2. Vue.use(Checkbox).use(CheckboxGroup);

代码演示

基础用法

通过v-model绑定 checkbox 的勾选状态

  1. <van-checkbox v-model="checked">复选框</van-checkbox>
  1. export default {
  2. data() {
  3. return {
  4. checked: true
  5. };
  6. }
  7. };

禁用状态

  1. <van-checkbox v-model="checked" disabled>复选框</van-checkbox>

禁用内容部分点击事件

  1. <van-checkbox v-model="checked" label-disabled>复选框</van-checkbox>

Checkbox 组

需要与van-checkbox-group一起使用,选中值是一个数组,通过v-model绑定在van-checkbox-group上,数组中的项即为选中的Checkboxname属性设置的值

  1. <van-checkbox-group v-model="result">
  2. <van-checkbox
  3. v-for="(item, index) in list"
  4. :key="item"
  5. :name="item"
  6. >
  7. 复选框 {{ item }}
  8. </van-checkbox>
  9. </van-checkbox-group>
  1. export default {
  2. data() {
  3. return {
  4. list: ['a', 'b', 'c'],
  5. result: ['a', 'b']
  6. };
  7. }
  8. };

设置最大可选数

  1. <van-checkbox-group v-model="result" :max="2">
  2. <van-checkbox
  3. v-for="(item, index) in list"
  4. :key="item"
  5. :name="item"
  6. >
  7. 复选框 {{ item }}
  8. </van-checkbox>
  9. </van-checkbox-group>

与 Cell 组件一起使用

此时你需要再引入CellCellGroup组件

  1. <van-checkbox-group v-model="result">
  2. <van-cell-group>
  3. <van-cell v-for="item in list" :title="`复选框 - {item}`" :key="item">
  4. <van-checkbox :name="item" />
  5. </van-cell>
  6. </van-cell-group>
  7. </van-checkbox-group>

Checkbox API

参数 说明 类型 默认值
v-model 是否为选中状态 Boolean false
name 标识 Checkbox 名称 any -
disabled 是否禁用单选框 Boolean false
label-disabled 是否禁用单选框内容点击 Boolean false
shape 形状,可选值为 round square String round

CheckboxGroup API

参数 说明 类型 默认值
v-model 所有选中项的 name Array -
disabled 是否禁用所有单选框 Boolean false
max 设置最大可选数 Number 0(无限制)

Checkbox Event

事件名称 说明 回调参数
change 当绑定值变化时触发的事件 当前组件的值

CheckboxGroup Event

事件名称 说明 回调参数
change 当绑定值变化时触发的事件 当前组件的值

原文:

https://youzan.github.io/vant/#/zh-CN/checkbox