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] 更新所有表单组件文档和头注释

---
 forms/imagePicker/CImagePicker.vue |   62 +++++++++++++++++++++++-------
 1 files changed, 47 insertions(+), 15 deletions(-)

diff --git a/forms/imagePicker/CImagePicker.vue b/forms/imagePicker/CImagePicker.vue
index 33de729..cdc08dc 100644
--- a/forms/imagePicker/CImagePicker.vue
+++ b/forms/imagePicker/CImagePicker.vue
@@ -1,5 +1,8 @@
 /**
  * CImagePicker
+ * 图片选择器组件，用于在表单中上传和管理图片
+ * 支持单张和多张图片上传，并提供压缩、预览等功能
+ * 可限制上传图片的数量和来源（相册/相机）
  * @author Tevin
  */
 
@@ -15,14 +18,15 @@
         <AtImagePicker
             ref="picker"
             mode="aspectFit"
+            :sourceType="sourceType"
             :multiple="count > 1"
             :count="count"
             :showAddBtn="!selectedFull"
             :length="3"
             :files="files"
-            :onChange="(files,operationType,index)=>handleChange(files,operationType,index)"
-            :onFail="evt=>handleFail(evt)"
-            :onImageClick="(index, file)=>handleImgView(index,file)"
+            :onChange="(files,operationType,index) => handleChange(files,operationType,index)"
+            :onFail="evt => handleFail(evt)"
+            :onImageClick="(index, file) => handleImgView(index,file)"
         />
         <CImageCompressor ref="compressor" />
         <CImagePreview ref="imgPreview" />
@@ -57,10 +61,20 @@
             type: Number,
             default: 1,
         },
+        // 图片来源
+        sourceType: {
+            type: Array,
+            default: () => ['album', 'camera'],
+        },
         // 上传图片参数
         params: {
             type: Object,
             default: () => {},
+        },
+        // 是否开启缩略图
+        needThumb: {
+            type: Boolean,
+            default: false,
         },
     },
     data() {
@@ -104,7 +118,7 @@
                     if (file.file && file.file.originalFileObj) {
                         if (
                             /image\/(gif|png|jpg|jpeg)/.test(
-                                file.file.originalFileObj.type
+                                file.file.originalFileObj.type,
                             )
                         ) {
                             return true;
@@ -127,8 +141,13 @@
                 const needs = nextFiles
                     .map((file, needIndex) => {
                         const fileInfo = file.file;
-                        // 没有 file 信息对象，或者不是 blob 类型
-                        if (!fileInfo || fileInfo.path.indexOf('blob') < 0) {
+                        // 没有 file 信息对象，或者不是 blob、wxfile、tmp 类型
+                        if (
+                            !fileInfo ||
+                            (fileInfo.path.indexOf('blob') < 0 &&
+                                fileInfo.path.indexOf('wxfile') < 0 &&
+                                fileInfo.path.indexOf('http://tmp/') < 0)
+                        ) {
                             return false;
                         }
                         // 尺寸小于 1M 的图片
@@ -207,7 +226,10 @@
                         callback(state, res);
                     }
                 },
-                this.params
+                $fetchCommon.transKeyName('underline', {
+                    ...this.params,
+                    needThumb: this.needThumb ? 1 : 0,
+                }),
             );
         },
     },
@@ -227,7 +249,7 @@
 // 图片上传节流
 const _readyUpload = {};
 
-export const uploadImage = (files, callback, params) => {
+export const uploadImage = (files, callback, formData = {}) => {
     if (!files || files.length === 0) {
         callback('success', []);
         return;
@@ -271,18 +293,28 @@
                         ...requestFile,
                         header,
                         name: 'file',
-                        formData: { ...params },
+                        formData,
                         timeout: 30 * 1000,
                         success(res) {
-                            const res2 =
-                                typeof res.data === 'string'
-                                    ? JSON.parse(res.data)
-                                    : res.data;
+                            let res2;
+                            try {
+                                res2 =
+                                    typeof res.data === 'string'
+                                        ? JSON.parse(res.data)
+                                        : res.data;
+                            } catch (err) {
+                                reject({
+                                    ...requestFile,
+                                    response: res,
+                                    message: '上传图片异常！',
+                                });
+                                return;
+                            }
                             // 上传成功
                             if (res2.state.code === 2000) {
                                 const imgUrl = $fetchCommon.transImgPath(
                                     'fix',
-                                    res2.data.src || res2.data.file || res2.data.url
+                                    res2.data.src || res2.data.file || res2.data.url,
                                 );
                                 _readyUpload[file.url] = imgUrl;
                                 resolve(imgUrl);
@@ -309,7 +341,7 @@
                             });
                         },
                     });
-                })
+                }),
             );
         }
         // 其他类型视为 url，忽略

--
Gitblit v1.9.1