Checkbox 复选框
使用指南
import { Checkbox, CheckboxGroup } from 'vant';
Vue.use(Checkbox).use(CheckboxGroup);
代码演示
基础用法
通过v-model
绑定 checkbox 的勾选状态
<van-checkbox v-model="checked">复选框</van-checkbox>
export default {
data() {
return {
checked: true
};
}
};
禁用状态
<van-checkbox v-model="checked" disabled>复选框</van-checkbox>
禁用内容部分点击事件
<van-checkbox v-model="checked" label-disabled>复选框</van-checkbox>
Checkbox 组
需要与van-checkbox-group
一起使用,选中值是一个数组,通过v-model
绑定在van-checkbox-group
上,数组中的项即为选中的Checkbox
的name
属性设置的值
<van-checkbox-group v-model="result">
<van-checkbox
v-for="(item, index) in list"
:key="item"
:name="item"
>
复选框 {{ item }}
</van-checkbox>
</van-checkbox-group>
export default {
data() {
return {
list: ['a', 'b', 'c'],
result: ['a', 'b']
};
}
};
设置最大可选数
<van-checkbox-group v-model="result" :max="2">
<van-checkbox
v-for="(item, index) in list"
:key="item"
:name="item"
>
复选框 {{ item }}
</van-checkbox>
</van-checkbox-group>
与 Cell 组件一起使用
此时你需要再引入Cell
和CellGroup
组件
<van-checkbox-group v-model="result">
<van-cell-group>
<van-cell v-for="item in list" :title="`复选框 - {item}`" :key="item">
<van-checkbox :name="item" />
</van-cell>
</van-cell-group>
</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 | 当绑定值变化时触发的事件 | 当前组件的值 |
原文: