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,Number | true | - |
| label | 字段别名 | String | true | - |
| disabled | 设置为禁用状态 | Boolean | false | false |
Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| disabled | 整组失效 | boolean | false |
| name | CheckboxGroup 下所有 input[type="checkbox"] 的 name 属性 | string | - |
| options | 指定可选项,可以通过 slot="label" slot-scope="option" 定制label | string[] | Array<{ label: string value: string disabled?: boolean, indeterminate?: boolean, onChange?: function }> | [] |
Events
| 事件名称 | 说明 | 回调参数 |
|---|---|---|
| change | 变化时回调函数 | Function(checkedValue) |


