如何使用 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';

// 加载 canvg 库
const script = document.createElement('script');
script.src = 'https://cdn.jsdelivr.net/npm/canvg/dist/browser/canvg.min.js';
document.head.appendChild(script);

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,
  });
});

// 使用外部库绘制 SVG
script.onload = () => {
  const canvas = document.createElement('canvas');
  canvg(canvas, SOURCE, {
    renderCallback: function () {
      const image = new Konva.Image({
        image: canvas,
        x: 200,
        width: 150,
        height: 150,
      });
      layer.add(image);
    },
  });
};

Open Sandbox

React

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

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

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

  React.useEffect(() => {
    // 加载 canvg 库并渲染 SVG
    const script = document.createElement('script');
    script.src = 'https://cdn.jsdelivr.net/npm/canvg/dist/browser/canvg.min.js';
    script.onload = () => {
      const canvas = document.createElement('canvas');
      canvg(canvas, SOURCE, {
        renderCallback: function () {
          setCanvgImage(canvas);
        },
      });
    };
    document.head.appendChild(script);

    return () => {
      script.remove();
    };
  }, []);

  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;

Open Sandbox

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';

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

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

onMounted(() => {
  // 加载 canvg 库并渲染 SVG
  const script = document.createElement('script');
  script.src = 'https://cdn.jsdelivr.net/npm/canvg/dist/browser/canvg.min.js';
  script.onload = () => {
    const canvas = document.createElement('canvas');
    canvg(canvas, SOURCE, {
      renderCallback: function () {
        canvgImage.value = canvas;
      },
    });
  };
  document.head.appendChild(script);

  return () => {
    script.remove();
  };
});
</script>

Open Sandbox

说明：演示展示了以不同方式渲染的两个 SVG 图像：

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