Skip to content

Checkbox 多选框

规则

基础示例

js
const rule = {
    type:"checkbox",
    title:"标签",
    field:"label",
    value:["1","2","3"],
    options:[
        {value:"1",label:"好用",disabled:true},
        {value:"2",label:"方便",disabled:false},
        {value:"3",label:"实用",disabled:false},
        {value:"4",label:"有效",disabled:false},
    ]
}

Props 配置示例

禁用状态

js
const rule = {
    type:"checkbox",
    title:"权限设置",
    field:"permissions",
    value:["1"],
    options:[
        {value:"1",label:"查看",disabled:false},
        {value:"2",label:"编辑",disabled:true},
        {value:"3",label:"删除",disabled:true},
    ],
    props: {
        disabled: false,
    },
}

Events 事件示例

监听选择变化

js
const rule = {
    type:"checkbox",
    title:"商品标签",
    field:"tags",
    value:["1"],
    options:[
        {value:"1",label:"热销"},
        {value:"2",label:"新品"},
        {value:"3",label:"推荐"},
    ],
    on: {
        change: (checkedValue) => {
            console.log('选择值改变:', checkedValue);
        },
    },
}

选择后联动更新

js
const rule = [
    {
        type:"checkbox",
        title:"商品标签",
        field:"tags",
        value:[],
        options:[
            {value:"1",label:"热销"},
            {value:"2",label:"新品"},
            {value:"3",label:"推荐"},
        ],
        inject: true,
        on: {
            change: ($inject, checkedValue) => {
                // 根据选择的标签数量,自动设置商品状态
                if (checkedValue.length >= 2) {
                    $inject.api.setValue('status', 'active');
                } else {
                    $inject.api.setValue('status', 'inactive');
                }
            },
        },
    },
    {
        type:"input",
        title:"商品状态",
        field:"status",
        props: {
            disabled: true,
        },
    },
]

完整配置项:Ant-design-vue_Checkbox

value :Array

Options

字段名说明字段类型是否必填默认值
value参数值String,Numbertrue-
label字段别名Stringtrue-
disabled设置为禁用状态Booleanfalsefalse

Props

参数说明类型默认值
disabled整组失效booleanfalse
nameCheckboxGroup 下所有 input[type="checkbox"]name 属性string-
options指定可选项,可以通过 slot="label" slot-scope="option" 定制labelstring[] | Array<{ label: string value: string disabled?: boolean, indeterminate?: boolean, onChange?: function }>[]

Events

事件名称说明回调参数
change变化时回调函数Function(checkedValue)

FormCreate 是一个开源项目,基于 MIT 许可证发布,欢迎个人和企业用户免费使用