Checkbox 复选框
布尔勾选输入,适合需要确认或从多项中选择的场景。
使用提示
- 适合:同意条款、多选设置、逐项启用/禁用。
- 不适合:即时生效的开关(应当用 switch)、互斥单选(应当用 radio-group)。
- 关联组件:switch 用于即时生效的开关,radio-group 用于互斥选项。
- 通常放在 column 中垂直排列多个选项。
- 使用 $checked 和 onchange 实现状态绑定。
checked / disabled 变体
namespace: "doc_checkbox_state_diff",
layout: {
"column:diff": {
"checkbox:checked": {
label: "已选中",
checked: true
},
"checkbox:unchecked": {
label: "未选中"
},
"checkbox:disabled-checked": {
label: "禁用且已选",
checked: true,
disabled: true
},
"checkbox:disabled": {
label: "已禁用",
disabled: true
}
}
}
}