如何使用 Konva 在 Canvas 上绘制 SVG 图像

如何在 Canvas 上显示 SVG 图像？

浏览器以前并非总能在 Canvas 上绘制 *.svg 图像。不过，这种情况已经改善。要使用 Konva 渲染矢量图像，现在有以下几种选择：

选项 1：使用 Konva.Image

在大多数情况下，可以使用 *.svg 图像，方法与使用 *.png 或 *.jpg 等其他图像相同。可以使用 Konva.Image 图形。

Konva.Image.fromURL('/image.svg', (image) => {
  layer.add(image);
});

此方法在许多情况下效果良好，但并非完全跨浏览器兼容。例如，某些 SVG 可能无法在 Firefox 浏览器中显示（此问题有一种解决方法）。

选项 2：使用 Konva.Path

使用 Konva.Path。此方法适合简单的路径图形。如果大型 SVG 包含许多路径，可能需要手动将其拆分成多个 Konva.Path 图形。

选项 3：使用外部库将 SVG 渲染到 Canvas

使用外部库（例如 canvg）将 SVG 绘制到 <canvas> 元素中。然后，将该 Canvas 用于 Konva.Image。

至少有一个大型生产应用程序测试过此方法，并验证了它的可靠性和渲染准确性。

示例

以下示例演示原生绘制和使用库绘制的效果。

Vanilla

import Konva from 'konva';
import { Canvg } from 'canvg';

const stage = new Konva.Stage({
  container: 'container',
  width: window.innerWidth,
  height: window.innerHeight,
});

const layer = new Konva.Layer();
stage.add(layer);

const SOURCE = 'https://konvajs.org/assets/tiger.svg';

// try to draw SVG natively
Konva.Image.fromURL(SOURCE, (imageNode) => {
  layer.add(imageNode);
  imageNode.setAttrs({
    width: 150,
    height: 150,
  });
});

// draw svg with external library
async function renderWithCanvg() {
  const canvas = document.createElement('canvas');
  const context = canvas.getContext('2d');
  const renderer = await Canvg.from(context, SOURCE);
  await renderer.render();

  const image = new Konva.Image({
    image: canvas,
    x: 200,
    width: 150,
    height: 150,
  });
  layer.add(image);
}

renderWithCanvg().catch((error) => {
  console.error('Failed to render SVG:', error);
});

React

import React from 'react';
import { Stage, Layer, Image } from 'react-konva';
import { useImage } from 'react-konva-utils';
import { Canvg } from 'canvg';

const SOURCE = 'https://konvajs.org/assets/tiger.svg';

const App = () => {
  const [nativeImage] = useImage(SOURCE);
  const [canvgImage, setCanvgImage] = React.useState(null);

  React.useEffect(() => {
    let active = true;

    const renderWithCanvg = async () => {
      const canvas = document.createElement('canvas');
      const context = canvas.getContext('2d');
      const renderer = await Canvg.from(context, SOURCE);
      await renderer.render();
      if (active) setCanvgImage(canvas);
    };

    renderWithCanvg().catch((error) => {
      console.error('Failed to render SVG:', error);
    });

    return () => {
      active = false;
    };
  }, []);

  return (
    <Stage width={window.innerWidth} height={window.innerHeight}>
      <Layer>
        {nativeImage && (
          <Image
            image={nativeImage}
            width={150}
            height={150}
          />
        )}
        {canvgImage && (
          <Image
            image={canvgImage}
            x={200}
            width={150}
            height={150}
          />
        )}
      </Layer>
    </Stage>
  );
};

export default App;

Vue

<template>
  <v-stage :config="stageConfig">
    <v-layer>
      <v-image
        v-if="nativeImage"
        :config="{
          image: nativeImage,
          width: 150,
          height: 150
        }"
      />
      <v-image
        v-if="canvgImage"
        :config="{
          image: canvgImage,
          x: 200,
          width: 150,
          height: 150
        }"
      />
    </v-layer>
  </v-stage>
</template>

<script setup>
import { ref, onMounted, onUnmounted } from 'vue';
import { useImage } from 'vue-konva';
import { Canvg } from 'canvg';

const SOURCE = 'https://konvajs.org/assets/tiger.svg';
const [nativeImage] = useImage(SOURCE);
const canvgImage = ref(null);
let isUnmounted = false;

const stageConfig = {
  width: window.innerWidth,
  height: window.innerHeight
};

onMounted(async () => {
  try {
    const canvas = document.createElement('canvas');
    const context = canvas.getContext('2d');
    const renderer = await Canvg.from(context, SOURCE);
    await renderer.render();
    if (!isUnmounted) canvgImage.value = canvas;
  } catch (error) {
    if (!isUnmounted) console.error('Failed to render SVG:', error);
  }
});

onUnmounted(() => {
  isUnmounted = true;
});
</script>

操作说明：本示例演示以不同方式渲染的两个 SVG 图像：

1. 左侧图像：使用 Konva.Image 原生渲染 SVG
2. 右侧图像：使用 canvg 库渲染 SVG