Konva入门教程

啥是 Konva

Konva 是一个 canvas 库，可以让我们像操作 DOM 一样来操作 canvas，并提供了对 canvas 中元素的事件机制，拖放操作的支持。所以，用它来做一个拼图游戏什么的最合适了。此外，你也可以借助它来绘制一个页面的截图，作为大名鼎鼎的 html2canvas 库的替代方案，因为 html2canvas 在部分手机上生成截图的效果并不是很好。

容器，stage，layer，shape

在初始化 Konva 时需要调用 Konva.Stage 构造函数，并提供一个 div 作为容器：

var stage = new Konva.Stage({
  container: 'container', // 容器 id
  width: width,// canvas 宽度
  height: height// canvas 高度
});

初始化 Stage 之后，我们就可以向 Stage 里面添加 layer 了：

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

layer 的概念类似于 ps 中的图层，或者 DOM 中的 z-index，当我们向 stage 中添加一个 layer 时，DOM 中会再加入一个 canvas 元素来对应这个 layer。

shape 就是说我们可以在 layer 上画形状了，Konva 为我们提供了许多 shape，比如矩形，圆形，线段，图片，文字等，下面的代码在 layer 上画了一个矩形:

var rect = new Konva.Rect({
   x: 10 ,
   y: 10,
   width: 100,
   height: 100,
   fill: 'blue'
 })

当我们往 layer 中添加了多个 shape 时，调用 layer.draw 时，layer 会按照形状添加的先后顺序依次进行绘制。后面添加的在上面，最先添加的在最下面。

See the Pen LaBjOY by imgss
(@imgss) on CodePen.

到这里我们大概知道 Konva 的元素结构了，以下是官方给出的元素树图：

              Stage
                |
         +------+------+
         |             |
       Layer         Layer
         |             |
   +-----+-----+     Shape
   |           |
 Group       Group
   |           |
   +       +---+---+
   |       |       |
Shape   Group    Shape
           |
           +
           |
         Shape

这里我们还没有了解过 group，下面我们介绍一下 group。

group

group 类似于 ps 中的组，当把几个形状添加到 group 时，移动或者旋转 group 时，group 中的形状会整体发生变化, 上面的三个矩形就构成了一个 group，我们把 group 的 draggable 属性设为 true，当移动 group 时，三个矩形都会发生移动。

var group = new Konva.Group({
  x: 120,
  y: 40,
  draggable: true,
  rotation: 20
});

var colors = ['red', 'orange', 'yellow'];

for(var i = 0; i < 3; i++) {
  var box = new Konva.Rect({
    x: i * 30,
    y: i * 18,
    width: 100,
    height: 50,
    name: colors[i],
    fill: colors[i],
    stroke: 'black',
    strokeWidth: 4
  });

  group.add(box);
}
layer.add(group);

当使用 group 时，group 中元素的位置（x，y）是相对于 group 的位置进行定位的，而不再相对于 layer。

group 的嵌套

值得注意的是，group 中还可以嵌套 group，下面是一个 demo：

var parentGroup = new Konva.Group({
  x: 180,
  y: 200
});
var childGroup = new Konva.Group({
  x: 0,
  y: 10
});
var circle = new Konva.Circle({
  x: 10,
  y: 10,
  radius: 20,
  fill: 'green'
});
childGroup.add(circle);
parentGroup.add(childGroup);
layer.add(parentGroup);

shape的变换

我们可以借助 Konva.Transformer 来简单的对 shape 进行变换操作，Konva.Transformer其实是一类特殊的 Group。它在 Group 的基础上提供了用于对鼠标的动作进行响应的 UI。不过官网提示这一功能还在实验阶段，我们一起来看一下。

使用 transformer 可以通过以下三步：

1. 创建一个 Transformer 实例
2. 将这个实例加入到 layer 中
3. 通过实例的transformer.attachTo(node)方法绑定到一个形状或者 group 上即可。

//创建一个 star
var star = new Konva.Star({
  x: stage.width() / 2,
  y: stage.height() / 2,
  draggable: true,
  numPoints: 5,
  innerRadius: 20,
  outerRadius: 40,
  fill: 'yellow',
  stroke: 'black',
  strokeWidth: 4
});

// 创建一个 transformer
var transformer = new Konva.Transformer();

layer.add(transformer);

//将 transformer 绑定到 star 上
transformer.attachTo(star);

layer.add(star);

See the Pen PLBQMV by imgss
(@imgss) on CodePen.

元素树结构的遍历

Konva 提供了类似于 jQuery 的 find 方法来找到你想找的元素，find 方法可以在 stage，layer，group，shape 上调用，你也可以使用 findOne 来只选择一个元素。

find方法支持的选择器如下：

// 选中所有id 为 rect 的元素

var rectangle = new Konva.Rect({x: 0, y: 0, id: 'rect', ...})
stage.find('#rect');
// 选中所有 name 为 circle 的元素
var rectangle = new Konva.Rect({x: 0, y: 0, name: 'circle', ...})
stage.find('.circle');

// 选中所有Star
stage.find('Star');

// 选中所有的Star 和 Rectangle
stage.find('Shape');

需要说明的是：这里的 id 不具有唯一性，多个元素可以具有同一个 id，且选择时会选到多个元素。

参考：https://konvajs.org/docs/