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

如何在画布上显示 SVG 图像？

浏览器并不总是能够将 *.svg 图像绘制到画布上。然而，情况已经有所改善，如果你想用 Konva 渲染矢量图像，目前有几种选择：

选项 1：使用 Konva.Image

在大多数情况下，你可以像使用其他图像（如 *.png 或 *.jpg）一样使用 *.svg 图像。你可以使用 Konva.Image 形状。

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

该方法在许多情况下效果良好，但并不是完全跨浏览器兼容的。例如，一些 SVG 在 Firefox 浏览器中可能不可见（对此情况有一个变通方法）。

选项 2：使用 Konva.Path

使用 Konva.Path。该方法适用于简单的路径形状。如果你有一个包含许多路径的大 SVG，你可能需要手动将其拆分成多个 Konva.Path 形状。

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

使用外部库（例如 canvg）将 SVG 绘制到 <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';

// 尝试原生绘制 SVG
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。