Checkbox
基本用法
最简单的用法是直接渲染
CdCheckbox。你可以通过 checked 控制选中状态,通过 disabled 禁用交互。注意:HTML 原生并没有
readonly 的多选框语义;这里的 readonly 是组件层的约定,用于“展示为可读但不允许修改”。Not Checked Style:
Checked Style:
Edit Code
受控用法
通过
checked(以及对应的 onChange)可以将状态交给外部维护,适用于表单联动、批量操作等场景。Edit Code
多选框 Group
将多个
CdCheckbox 放入 Checkbox.Group 中即可形成多选框组。defaultValue 用于非受控默认值;value + onChange 用于受控模式。Edit Code
半选 / 全选
通过
indeterminate 可展示“部分选中”的视觉状态,常用于“全选 / 反选”场景。建议:当选中项数量为 0 时取消半选;当选中项数量等于总数时取消半选并设置全选;其余情况设置半选。
Edit Code