WebApp【公共组件库】@前端(For Git Submodule)
Tevin
2025-03-18 fdeb869c386da95150a087bc22bcebc4e57d0f76
_cursor.ai/forms.doc/checkbox.doc/CCheckBox.doc.md
@@ -14,8 +14,12 @@
- `itemRes` (Object,必填):表单数据资源对象,表单组件内部机制专用
- `options` (Array,可选):选项列表,每个选项应包含 label 和 value 属性,默认为空数组
- `boxType` (String,可选):勾选类型,可选值有 checkbox(多选)、radio(单选),默认为 checkbox
- `displayType` (String,可选):显示模式,可选值有 plane(直接显示)、dialog(弹窗选择),默认为 plane
- `boxType` (String,可选):勾选类型,默认为 checkbox
    - `checkbox`:多选模式
    - `radio`:单选模式
- `displayType` (String,可选):显示模式,默认为 plane
    - `plane`:直接显示模式
    - `dialog`:弹窗选择模式
- `placeholder` (String,可选):输入框占位提示文本
## 使用示例
@@ -121,12 +125,13 @@
## 注意事项
1. 组件支持两种选择类型:
   - `checkbox`:多选模式,可以选择多个选项,表单值为数组
   - `radio`:单选模式,只能选择一个选项,表单值为单个值
    - `checkbox`:多选模式,可以选择多个选项,表单值为数组
    - `radio`:单选模式,只能选择一个选项,表单值为单个值
2. 组件支持两种显示模式:
   - `plane`:直接显示模式,选项直接显示在表单项下方
   - `dialog`:弹窗选择模式,点击表单项后弹出选择弹窗
3. 当选项较多时,建议使用弹窗选择模式(`displayType="dialog"`)
4. 在多选模式下,表单值为选中项的 value 值组成的数组
5. 在单选模式下,表单值为选中项的 value 值
6. 组件会自动根据表单值显示已选项的文本,多个选项时用逗号分隔
6. 组件会自动根据表单值显示已选项的文本,多个选项时用逗号分隔
7. 使用单选模式时,确保传入的表单值如果为单个值而非数组,否则可能导致显示异常