@koi-br/ocr-web-sdk 1.0.39 → 1.0.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koi-br/ocr-web-sdk",
-  "version": "1.0.39",
+  "version": "1.0.41",
   "description": "一个支持多种Office文件格式预览的Vue3组件SDK，包括PDF、Word、Excel、图片、OFD、TIF等格式",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",

package/preview/ImagePreview.vue

@@ -120,6 +120,13 @@
       <div v-if="isCalculatingAutoFit && autoFitWidth" class="auto-fit-loading">
         <div class="loading-spinner"></div>
         <div class="loading-text">加载中...</div>
+        <!-- 调试信息（开发环境显示） -->
+        <div style="font-size: 12px; color: #999; margin-top: 8px; text-align: center;">
+          isImageReady: {{ isImageReady }}, 
+          isCalculatingAutoFit: {{ isCalculatingAutoFit }}, 
+          autoFitWidth: {{ autoFitWidth }},
+          scale: {{ scale }}
+        </div>
       </div>
       
       <div 
@@ -407,13 +414,24 @@ const isImageReady = ref(false); // 标记图片是否已准备好显示（自
 watch(
   () => imageUrls.value,
   (newUrls, oldUrls) => {
+    console.log('[ImagePreview] imageUrls changed:', {
+      newUrls: newUrls?.length,
+      oldUrls: oldUrls?.length,
+      autoFitWidth: props.autoFitWidth,
+      isImageReady: isImageReady.value,
+      isCalculatingAutoFit: isCalculatingAutoFit.value,
+    });
+    
     // 如果有新的图片URL，且启用自适应宽度，立即隐藏图片
     if (newUrls && newUrls.length > 0 && props.autoFitWidth) {
+      console.log('[ImagePreview] 设置图片隐藏，等待自适应宽度计算');
       isImageReady.value = false;
       isCalculatingAutoFit.value = true;
     } else if (!props.autoFitWidth) {
       // 如果没有启用自适应宽度，立即显示
+      console.log('[ImagePreview] 未启用自适应宽度，立即显示图片');
       isImageReady.value = true;
+      isCalculatingAutoFit.value = false;
     }
   },
   { immediate: true }
@@ -426,7 +444,10 @@ const isScrollPaging = ref(false); // 标记是否正在进行滚动翻页
 
 // ResizeObserver 相关
 let resizeObserver: ResizeObserver | null = null;
-let resizeTimer: any = null; // 防抖定时器
+let resizeTimer: any = null; // handleContainerResize 内部的定时器
+let resizeDebounceTimer: any = null; // ResizeObserver 的防抖定时器
+let isResizing = false; // 标记是否正在处理 resize
+let lastContainerWidth = 0; // 记录上次容器宽度，用于判断是否真的变化了
 
 // 图片和容器引用
 const containerRef = ref<HTMLElement>();
@@ -916,13 +937,25 @@ const original = () => {
 
 // 计算自适应宽度的缩放比例
 const calculateAutoFitScale = () => {
+  console.log('[ImagePreview] calculateAutoFitScale 开始:', {
+    autoFitWidth: props.autoFitWidth,
+    hasContainerRef: !!containerRef.value,
+    containerRect: containerRef.value?.getBoundingClientRect(),
+    firstPageSize: imageSizes.get(1),
+    rotation: rotation.value,
+    minScale: props.minScale,
+    maxScale: props.maxScale,
+  });
+  
   if (!props.autoFitWidth || !containerRef.value) {
+    console.log('[ImagePreview] calculateAutoFitScale 返回 1 (条件不满足)');
     return 1;
   }
 
   // 使用第一页的图片尺寸作为基准（所有页面使用相同的缩放比例）
   const firstPageSize = imageSizes.get(1);
   if (!firstPageSize || firstPageSize.width === 0) {
+    console.log('[ImagePreview] calculateAutoFitScale 返回 1 (第一页尺寸无效)', firstPageSize);
     return 1;
   }
 
@@ -932,6 +965,7 @@ const calculateAutoFitScale = () => {
   const containerWidth = containerRect.width - 4;
 
   if (containerWidth <= 0) {
+    console.log('[ImagePreview] calculateAutoFitScale 返回 1 (容器宽度无效)', containerWidth);
     return 1;
   }
 
@@ -942,20 +976,38 @@ const calculateAutoFitScale = () => {
   const imageWidth = isRotated ? firstPageSize.height : firstPageSize.width;
 
   if (imageWidth <= 0) {
+    console.log('[ImagePreview] calculateAutoFitScale 返回 1 (图片宽度无效)', imageWidth);
     return 1;
   }
 
   // 计算缩放比例，使图片宽度完全适应容器宽度
   const calculatedScale = containerWidth / imageWidth;
+  const finalScale = Math.max(props.minScale, Math.min(props.maxScale, calculatedScale));
+  
+  console.log('[ImagePreview] calculateAutoFitScale 计算结果:', {
+    containerWidth,
+    imageWidth,
+    calculatedScale,
+    finalScale,
+  });
 
   // 确保缩放比例在允许的范围内
-  return Math.max(props.minScale, Math.min(props.maxScale, calculatedScale));
+  return finalScale;
 };
 
 // 图片加载完成处理
 const onImageLoad = (event: Event, pageNum: number) => {
   const img = event.target as HTMLImageElement;
   
+  console.log('[ImagePreview] 图片加载完成:', {
+    pageNum,
+    naturalWidth: img.naturalWidth,
+    naturalHeight: img.naturalHeight,
+    autoFitWidth: props.autoFitWidth,
+    isImageReady: isImageReady.value,
+    isCalculatingAutoFit: isCalculatingAutoFit.value,
+  });
+  
   // 存储该页的图片尺寸
   imageSizes.set(pageNum, {
     width: img.naturalWidth,
@@ -964,6 +1016,7 @@ const onImageLoad = (event: Event, pageNum: number) => {
 
   // 如果是第一页且启用自适应宽度，计算并设置初始缩放比例
   if (pageNum === 1 && props.autoFitWidth) {
+    console.log('[ImagePreview] 第一页加载完成，开始计算自适应宽度');
     // 重置用户缩放标记
     isUserZooming.value = false;
     
@@ -985,21 +1038,38 @@ const onImageLoad = (event: Event, pageNum: number) => {
         // 添加小延迟确保容器完全渲染
         setTimeout(() => {
           try {
+            console.log('[ImagePreview] onImageLoad: 开始计算自适应宽度...');
             const autoScale = calculateAutoFitScale();
+            console.log('[ImagePreview] onImageLoad: 自适应宽度计算结果:', {
+              autoScale,
+              containerRef: !!containerRef.value,
+              containerWidth: containerRef.value?.getBoundingClientRect()?.width,
+              firstPageSize: imageSizes.get(1),
+            });
+            
             if (autoScale > 0) {
               scale.value = autoScale;
               initialAutoFitScale.value = autoScale; // 记录初始自适应缩放比例
+              // 记录当前容器宽度，用于后续 resize 检查
+              if (containerRef.value) {
+                lastContainerWidth = containerRef.value.getBoundingClientRect().width;
+              }
+              console.log('[ImagePreview] onImageLoad: 缩放比例已设置:', autoScale);
+            } else {
+              console.warn('[ImagePreview] onImageLoad: 计算出的缩放比例无效:', autoScale);
             }
           } catch (error) {
-            console.warn('计算自适应宽度失败:', error);
+            console.error('[ImagePreview] onImageLoad: 计算自适应宽度失败:', error);
           } finally {
             // 清除超时保护
             clearTimeout(timeoutId);
+            console.log('[ImagePreview] onImageLoad: 更新状态: isCalculatingAutoFit = false, isImageReady = true');
             // 无论计算结果如何，都要更新状态，避免一直显示 loading
             isCalculatingAutoFit.value = false;
             // 使用 requestAnimationFrame 确保在下一帧显示，避免闪烁
             requestAnimationFrame(() => {
               isImageReady.value = true;
+              console.log('[ImagePreview] onImageLoad: 图片已准备好显示');
             });
           }
         }, 100); // 增加延迟，确保所有图片都已加载
@@ -2321,6 +2391,33 @@ const handleContainerResize = () => {
     return;
   }
 
+  // 如果正在计算中或正在处理 resize，跳过（避免重复计算）
+  if (isCalculatingAutoFit.value || isResizing) {
+    return;
+  }
+
+  // 检查容器尺寸是否真的变化了（避免无意义的重复计算）
+  if (containerRef.value) {
+    const currentWidth = containerRef.value.getBoundingClientRect().width;
+    // 如果宽度变化小于 5px，认为是渲染抖动，不处理
+    if (Math.abs(currentWidth - lastContainerWidth) < 5) {
+      return;
+    }
+    lastContainerWidth = currentWidth;
+  }
+
+  console.log('[ImagePreview] handleContainerResize 被调用:', {
+    autoFitWidth: props.autoFitWidth,
+    isUserZooming: isUserZooming.value,
+    isImageReady: isImageReady.value,
+    isCalculatingAutoFit: isCalculatingAutoFit.value,
+    hasFirstPageSize: !!imageSizes.get(1),
+    containerWidth: containerRef.value?.getBoundingClientRect()?.width,
+  });
+
+  // 标记正在处理 resize
+  isResizing = true;
+
   // 清除之前的定时器
   if (resizeTimer) {
     clearTimeout(resizeTimer);
@@ -2328,31 +2425,46 @@ const handleContainerResize = () => {
   }
 
   // 隐藏图片，显示 loading
+  console.log('[ImagePreview] handleContainerResize: 开始重新计算');
   isImageReady.value = false;
   isCalculatingAutoFit.value = true;
 
   // 立即计算并应用新的缩放比例，避免过渡期间露出底色
   // 使用 requestAnimationFrame 确保在浏览器重绘前更新
   requestAnimationFrame(() => {
-    const newScale = calculateAutoFitScale();
-    if (newScale > 0) {
-      // 即使变化很小也立即更新，确保过渡期间图片始终填满容器
-      scale.value = newScale;
-      initialAutoFitScale.value = newScale;
+    try {
+      console.log('[ImagePreview] handleContainerResize: 开始计算自适应宽度...');
+      const newScale = calculateAutoFitScale();
+      console.log('[ImagePreview] handleContainerResize: 计算结果:', newScale);
+      
+      if (newScale > 0) {
+        // 即使变化很小也立即更新，确保过渡期间图片始终填满容器
+        scale.value = newScale;
+        initialAutoFitScale.value = newScale;
+      }
+    } catch (error) {
+      console.error('[ImagePreview] handleContainerResize: 计算失败:', error);
     }
 
     // 在过渡动画完成后再次检查，确保最终状态正确（处理过渡动画期间的连续变化）
     resizeTimer = setTimeout(() => {
-      const finalScale = calculateAutoFitScale();
-      if (finalScale > 0 && Math.abs(finalScale - scale.value) > 0.01) {
-        scale.value = finalScale;
-        initialAutoFitScale.value = finalScale;
+      try {
+        const finalScale = calculateAutoFitScale();
+        if (finalScale > 0 && Math.abs(finalScale - scale.value) > 0.01) {
+          scale.value = finalScale;
+          initialAutoFitScale.value = finalScale;
+        }
+      } catch (error) {
+        console.error('[ImagePreview] handleContainerResize: 最终计算失败:', error);
+      } finally {
+        // 计算完成后，显示图片并隐藏 loading
+        console.log('[ImagePreview] handleContainerResize: 更新状态完成');
+        isCalculatingAutoFit.value = false;
+        isResizing = false; // 重置标记
+        requestAnimationFrame(() => {
+          isImageReady.value = true;
+        });
       }
-      // 计算完成后，显示图片并隐藏 loading
-      isCalculatingAutoFit.value = false;
-      requestAnimationFrame(() => {
-        isImageReady.value = true;
-      });
     }, 350); // 350ms 延迟，略大于过渡动画时间（300ms），确保过渡完成后稳定
   });
 };
@@ -2410,11 +2522,17 @@ onMounted(() => {
   nextTick(() => {
     if (containerRef.value && typeof ResizeObserver !== 'undefined') {
       resizeObserver = new ResizeObserver((entries) => {
-        // 使用 entries 参数立即获取新尺寸，避免延迟
-        for (const entry of entries) {
-          // 立即响应尺寸变化，避免过渡期间露出底色
-          handleContainerResize();
+        // 使用防抖，避免频繁触发
+        if (resizeDebounceTimer) {
+          clearTimeout(resizeDebounceTimer);
         }
+        resizeDebounceTimer = setTimeout(() => {
+          // 使用 entries 参数立即获取新尺寸，避免延迟
+          for (const entry of entries) {
+            // 立即响应尺寸变化，避免过渡期间露出底色
+            handleContainerResize();
+          }
+        }, 100); // 100ms 防抖，避免频繁触发
       });
       resizeObserver.observe(containerRef.value);
     } else {
@@ -2440,6 +2558,10 @@ onBeforeUnmount(() => {
     clearTimeout(resizeTimer);
     resizeTimer = null;
   }
+  if (resizeDebounceTimer) {
+    clearTimeout(resizeDebounceTimer);
+    resizeDebounceTimer = null;
+  }
   if (resizeObserver) {
     resizeObserver.disconnect();
     resizeObserver = null;