From fdeb869c386da95150a087bc22bcebc4e57d0f76 Mon Sep 17 00:00:00 2001
From: Tevin <tingquanren@163.com>
Date: Tue, 18 Mar 2025 18:16:32 +0800
Subject: [PATCH] 更新所有表单组件文档和头注释
---
_cursor.ai/forms.doc/checkbox.doc/CCheckBox.doc.md | 15 ++++++++++-----
1 files changed, 10 insertions(+), 5 deletions(-)
diff --git a/_cursor.ai/forms.doc/checkbox.doc/CCheckBox.doc.md b/_cursor.ai/forms.doc/checkbox.doc/CCheckBox.doc.md
index 1998ff2..dc8dac3 100644
--- a/_cursor.ai/forms.doc/checkbox.doc/CCheckBox.doc.md
+++ b/_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. 组件会自动根据表单值显示已选项的文本，多个选项时用逗号分隔
\ No newline at end of file
+6. 组件会自动根据表单值显示已选项的文本，多个选项时用逗号分隔
+7. 使用单选模式时，确保传入的表单值如果为单个值而非数组，否则可能导致显示异常
\ No newline at end of file
--
Gitblit v1.9.1