@sl-material/sl-import 1.0.0-beta10 → 1.0.0-beta11

package/README.md

@@ -329,74 +329,41 @@ ImportDialog.open({
     autoUpload: false,
     customUpload: async (file, context) => {
       // 如果文件数量超过限制，删除第一个文件
-      if (context.fileList.length > 5) {
-        context.removeFile(0);
-        console.log("已删除第一个文件");
-      }
-
-      // 正常上传逻辑（可选择是否使用进度回调）
-      const formData = new FormData();
-      formData.append("file", file);
-
-      const response = await fetch("/api/upload", {
-        method: "POST",
-        body: formData,
-      });
-
-      return response.json();
+      console.info("file", file, "context", context);
+      return {
+        file,
+      };
     },
   },
-});
-```
-
-### 不使用进度回调的简化写法
-
-```typescript
-ImportDialog.open({
-  title: "导入数据",
-  templateType: TemplateTypeEnum.BASE,
-  uploadConfig: {
-    autoUpload: false,
-    customUpload: async (file, context, _onProgress) => {
-      // 检查当前文件列表
-      console.log("当前文件列表:", context.fileList);
-
-      // 如果文件数量超过限制，删除第一个文件
-      if (context.fileList.length > 5) {
-        context.removeFile(0);
-      }
-
-      // 简单上传，不处理进度
-      const formData = new FormData();
-      formData.append("file", file);
-
-      const response = await fetch("/api/upload", {
-        method: "POST",
-        body: formData,
-      });
-
-      return response.json();
-    },
+  onConfirm: async (data) => {
+    // 此时文件已上传完成，data.files 包含上传结果
+    console.log("上传结果:", data);
+    return { success: true };
   },
 });
 ```
 
-### 延迟上传（点击确定时上传）
+### 多文件上传
 
 ```typescript
 ImportDialog.open({
   title: "导入数据",
   templateType: TemplateTypeEnum.BASE,
   uploadConfig: {
+    multiple: true,
     autoUpload: false, // 默认值，点击确定时上传
     confirmLoading: true, // 显示确定按钮 loading（默认）
     customUpload: async (file, onProgress) => {
-      // 上传逻辑
+      // 如果文件数量超过限制，删除第一个文件
+      if (context.fileList.length > 5) {
+        context.removeFile(0);
+      }
+      return { file };
     },
   },
   onConfirm: async (data) => {
     // 此时文件已上传完成，data.files 包含上传结果
-    console.log("上传结果:", data.files);
+    console.log("上传结果:", data);
     return { success: true };
   },
 });
@@ -429,7 +396,7 @@ ImportDialog.open({
   title: "大文件上传",
   templateType: TemplateTypeEnum.BASE,
   uploadConfig: {
-    autoUpload: true,
+    autoUpload: false,
     maxFileSize: 500 * 1024 * 1024, // 500MB
     chunkedUpload: {
       initUpload: async (params) => {
@@ -458,59 +425,6 @@ ImportDialog.open({
 });
 ```
 
-### 分片上传（延迟上传）
-
-```typescript
-ImportDialog.open({
-  title: "大文件上传",
-  templateType: TemplateTypeEnum.BASE,
-  uploadConfig: {
-    autoUpload: false, // 延迟上传
-    maxFileSize: 500 * 1024 * 1024,
-    chunkedUpload: {
-      // 分片上传配置同上
-    },
-  },
-  onConfirm: async (data) => {
-    // 点击确定时执行分片上传，data.files 包含合并后的结果
-    console.log("分片上传完成:", data.files);
-    return { success: true };
-  },
-});
-```
-
-### 多文件上传
-
-```typescript
-ImportDialog.open({
-  title: "批量上传文件",
-  templateType: TemplateTypeEnum.BASE,
-  uploadConfig: {
-    multiple: true,
-    maxFiles: 20,
-    autoUpload: true,
-    customUpload: async (file, onProgress) => {
-      // 自定义上传逻辑
-      const formData = new FormData();
-      formData.append("file", file);
-
-      const xhr = new XMLHttpRequest();
-      xhr.upload.addEventListener("progress", (e) => {
-        if (e.lengthComputable) {
-          onProgress?.(Math.round((e.loaded / e.total) * 100));
-        }
-      });
-
-      xhr.open("POST", "/api/upload");
-      await xhr.send(formData);
-    },
-  },
-  onUploadProgress: (file, progress) => {
-    console.log(`${file.name}: ${progress}%`);
-  },
-});
-```
-
 ### 带品牌选择的导入
 
 ```typescript

package/index.d.ts

@@ -437,7 +437,17 @@ export declare interface UploadConfig {
     multiple?: boolean;
     /** 单文件最大大小（字节），默认 100MB */
     maxFileSize?: number;
-    /** 自定义上传函数（普通上传时使用）主要用于自定义上传参数 */
+    /**
+     * 文件预处理函数
+     * 在选择文件后立即调用，用于：
+     * - 二次加工上传参数
+     * - 自定义校验逻辑
+     * - 预上传处理（如获取签名URL等）
+     *
+     * @param file 原始文件
+     * @param context 上下文信息
+     * @returns 返回值会存储在 fileItem.response 中，点击确定时可获取
+     */
     customUpload?: (file: File, context?: {
         /** 当前文件列表 */
         fileList: FileUploadItem[];
@@ -450,10 +460,9 @@ export declare interface UploadConfig {
      */
     chunkedUpload?: ChunkedUploadConfig;
     /**
-     * 上传时机控制
-     * - true: 选择文件后立即上传（默认）
-     * - false: 点击确定时才开始上传
-     * 适用于 customUpload 和 chunkedUpload
+     * 断点续传控制（仅分片上传时生效）
+     * - true: 启用断点续传，自动恢复未完成的上传
+     * - false: 不启用断点续传（默认）
      */
     autoUpload?: boolean;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sl-material/sl-import",
-  "version": "1.0.0-beta10",
+  "version": "1.0.0-beta11",
   "description": "导入组件 - 支持批量导入文件，提供多种模板配置",
   "main": "./sl-import.cjs.js",
   "module": "./sl-import.es.js",