Checkbox 多选

一组备选项中进行多选

基础用法

单独使用可以表示两种状态之间的切换，写在标签中的内容为 checkbox 按钮后的介绍。

::: demo

<template>
    <div style="display: flex; align-items: center;justify-content: space-around;padding: 16px">
        <wu-plus-checkbox label="测试4"></wu-plus-checkbox>
    </div>
</template>
<script>
</script>

:::

禁用

多选框不可用状态。

::: demo

<template>
    <div style="display: flex; align-items: center;justify-content: space-around;padding: 16px">
        <wu-plus-checkbox value="false" disabled="true" id="switchId1">测试</wu-plus-checkbox>
    </div>
</template>
<script>
</script>

:::

多选框组

适用于多个勾选框绑定到同一个数组的情景，通过是否勾选来表示这一组选项中选中的项。

::: demo

<template>
    <div style="display: flex; align-items: center;justify-content: space-around;padding: 16px">
        <wu-plus-checkbox-group value="['测试1']" id="checkoutBoxGroup">
            <wu-plus-checkbox label="测试1" style="margin-right: 8px"></wu-plus-checkbox>
            <wu-plus-checkbox label="测试2" style="margin-right: 8px"></wu-plus-checkbox>
            <wu-plus-checkbox label="测试3"></wu-plus-checkbox>
        </wu-plus-checkbox-group>
    </div>
</template>
<script>
</script>

:::

indeterminate 状态

indeterminate 属性用以表示 checkbox 的不确定状态，一般用于实现全选的效果

::: demo

<template>
    <div style="display: flex; align-items: center;justify-content: space-around;padding: 16px">
        <wu-plus-checkbox label="测试4" style="margin-right: 8px" indeterminate="true" id="indeterminate2"></wu-plus-checkbox>
        <wu-plus-checkbox-group value="['测试1']" id="checkoutBoxGroup2">
            <wu-plus-checkbox label="测试1" style="margin-right: 8px"></wu-plus-checkbox>
            <wu-plus-checkbox label="测试2" style="margin-right: 8px"></wu-plus-checkbox>
            <wu-plus-checkbox label="测试3"></wu-plus-checkbox>
        </wu-plus-checkbox-group>
    </div>
</template>
<script>
    let _groupIndex = 0
    const _groupValueList = [["测试1", "测试2"], ["测试1", "测试3"], ["测试1"], ["测试3"]]
    export default  {
        data() {
            return {
                indeterminate: false,
                value: ['测试1']
            }
        },
        mounted() {
            // 代码有些啰嗦，简单实现关联多选框选择
            const indeterminate = document.getElementById("indeterminate2");
            const checkoutBoxGroup = document.getElementById("checkoutBoxGroup2");
            indeterminate.addEventListener('change', (e) => {
                console.log(e.detail);
                if (e.detail.value) {
                    checkoutBoxGroup.setAttribute("value", ['测试1', '测试2', '测试3'])
                    indeterminate.setAttribute("indeterminate", "")
                    indeterminate.setAttribute("checked", true)
                } else {
                    indeterminate.setAttribute("indeterminate", "")
                    checkoutBoxGroup.setAttribute("value", [])
                    indeterminate.setAttribute("checked", false)
                }
            })
            checkoutBoxGroup.addEventListener("change", (e) => {
                const value = checkoutBoxGroup.getAttribute("value");
                if (value.length === 0) {
                    indeterminate.setAttribute("indeterminate", false)
                    indeterminate.setAttribute("checked", false);
                    return
                }
                if (value.length < 3) {
                    indeterminate.setAttribute("indeterminate", true)
                    return;
                }
                if (value.length === 3) {
                    indeterminate.setAttribute("indeterminate", false)
                    indeterminate.setAttribute("checked", true)
                }
                
            })
        }
    }
</script>

:::

checkbox Attributes

| 参数 | 说明 | 类型 | 可选值 | 默认值 | |---------- |-------- |---------- |------------- |-------- | | checked | 是否选中 | Boolean | true、false | -- | | disabled | 禁用 | Boolean | true、false | false | | indeterminate | 中间态 | Boolean | true、false | false | | size | 组件大小 | UISize | medium、small、mini | mini | | name | name | String | -- | -- | | label | label | String | -- | -- |

checkbox Event

| 事件名 | 说明 | 参数 | |---------- |-------- |---------- | | change | 值修改 | (event: CustomEvent) => void |

checkbox-group Attributes

| 参数 | 说明 | 类型 | 可选值 | 默认值 | |---------- |-------- |---------- |------------- |-------- | | value | 值 | Array | -- | -- | | disabled | 禁用 | Boolean | true、false | false | | size | 组件大小 | UISize | medium、small、mini | mini |

checkbox-group Event

| 事件名 | 说明 | 参数 | |---------- |-------- |---------- | | change | 值修改 | (event: CustomEvent) => void |