Canvas Fabric.js库中文文档API 教程(一)

最新推荐文章于 2024-07-30 17:53:07 发布

绝尘韫玉

最新推荐文章于 2024-07-30 17:53:07 发布

阅读量5.6k

点赞数 8

分类专栏：学习笔记

原文链接：https://github.com/kangax/fabric.js/

版权

学习笔记专栏收录该内容

2 篇文章 1 订阅

订阅专栏

出处：https://github.com/kangax/fabric.js/

Fabric.js介绍第一部分

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kBogTRm8-1587816937914)(https://github.com/kangax/fabric.js/raw/master/lib/screenshot.png)]

今天我开始像您介绍Fabric，一个功能强大的Javascript库，运行在HTML5 canvas上，Fabric为画布提供了一个缺失的对象模型，以及一个SVG解析器，一个交互层，以及一整套其他必不可少的工具。它是一个完全开放源码的项目，在MIT许可，多年来做出了许多贡献。

三年前我开始开发Fabric，在发现使用原生canvas的API之后，我正在为printio.ru创建一个互动设计编辑器：我的创业公司允许用户设计自己的服装。在这些日子里，我们想要的那种交互性只存在于Flash应用中。而现在，"Fabric"成为可能。

让我们来看看吧！

为什么要做fabric

Canvas可以让我们在网络上创造出绝对惊人的图形。但它提供的API是令人失望的。如果我们只想在画布上画几条基本的形状，不会觉得有什么繁琐。但是一旦需要任何形式的互动，任何时候改变图片或绘制更复杂的形状，代码复杂度会急剧增加。

Fabric旨在解决这个问题。

原生canvas方法只允许我们触发简单的图形命令，盲目的修改canvas的位图，想画一个矩形？使用fillRect(left, top, width, height).，想画一条线？使用moveTo(left, top)和 lineTo(x, y)的组合命令，就好像我们用刷子画画，上层涂上越来越多的颜料，几乎没有控制。

Fabric不是在这么低的层次上运行，而是在原生方法之上提供简单而强大的对象模型。它负责画布状态和渲染，并让我们直接使用绘制后的“对象”。

让我们来看一个简单的例子来说明这个差异。假设我们想在画布上画一个红色的矩形。以下是我们如何使用原生的<canvas>API。

// 有一个id是c的canvas元素
var canvasEl = document.getElementById('c');

// 获取2d位图模型
var ctx = canvasEl.getContext('2d');

// 设置填充颜色
ctx.fillStyle = 'red';

// 创建一个坐标100，190，尺寸是20，20的矩形
ctx.fillRect(100, 100, 20, 20);

现在使用Fabric做同样的事情：

// 用原生canvas元素创建一个fabric实例
var canvas = new fabric.Canvas('c');

// 创建一个矩形对象
var rect = new fabric.Rect({
  left: 100,
  top: 100,
  fill: 'red',
  width: 20,
  height: 20
});

// 将矩形添加到canvas画布上
canvas.add(rect);

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kvyJfosA-1587816937920)(http://fabricjs.com/article_assets/1.png)]

在这种情况下，这两个例子非常相似，大小几乎没有差别。但是，您可以看到使用canvas的方法有多么不同。使用原生方法，我们在上下文中操作（表示整个画布位图的对象），在Fabric中，我们操作对象，实例化它们，更改其属性，并将其添加到画布。你可以看到这些对象是Fabric中的第一等公民。

但渲染纯正的红色矩形就如此无聊。我们至少可以做一些有趣的事情！也许，稍稍旋转？

旋转45度，首先使用原生的canvas方法：

var canvasEl = document.getElementById('c');
var ctx = canvasEl.getContext('2d');
ctx.fillStyle = 'red';

ctx.translate(100, 100);
ctx.rotate(Math.PI / 180 * 45);
ctx.fillRect(-10, -10, 20, 20);

使用Fabric：

var canvas = new fabric.Canvas('c');

// 创建一个45度的矩形
var rect = new fabric.Rect({
  left: 100,
  top: 100,
  fill: 'red',
  width: 20,
  height: 20,
  angle: 45
});

canvas.add(rect);

这里发生了什么？

我们在Fabric中所做的一切都是将对象的“角度”值更改为45。然而使用原生的方法，事情变得更加有趣，记住我们无法对对象进行操作，相反，我们调整整个画布位图（ctx.translate，ctx.rotate）的位置和角度，以适应我们的需要。然后，我们再次绘制矩形，但记住要正确地偏移位图（-10，-10），所以它仍然呈现在100,100点。作为练习，我们不得不在旋转画布位图时将度数转换为弧度。

我相信你刚刚开始明白为什么面料存在，以及它解决了多少低级写法。

如果在某些时候，我们想将现在熟悉的红色矩形移动到画布上稍微不同的位置怎么办？我们如何在无法操作对象的情况下执行此操作？我们会在canvas位图上调用另一个fillRect吗？

不完全的。调用另一个fillRect命令实际上在画布上绘制的东西所有之上绘制矩形。还记得我前边说的用刷子画画吗？为了“移动”它，我们需要先擦除以前绘制的内容，然后在新的位置绘制矩形。

var canvasEl = document.getElementById('c');

...
ctx.strokRect(100, 100, 20, 20);
...

// 擦除整个画布
ctx.clearRect(0, 0, canvasEl.width, canvasEl.height);
ctx.fillRect(20, 50, 20, 20);

我们如何用Fabric完成这个？

var canvas = new fabric.Canvas('c');
...
canvas.add(rect);
...

rect.set({ left: 20, top: 50 });
canvas.renderAll();

注意一个非常重要的区别。使用Fabric，在尝试“修改”任何内容之前，我们不再需要擦除内容。我们仍然使用对象，只需更改其属性，然后重新绘制画布即可获得“最新图片”。

Fabric中的对象

我们已经看到如何通过实例化fabric.Rect构造函数来处理矩形。当然，Fabric也涵盖了所有其他的基本形状：圆，三角形，椭圆等。所有的这些在就是Fabric“命名空间”下的：fabric.Circle，fabric.Triangle，fabric.Ellipse等。

Fabric提供了7种基础形状：

想画一个圈子？只需创建一个圆形对象，并将其添加到画布。与任何其他基本形状相同：

var circle = new fabric.Circle({
  radius: 20, fill: 'green', left: 100, top: 100
});
var triangle = new fabric.Triangle({
  width: 20, height: 30, fill: 'blue', left: 50, top: 50
});

canvas.add(circle, triangle);

这是一个绿色的圆形在100，100的位置，蓝色的三角形在50，50的位置。

操作对象

创建图形对象矩形，圆形或其他东西，当然只是开始。在某些时候，我们可能想修改这些对象。或许某些行为需要触发状态的变化，或进行某种动画。或者我们可能希望在某些鼠标交互中更改对象属性（颜色，不透明度，大小，位置）。

Fabric为我们处理画布渲染和状态管理。我们只需要自己修改对象。

以前的例子演示了set方法，以及如何从对象前一个位置调用set（{left：20，top：50}）来移动对象。以类似的方式，我们可以改变对象的任何其他属性。但这些属性是什么？

那么，正如你所期望的那样，可以改变定位：top，left。尺寸：width，height。渲染： fill, opacity, stroke, strokeWidth。缩放和旋转：scaleX, scaleY, angle;甚至可以翻转：flipX，flipY。歪斜：skewX，skewY。

是的，在Fabric中翻转对象非常简单，将flip[X|Y]设置为true即可。

您可以通过get方法读取任何这些属性，并通过set进行设置。我们尝试改变一些红色矩形的属性：

var canvas = new fabric.Canvas('c');
...
canvas.add(rect);

rect.set('fill', 'red');
rect.set({ strokeWidth: 5, stroke: 'rgba(100,200,200,0.5)' });
rect.set('angle', 15).set('flipY', true);

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-9MWi4OfS-1587816937932)(http://fabricjs.com/article_assets/5.png)]

首先，我们将“fill”值设置为“red”，使对象成为红色。下一个语句设置“strokeWidth”和“stroke”值，给出矩形为淡绿色的5px笔画。最后，我们正在改变“angle”和“flipY”的属性。注意每个3个语句中的每个语句使用的语法略有不同。

这表明set是一种通用的方法。你可能经常使用它，所以它被设计得尽可能的方便。

说了如何set的方法，那么如何获取呢？这就有了与之对应的get方法，h还有一些具体的get*，要读取对象的“width”值，可以使用get（'width'）或getWidth（）。获取“scaleX”值使用get（'scaleX'）或getScaleX（），等等。对于每个“公有”对象属性（“stroke”，“strokeWidth”，“angle”等），都可以使用getWidth或getScaleX等方法。

您可能会注意到，在早期的示例中，对象在实例化的时候，我们直接传入的配置参数，而上边的例子我们才实例化对象的时候没有传入配置，而是使用的set方法传递配置。这是因为它是完全一样的。您可以在创建时“配置”对象，也可以使用set方法:

var rect = new fabric.Rect({ width: 10, height: 20, fill: '#f55', opacity: 0.7 });

// 或者这样

var rect = new fabric.Rect();
rect.set({ width: 10, height: 20, fill: '#f55', opacity: 0.7 });

默认选项

在这一点上，您可能会问，当我们创建对象而不传递任何“配置”对象时会发生什么。它还有这些属性吗？

当然是。 Fabric中的对象总是具有默认的属性集。当在创建过程中发生变化时，这是对给定的“给定”的默认属性集。我们可以自己试试看看：

var rect = new fabric.Rect(); // 注意没有传递参数

rect.get('width'); // 0
rect.get('height'); // 0

rect.get('left'); // 0
rect.get('top'); // 0

rect.get('fill'); // rgb(0,0,0)
rect.get('stroke'); // null

rect.get('opacity'); // 1

我们的矩形有一个默认的属性集。它位于0,0，是黑色，完全不透明，没有描边，没有尺寸（宽度和高度为0）。由于没有尺寸，我们无法在画布上看到它。但是给它宽度/高度的任何正值肯定会在画布的左上角显示一个黑色矩形。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-nENXCy8N-1587816937933)(http://fabricjs.com/article_assets/6.png)]

层次和继承

Fabric对象不仅彼此独立存在。它们形成一个非常精确的层次。

大多数对象从根fabric.Object继承。fabric.Object几乎代表二维形状，位于二维canvas平面，它是一个具有left / top和width / height属性的实体，以及一些其他图形特征。我们在物体上看到的那些属性：fill，stroke，angle，opacity，flip[X|Y]等，对于从fabric.Object继承的所有Fabric对象都是通用的。

这个继承允许我们在fabric.Object上定义方法，并在所有的“类”之间共享它们。例如，如果您想在所有对象上使用getAngleInRadians方法，您只需在fabric.Object.prototype上创建它即可：

fabric.Object.prototype.getAngleInRadians = function() {
  return this.get('angle') / 180 * Math.PI;
};

var rect = new fabric.Rect({ angle: 45 });
rect.getAngleInRadians(); // 0.785...

var circle = new fabric.Circle({ angle: 30, radius: 10 });
circle.getAngleInRadians(); // 0.523...

circle instanceof fabric.Circle; // true
circle instanceof fabric.Object; // true

您可以看到，方法立即在所有实例上可用。

虽然子类“class”继承自fabric.Object，但它们通常也定义自己的方法和属性。例如，fabric.Circle需要有“radius”属性。而Fabric.Image（我们稍后会看），需要使用getElement/ setElement方法来访问/设置图像实例的真实HTML<img>元素。

使用原型来获取自定义渲染和行为对于高级项目来说是非常普遍的。

Canvas

现在我们更详细地讨论了对象，让我们回到canvas。

首先你可以看到所有的Fabric例子如果创建canvas对象：new fabric.Canvas（'...'）。fabric.Canvas作为围绕<canvas>元素的包装器，并负责管理该canvas上的所有Fabric对象。它需要一个元素的id，并返回一个fabric.Canvas的实例。

我们可以add对象，引用它们，或者remove它们：

var canvas = new fabric.Canvas('c');
var rect = new fabric.Rect();

canvas.add(rect); // 添加对象

canvas.item(0); // 源于刚刚添加的第一个矩形对象
canvas.getObjects(); // 获取所有对象（只有一个矩形）

canvas.remove(rect); // 移除这个矩形

管理对象是Fabric的主要用途。其实它本事也是可配置的，需要为整个画布设置背景颜色或图像？将所有内容剪切到某个区域？设置不同的宽度/高度？指定画布是否互动？所有这些选项（和其他）可以在fabric.Canvas上设置，无论是在创建时还是之后：

var canvas = new fabric.Canvas('c', {
  backgroundColor: 'rgb(100,100,200)',
  selectionColor: 'blue',
  selectionLineWidth: 2
  // ...
});

// 或者

var canvas = new fabric.Canvas('c');
canvas.setBackgroundImage('http://...');
canvas.onFpsUpdate = function(){ /* ... */ };
// ...

互动

虽然我们是一个canvas元素的主题，我们来谈谈互动。Fabric的独特功能之一，在我们刚刚看到的所有的对象模型之上，是一层交互性。

存在对象模型以允许编程访问和操纵画布上的对象。但在外部，在用户层面上，有一种方式可以通过鼠标（或触摸，触摸设备）来操纵这些对象。一旦您通过new fabric.Canvas（'...'）初始化画布，可以选择对象，拖动它们，缩放或旋转它们，甚至组合在一起操纵一个组合！

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-iHo7Vx95-1587816937935)(http://fabricjs.com/article_assets/7.png)]

如果我们希望用户允许在画布上拖动某些东西，比如一个图片，我们需要做的就是初始化画布并在其上添加一个对象。不需要额外的配置或设置。

为了控制这种交互性，我们可以在画布上使用Fabric的“selection”布尔属性，结合各个对象的“selectable”布尔属性来使用。

var canvas = new fabric.Canvas('c');
...
canvas.selection = false; // 禁止所有选中
rect.set('selectable', false); // 只是禁止这个矩形选中

但是如果你不想要这样的互动层呢？如果是这样，您可以随时用fabric.StaticCanvas替换fabric.Canvas。初始化的语法是相同的;初始化时使用StaticCanvas而不是Canvas。

var staticCanvas = new fabric.StaticCanvas('c');

staticCanvas.add(
  new fabric.Rect({
    width: 10, height: 20,
    left: 100, top: 100,
    fill: 'yellow',
    angle: 30
  }));

这将创建一个“更轻”的画布版本，没有任何事件处理逻辑。请注意，您仍然有一个完整的对象模型来使用：添加对象，删除或修改它们，以及更改任何画布配置，所有这一切仍然有效。这只是事件处理没有了。

当我们浏览自定义构建选项时，您会看到，如果StaticCanvas是您需要的选项，您甚至可以创建一个较轻的Fabric版本。如果您需要非交互式图表，或者在应用程序中使用过滤器的非交互式图像，这可能是一个不错的选择。

图像

说到图像…

在画布上添加矩形和圆圈很有趣，但为什么我们不玩某些图像？正如你现在想象的那样，Fabric使这个很容易。我们来实例化fabric.Image对象并将其添加到画布中：

<canvas id="c"></canvas>
<img src="my_image.png" id="my-image">

var canvas = new fabric.Canvas('c');
var imgElement = document.getElementById('my-image');
var imgInstance = new fabric.Image(imgElement, {
  left: 100,
  top: 100,
  angle: 30,
  opacity: 0.85
});
canvas.add(imgInstance);

注意我们如何将图像元素传递给fabric.Image构造函数。这将创建一个fabric.Image的实例，就像文档中的图像一样。此外，我们立即将左/顶值设置为100/100，角度为30，不透明度为0.85。一旦添加到画布中，图像呈现在100,100位置，30度角，并且稍微透明！不错。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-YBePf5sx-1587816937939)(http://fabricjs.com/article_assets/9.png)]

现在，如果我们在文档中真的没有图像，而只是一个图像的URL呢？我们来看看如何使用fabric.Image.fromURL：

fabric.Image.fromURL('my_image.png', function(oImg) {
  canvas.add(oImg);
});

看起来很简单，不是吗？只需调用具有图像URL的fabric.Image.fromURL，并在加载和创建图像后给它一个回调函数来调用。回调函数接收已经创建的fabric.Image对象作为第一个参数。此时，您可以将其添加到画布中，也可以先更改，然后添加到画布：

fabric.Image.fromURL('my_image.png', function(oImg) {
  // 将其缩小，然后将其翻转，然后再将其添加到画布上
  oImg.scale(0.5).set('flipX, true);
  canvas.add(oImg);
});

路径（Paths）

我们已经看过简单的形状，然后看了图像。那么更复杂，丰富的形状和内容呢？

认识更强大的搭档：路径（Path）和组合（Group）

Fabric中的path表示可以填充，描边和修改的形状的轮廓。path由一系列命令组成，基本上模仿了从一个点到另一个点的笔。借助“move”，“line”，“curve”或“arc”等命令，path可以形成令人难以置信的复杂形状。在Paths（路径组合）团队的帮助下，可能性更大。

Fabric中的路径与SVG 元素非常相似。它们使用相同的命令，可以从<path>元素创建，并将其序列化。稍后我们将更加仔细地观察序列化和SVG解析，但现在值得一提的是，您很可能很少手动创建Path实例，相反，您将使用Fabric的内置SVG解析器。但是要了解Path对象是什么，我们来尝试用手创建一个简单的对象：

var canvas = new fabric.Canvas('c');
var path = new fabric.Path('M 0 0 L 200 100 L 170 200 z');
path.set({ left: 120, top: 120 });
canvas.add(path);

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-e9h7RIA2-1587816937941)(http://fabricjs.com/article_assets/10.png)]

我们通过传递一串路径指令，实例化fabric.Path对象，虽然看起来很神秘，但实际上很容易理解。“M”代表“move”命令，并告诉笔移动到0，0坐标。“L”表示“line”，笔画线为200，100坐标。然后，另一个“L”创建一个连接170，200坐标的线段。最后，“z”指示绘画笔关闭当前路径并完成形状。结果，我们得到一个三角形。

由于fabric.Path与Fabric中的任何其他对象一样，我们还可以更改其某些属性。但是我们可以修改更多：

...
var path = new fabric.Path('M 0 0 L 300 100 L 200 300 z');
...
path.set({ fill: 'red', stroke: 'green', opacity: 0.5 });
canvas.add(path);

出于好奇，我们来看一下稍微更复杂的path语法。你会看到为什么手动创建路径可能不是最好的主意。

...
var path = new fabric.Path('M121.32,0L44.58,0C36.67,0,29.5,3.22,24.31,8.41\
c-5.19,5.19-8.41,12.37-8.41,20.28c0,15.82,12.87,28.69,28.69,28.69c0,0,4.4,\
0,7.48,0C36.66,72.78,8.4,101.04,8.4,101.04C2.98,106.45,0,113.66,0,121.32\
c0,7.66,2.98,14.87,8.4,20.29l0,0c5.42,5.42,12.62,8.4,20.28,8.4c7.66,0,14.87\
-2.98,20.29-8.4c0,0,28.26-28.25,43.66-43.66c0,3.08,0,7.48,0,7.48c0,15.82,\
12.87,28.69,28.69,28.69c7.66,0,14.87-2.99,20.29-8.4c5.42-5.42,8.4-12.62,8.4\
-20.28l0-76.74c0-7.66-2.98-14.87-8.4-20.29C136.19,2.98,128.98,0,121.32,0z');

canvas.add(path.set({ left: 100, top: 200 }));

看一下这里发生了什么？

那么“M”仍然代表“move”的命令，所以笔在“121.32,0”点开始绘画。然后有“L”命令使其为“44.58,0”。到现在为止还可以理解。下一步是什么？ “C”指令，代表“cubic bezier”（贝塞尔曲线）。它使笔从当前点绘制贝塞尔曲线到“36.67,0”，它以“29.5,3.22”为起点的控制点，“24.31,8.41”为终点的控制点。这整个事情之后是十几个其他的“cubic bezier”命令，最终创建一个漂亮的箭头形状。

不过你可能永远不会使用这样复杂的命令，相反，您可能需要使用像fabric.loadSVGFromString或fabric.loadSVGFromURL方法来加载整个SVG文件,然后让Fabric的SVG解析器完成对所有SVG元素的遍历和创建相应的Path对象的工作。

谈到整个SVG文件，而Fabric的路径通常表示SVG<path>元素，SVG文档中通常存在的路径集合表示为Group（fabric.Group实例）。你可以想像，Group(组合)只不过是一组Path实例和其他对象。而且由于fabric.Group从fabric.Object继承，它可以像任何其他对象一样添加到画布中，并以相同的方式进行操作。

就像Path一样，你可能不会直接的使用它。但是，如果您在解析SVG文档之后偶然发现了一个问题，那么您将确切地知道它是什么以及它的目的是什么。

后记

我们只触及了Fabric的表面。你现在可以很容易地创建任何一个简单的形状，复杂的形状，图像;将它们添加到画布中，并以任何你想要的方式进行修改：位置、尺寸、角度、颜色、笔画、不透明度等。

在本系列的下一部分，我们将看看组合，动画，文本，SVG解析，渲染，序列化，事件，图像，滤镜等。

与此同时，你可以随意查看带注释的演示或基准，加入Google小组或其他地方的讨论，或者直接访问docs、wiki和源代码。

做一些有趣的实验！我希望你喜欢这次旅行。

绝尘韫玉

关注

8
点赞
踩
14

收藏

觉得还不错? 一键收藏
0
评论
Canvas Fabric.js库中文文档API 教程(一)

出处：https://github.com/kangax/fabric.js/Fabric.js介绍第一部分[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kBogTRm8-1587816937914)(https://github.com/kangax/fabric.js/raw/master/lib/screenshot.png)]今天我开始像您介绍F...
复制链接

扫一扫