From 5f7ff5708006d60da6e049ede307d7fd3b4026c7 Mon Sep 17 00:00:00 2001
From: zjl <xx@qq.com>
Date: Mon, 23 Dec 2024 09:34:50 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96=E5=8D=95=E5=9B=BE=E4=B8=8A?=
 =?UTF-8?q?=E4=BC=A0=E3=80=81=E5=A4=9A=E5=9B=BE=E4=B8=8A=E4=BC=A0=E3=80=81?=
 =?UTF-8?q?=E6=96=87=E4=BB=B6=E4=B8=8A=E4=BC=A0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/api/common/index.ts          | 13 ++++++++--
 src/components/Upload/Image.vue  | 21 +++++++++++++---
 src/components/Upload/Images.vue | 43 +++++++++++++++++++++++++++++---
 src/components/Upload/file.vue   | 25 ++++++++++++++++---
 4 files changed, 89 insertions(+), 13 deletions(-)

diff --git a/src/api/common/index.ts b/src/api/common/index.ts
index 3b289a6..a3edc27 100644
--- a/src/api/common/index.ts
+++ b/src/api/common/index.ts
@@ -1,6 +1,10 @@
 import { http } from '@/utils/http/axios';
 
-//图片上传
+/**
+ * 本地文件上传
+ * @param data 参数
+ * @returns 返回结果
+ */
 export function upload(data) {
   return http.request({
     url: '/upload/uploadFile',
@@ -11,7 +15,12 @@ export function upload(data) {
     },
   });
 }
-// oss
+
+/**
+ * 获取OSS账号
+ * @param params 参数
+ * @returns 返回结果
+ */
 export function getOssConfig(params?) {
   return http.request({
     url: '/config/item/getItemList/config_oss',
diff --git a/src/components/Upload/Image.vue b/src/components/Upload/Image.vue
index 8e7d8cc..c9c0519 100644
--- a/src/components/Upload/Image.vue
+++ b/src/components/Upload/Image.vue
@@ -112,13 +112,17 @@
     (e: 'changeFileName', value: string): void;
   }
 
-  const fileName = ref('');
-  const oImg = ref('');
+  /**
+   * 定义参数
+   */
   const emit = defineEmits<UploadEmits>();
   const loading = ref(false);
   const progress = ref(0);
 
-  //接口上传
+  /**
+   * 本地接口上传
+   * @param fileChild 文件
+   */
   const actionFile = async (fileChild: any) => {
     loading.value = true;
     try {
@@ -137,7 +141,11 @@
       loading.value = false;
     }
   };
-  //oss上传
+
+  /**
+   * 阿里云OSS上传
+   * @param fileChild 文件
+   */
   const actionFiles = async (fileChild: any) => {
     console.log(fileChild);
     const configData = await getOssConfig();
@@ -202,6 +210,11 @@
       loading.value = false;
     }
   };
+
+  /**
+   * 执行文件上传
+   * @param options 参数
+   */
   const handleHttpUpload = async (options) => {
     handleHttpUploadOptions.value = options;
     actionFile(options.file.file);
diff --git a/src/components/Upload/Images.vue b/src/components/Upload/Images.vue
index 33e9bc3..023de3b 100644
--- a/src/components/Upload/Images.vue
+++ b/src/components/Upload/Images.vue
@@ -54,7 +54,9 @@
   const uploadRef = ref();
   import { upload, getOssConfig } from '@/api/common';
 
-  // 接受父组件参数
+  /**
+   * 接受父组件参数
+   */
   const props = defineProps({
     zIndex: {
       default: -1,
@@ -120,12 +122,19 @@
       emit('update:modelValue', fileList.value);
     },
   });
-  let editIndex = '';
 
+  /**
+   * 定义参数
+   */
+  let editIndex = '';
   const emit = defineEmits(['upload']);
   const progress = ref(0);
   const loading = ref(false);
-  //接口上传
+
+  /**
+   * 本地接口上传
+   * @param options 参数
+   */
   const handleHttpUpload = async (options) => {
     loading.value = true;
     try {
@@ -173,7 +182,11 @@
       loading.value = false;
     }
   };
-  //oss上传
+
+  /**
+   * 阿里云OSS上传
+   * @param options 参数
+   */
   const handleHttpUploads = async (options: UploadRequestOptions) => {
     console.log(options);
     const configData = await getOssConfig();
@@ -263,18 +276,37 @@
       loading.value = false;
     }
   };
+
+  /**
+   * 执行文件上传
+   * @param data 参数
+   */
   const handleUploadChange = (data: { fileList: UploadFileInfo[] }) => {
     handleHttpUpload(data);
   };
+
+  /**
+   * 文件预览
+   * @param index 参数
+   */
   const onPreview = (index: any) => {
     window.open(fileList.value[index].filePath);
   };
 
+  /**
+   * 执行编辑
+   * @param index 参数
+   */
   const handleEdit = (index: any) => {
     editIndex = index;
     const dom = document.querySelector(`#${uuid.value} .n-upload-file-input`);
     dom && dom.dispatchEvent(new MouseEvent('click'));
   };
+
+  /**
+   * 执行删除
+   * @param index 参数
+   */
   const handleRemove = (index: any) => {
     editIndex = index;
     if (props.multiple) {
@@ -289,6 +321,9 @@
     }
   };
 
+  /**
+   * 最大上传张数限制
+   */
   const onExceed = () => {
     if (props.limit) {
       notification.warning({
diff --git a/src/components/Upload/file.vue b/src/components/Upload/file.vue
index 18f950a..7094a2e 100644
--- a/src/components/Upload/file.vue
+++ b/src/components/Upload/file.vue
@@ -69,7 +69,9 @@
   const uploadRef = ref();
   import { upload, getOssConfig } from '@/api/common';
 
-  // 接受父组件参数
+  /**
+   * 接受父组件参数
+   */
   const props = defineProps({
     zIndex: {
       default: -1,
@@ -147,7 +149,11 @@
   const emit = defineEmits(['upload']);
 
   const loading = ref(false);
-  //接口上传
+
+  /**
+   * 接口上传
+   * @param options 参数
+   */
   const handleHttpUpload = async (options) => {
     if (!props.autoUpload) {
       emit('upload', options);
@@ -188,7 +194,11 @@
       loading.value = false;
     }
   };
-  //oss上传
+
+  /**
+   * 阿里云OSS上传
+   * @param options 参数
+   */
   const handleHttpUploads = async (options: UploadRequestOptions) => {
     console.log(options);
     if (!props.autoUpload) {
@@ -267,12 +277,21 @@
       loading.value = false;
     }
   };
+
+  /**
+   * 执行文件上传
+   * @param data 参数
+   */
   const handleUploadChange = (data: { fileList: UploadFileInfo[] }) => {
     if (!delFlag.value) {
       handleHttpUpload(data);
     }
   };
 
+  /**
+   * 执行删除
+   * @param file 参数
+   */
   const handleRemove = (file: any) => {
     delFlag.value = true;
     if (props.multiple) {