如何在Markmap项目中获取SVG元素的实际尺寸并导出高清PNG

背景介绍

在Markmap项目中，用户经常需要将生成的思维导图导出为PNG格式。然而，直接导出时经常会遇到图片模糊的问题，这主要是因为SVG到PNG转换过程中尺寸处理不当导致的。

核心问题分析

当从SVG导出PNG时，主要存在两个关键问题：

1. 尺寸获取不准确：直接从SVG元素获取的width和height可能不是实际渲染尺寸
2. 缩放比例不当：转换过程中没有正确处理DPI缩放，导致输出图片质量下降

解决方案详解

1. 获取SVG实际尺寸

首先需要准确获取SVG元素的实际渲染尺寸：

const svgEl = refSvg.current;
const originWidth = svgEl.width.baseVal.value || 800;
const originHeight = svgEl.height.baseVal.value || 400;

如果SVG没有明确设置尺寸，可以通过其父容器动态设置：

if (refSvg.current && boxRef.current) {
  const { width } = boxRef.current.getBoundingClientRect();
  refSvg.current?.setAttribute('width', width.toString());
  refSvg.current?.setAttribute('height', '400');
}

2. 高质量PNG导出实现

使用Canvas进行高质量PNG导出时，关键点在于：

1. 设置足够大的画布尺寸
2. 应用适当的缩放比例
3. 正确绘制SVG图像

const scale = 10; // 缩放倍数，值越高越清晰
const canvas = document.createElement('canvas');
canvas.width = originWidth * scale;
canvas.height = originHeight * scale;
const ctx = canvas.getContext('2d');

if (ctx) {
  // 设置背景色
  ctx.fillStyle = '#fff';
  ctx.fillRect(0, 0, canvas.width, canvas.height);
  
  // 应用缩放变换
  ctx.setTransform(scale, 0, 0, scale, 0, 0);
  
  // 绘制SVG图像
  ctx.drawImage(img, 0, 0, canvas.width, canvas.height);
  
  // 导出PNG
  canvas.toBlob((blob) => {
    // 处理导出的Blob对象
  }, 'image/png');
}

常见问题解决

导出图片尺寸过小

如果导出的PNG图片显示过小，通常是因为绘制时使用了原始尺寸而非缩放后的尺寸。解决方案是：

// 错误做法：使用原始尺寸
ctx.drawImage(img, 0, 0, originWidth, originHeight);

// 正确做法：使用缩放后的尺寸
ctx.drawImage(img, 0, 0, canvas.width, canvas.height);

背景色处理

默认情况下，Canvas是透明的，如果需要白色背景，需要显式填充：

ctx.fillStyle = '#fff'; // 或任何其他颜色
ctx.fillRect(0, 0, canvas.width, canvas.height);

最佳实践建议

1. 动态计算尺寸：根据实际内容动态计算SVG尺寸，而非使用固定值
2. 合理设置缩放比例：根据输出需求平衡清晰度和文件大小
3. 错误处理：添加适当的错误处理逻辑，确保导出过程稳定
4. 性能优化：对于大型思维导图，考虑分块处理或降低缩放比例

通过以上方法，可以确保从Markmap导出的PNG图片既保持清晰度，又具有适当的尺寸，满足各种使用场景的需求。