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:"tags",
value:["1"],
options:[
{value:"1",label:"热销"},
{value:"2",label:"新品"},
{value:"3",label:"推荐"},
],
props: {
direction: "vertical",
}
}禁用状态
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: (value) => {
console.log('选择值改变:', value);
},
},
}选择后联动更新
js
const rule = [
{
type:"checkbox",
title:"商品标签",
field:"tags",
value:[],
options:[
{value:"1",label:"热销"},
{value:"2",label:"新品"},
{value:"3",label:"推荐"},
],
inject: true,
on: {
change: ($inject, value) => {
// 根据选择的标签数量,自动设置商品状态
if (value.length >= 2) {
$inject.api.setValue('status', 'active');
} else {
$inject.api.setValue('status', 'inactive');
}
},
},
},
{
type:"input",
title:"商品状态",
field:"status",
props: {
disabled: true,
},
},
]完整配置项:arco-design_Checkbox
value :Array
Options
| 字段名 | 说明 | 字段类型 | 是否必填 | 默认值 |
|---|---|---|---|---|
| value | 参数值 | String,Number | true | - |
| label | 字段别名 | String | true | - |
| disabled | 设置为禁用状态 | Boolean | false | false |
Props
| 参数名 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| default-value | 默认值(非受控状态) | Array<string | number | boolean> | [] |
| direction | 复选框的排列方向 | Direction | 'horizontal' |
| disabled | 是否禁用 | boolean | false |
Events
| 事件名 | 描述 | 参数 |
|---|---|---|
| change | 值改变时触发 | value: Array<string | number | boolean> |


