Checkbox 复选框

复选框组件一般用于需要多个选择的场景，该组件功能完整，使用方便

平台差异说明

基本使用

• 该组件需要搭配checkboxGroup组件使用，以便用户进行操作时，获得当前复选框组的选中情况，当然，您也可以单独对某个checkbox进行事件监听
• 通过v-model给checkbox绑定一个变量，这个绑定的变量是双向的(初始值只能是true或者false)，也就是说，您可以无需监听checkbox或者checkboxGroup组件的change事件，也能知道哪个复选框 被勾选了

注意： 由于checkbox组件需要由checkboxGroup组件提供参数值，这些父子组件间通过Vue的”provide/inject”特性注入依赖， 所以您必须使用checkboxGroup包裹checkbox组件才能正常使用。

<template>
    <view class="">
        <u-checkbox-group @change="checkboxGroupChange">
            <u-checkbox 
                @change="checkboxChange" 
                v-model="item.checked" 
                v-for="(item, index) in list" :key="index" 
                :name="item.name"
            >{{item.name}}</u-checkbox>
        </u-checkbox-group>
    </view>
</template>
<script>
export default {
    data() {
        return {
            list: [
                {
                    name: 'apple',
                    checked: false,
                    disabled: false
                },
                {
                    name: 'banner',
                    checked: false,
                    disabled: false
                },
                {
                    name: 'orange',
                    checked: false,
                    disabled: false
                }
            ]
        };
    },
    methods: {
        // 选中某个复选框时，由checkbox时触发
        checkboxChange(e) {
            //console.log(e);
        },
        // 选中任一checkbox时，由checkbox-group触发
        checkboxGroupChange(e) {
            // console.log(e);
        }
    }
};
</script>

禁用checkbox

设置disabled为true，即可禁用某个组件，让用户无法点击，禁用分为两种状态，一是未勾选前禁用，这时只显示一个灰色的区域。二是已勾选后 再禁用，会有灰色的已勾选的图标，但此时依然是不可操作的。

<u-checkbox-group>
    <u-checkbox v-model="checked" :disabled="false">天涯</u-checkbox>
</u-checkbox-group>

自定义形状

可以通过设置shape为square或者circle，将复选框设置为方形或者圆形

<u-checkbox-group>
    <u-checkbox v-model="checked" shape="circle">明月</u-checkbox>
</u-checkbox-group>

自定义颜色

此处所指的颜色，为checkbox选中时的背景颜色，参数为active-color

<u-checkbox-group>
    <u-checkbox v-model="checked" active-color="red">光影</u-checkbox>
</u-checkbox-group>

文本是否可点击

设置label-disabled为false，点击文本时，无法操作checkbox

<u-checkbox-group>
    <u-checkbox v-model="checked" :label-disabled="false">剑舞</u-checkbox>
</u-checkbox-group>

API

Checkbox Props

注意：需要给checkbox组件通过v-model绑定一个布尔值，来初始化checkbox的状态，随后该值被双向绑定， 当用户勾选复选框时，该值在checkbox内部被修改为true，并反映到父组件，否则为false，换言之，您无需监听checkbox的change事件，也能 知道某一个checkbox是否被选中的状态

CheckboxGroup Props

Checkbox Event

CheckboxGroup Event