导出

src/components/CanvasLabelImage.tsx

@@ -14,6 +14,9 @@ interface CanvasLabelImageProps {
   variableDefaults?: Record<string, string> | null;
   /** design=设计预览（空变量显示占位）；output=排版/打印（空值隐藏图形元素） */
   mode?: ContentResolveMode;
+  referenceBackground?: string;
+  referenceBackgroundOpacity?: number;
+  referenceBackgroundFit?: 'contain' | 'cover' | 'fill';
   /** 渲染倍率，设计画布应传 MM_TO_PX * zoom 与显示尺寸 1:1 对齐 */
   renderScale?: number;
 }
@@ -28,6 +31,9 @@ export const CanvasLabelImage: React.FC<CanvasLabelImageProps> = ({
   transparentBackground = false,
   variableDefaults = null,
   mode = 'design' as ContentResolveMode,
+  referenceBackground,
+  referenceBackgroundOpacity,
+  referenceBackgroundFit,
   renderScale = 16,
 }) => {
   const [dataUrl, setDataUrl] = useState<string>('');
@@ -54,6 +60,9 @@ export const CanvasLabelImage: React.FC<CanvasLabelImageProps> = ({
       variableDefaults,
       mode,
       scale: renderScale,
+      referenceBackground,
+      referenceBackgroundOpacity,
+      referenceBackgroundFit,
     })
       .then((url) => {
         if (!active) return;
@@ -88,6 +97,9 @@ export const CanvasLabelImage: React.FC<CanvasLabelImageProps> = ({
     transparentBackground,
     mode,
     renderScale,
+    referenceBackground,
+    referenceBackgroundOpacity,
+    referenceBackgroundFit,
   ]);
 
   if (initialLoading && !dataUrl) {