代码演示
基础用法
<van-checkbox v-model="checked">复选框</van-checkbox>
export default {
data() {
return {
checked: true
};
}
};
禁用状态
<van-checkbox v-model="checked" disabled>复选框</van-checkbox>
自定义颜色
自定义图标
通过 icon 插槽自定义图标,可以通过 slot-scope
判断是否为选中状态
<van-checkbox v-model="checked">
<img
slot="icon"
slot-scope="props"
:src="props.checked ? icon.active : icon.normal"
>
</van-checkbox>
export default {
data() {
checked: true,
icon: {
normal: '//img.yzcdn.cn/icon-normal.png',
active: '//img.yzcdn.cn/icon-active.png'
}
}
}
复选框组
<van-checkbox-group v-model="result">
<van-checkbox
v-for="(item, index) in list"
:key="item"
:name="item"
>
复选框 {{ item }}
</van-checkbox>
</van-checkbox-group>
设置最大可选数
<van-checkbox-group v-model="result" :max="2">
v-for="(item, index) in list"
:key="item"
:name="item"
>
复选框 {{ item }}
</van-checkbox>
</van-checkbox-group>
搭配单元格组件使用
此时你需要再引入Cell
和CellGroup
组件,并通过 checkbox 的 toggle 方法手动触发切换
<van-checkbox-group v-model="result">
<van-cell-group>
<van-cell
v-for="item in list"
clickable
:key="item"
:title="`复选框 ${item}`"
@click="toggle(index)"
>
</van-cell>
</van-cell-group>
</van-checkbox-group>
export default {
methods: {
toggle(index) {
this.$refs.checkboxes[index].toggle();
}
}
CheckboxGroup API
参数 | 说明 | 类型 | 默认值 | 版本 |
---|
v-model | 所有选中项的标识符 | Array | - | - |
disabled | 是否禁用所有单选框 | Boolean | false | - |
max | 设置最大可选数,0 为无限制 | Number | 0 | - |
CheckboxGroup Event
事件名称 | 说明 | 回调参数 |
---|
change | 当绑定值变化时触发的事件 | 当前组件的值 |
Checkbox 方法