乐趣区

Canvas实用库Fabric.js使用手册

简介
什么是 Fabric.js?
Fabric.js 是一个可以简化 Canvas 程序编写的库。Fabric.js 为 Canvas 提供所缺少的对象模型, svg parser, 交互和一整套其他不可或缺的工具。由于 Fabric.js 为国外框架,官方 API 杂乱繁多,相关文档大多为英文文档,而且数量不多,所以本文旨在帮助新手在项目中快速上手 Fabric.js,享受绘制 Canvas 的过程。
为什么要使用 Fabric.js?
Canvas 提供一个好的画布能力, 但是 Api 不够友好。绘制简单图形其实还可以, 不过做一些复杂的图形绘制, 编写一些复杂的效果,就不是那么方便了。Fabric.js 就是为此而开发,它主要就是用对象的方式去编写代码。
Fabric.js 能做的事情

在 Canvas 上创建、填充图形(包括图片、文字、规则图形和复杂路径组成图形)。
给图形填充渐变颜色。
组合图形(包括组合图形、图形文字、图片等)。
设置图形动画集用户交互。
生成 JSON, SVG 数据等。
生成 Canvas 对象自带拖拉拽功能。

起步
Vue 项目中引入 Fabric.js
假设您的项目中正在使用 ES6 和 Webpack,您可以开始使用 Fabric.js,如下所示:
1、在命令行中:
npm install fabric(或 yarn add fabric)
2、将其引入 .vue 文件中
import {fabric} from ‘fabric’
3、在 .vue 的单文件中的 mounted: 生命周期里开始你的 Fabric.js 之旅啦
注:默认的 fabric npm 模块产生了相当大的包,如果 Fabric.js 中您有很多可能不需要的包,在这种情况下,可以在 在此处 或在命令行中构建你自己的版本。
绘制图形
绘制规则图形
1、声明画布
var canvas =new fabric.Canvas(‘main’);
2、绘制图形
var rect = new fabric.Rect({

left:100,// 距离画布左侧的距离,单位是像素

top:100,// 距离画布上边的距离

fill:’red’,// 填充的颜色

width:30,// 方形的宽度

height:30// 方形的高度

});
3、添加图形至画布
canvas.add(rect);
其他规则图形:

绘制方形 var rect = new fabric.Rect

绘制圆形 var circle = new fabric.Circle

绘制三角形 var triangle = new fabric.Triangle

绘制不规则图形
使用路径绘图:用点和线的移动的方式进行绘图。通过对 线、曲线、弧的应用绘制非常复杂的图形。
在 fabric.Path() 方法中,“M”代表“移动”命令,这个“M 00”代表把画笔移动到(0,0)点坐标。
“L”代表“线”,“L 200 100”的意思是使用钢笔画一条线,从(0,0)坐标画到(200,100)坐标。“z”代表让图形闭合路径。
画好三角形后,我们可以用 set() 方法对三角形的位置、颜色、角度、透明度等属性进行设置。
具体代码如下:
var path = new fabric.Path(‘M 0 0 L 200 100 L 170 200 z’);

path.set({left: 120, top: 120,fill:’red’});

canvas.add(path);

对图片的操作
HTML 插入图片
<body>
<canvas id=”canvas” width=’800′ height=’800′></canvas>
<img src=”./2.png” id=”img”>
</body>
———————
var canvas = new fabric.Canvas(‘canvas’);// 声明画布
var imgElement = document.getElementById(‘img’);// 声明我们的图片
var imgInstance = new fabric.Image(imgElement,{ // 设置图片位置和样子
left:100,
top:100,
width:200,
height:100,
angle:30// 设置图形顺时针旋转角度
});

canvas.add(imgInstance);// 加入到 canvas 中

JavaScript 插入图片
var canvas = new fabric.Canvas(‘canvas’);
fabric.Image.fromURL(‘./2.png’, function(oImg) {
oImg.scale(0.1);// 图片缩小 10 倍
canvas.add(oImg);
});
交互
对画布的交互
canvas.add(imgInstance);// 加入到 canvas 中
var canvas = new fabric.Canvas(‘canvas’);
canvas.on(‘mouse:down’, function(options) {
console.log(options.e.clientX, options.e.clientY)
})
注:常用监听事件如下:

mouse:down:鼠标按下时

mouse:move:鼠标移动时

mouse:up:鼠标抬起时

对画布上对象的操作
var canvas = new fabric.Canvas(‘canvas’);

var rect = new fabric.Rect({width: 100, height: 50, fill: ‘green’});

rect.on(‘selected’, function() {// 选中监听事件

console.log(‘selected a rectangle’);

});

var circle = new fabric.Circle({radius: 75, fill: ‘blue’});

circle.on(‘selected’, function() {

console.log(‘selected a circle’);

});

canvas.add(rect);

canvas.add(circle);
注:常用监听事件如下:

after:render:画布重绘后

object:selected:对象被选中

object:moving:对象移动

object:rotating:对象被旋转

object:added:对象被加入

object:removed:对象被移除

组合
new fabric.Group(): 接受两个参数:要组合对象名称组成的数组、组合到一起的对象的共同属性。
var canvas = new fabric.Canvas(‘canvas’);

var circle = new fabric.Circle({// 绘制圆形

radius: 100,

fill: ‘#f00’,

scaleY: 0.5,

originX: ‘center’,// 调整中心点的 X 轴坐标

originY: ‘center’// 调整中心点的 Y 轴坐标

});

var text = new fabric.Text(‘Hello World’, {// 绘制文本

fontSize: 30,

originX: ‘center’,

originY: ‘center’

})

// 进行组合

var group = new fabric.Group([circle, text], {

left: 150,

top: 100,

angle: 10

})

canvas.add(group);

序列化与反序列化
序列化
var canvas = new fabric.Canvas(‘canvas’);

var rect = new fabric.Rect({

width: 100,

height: 100,

fill: ‘red’

});

canvas.add(rect);

console.log(JSON.stringify(canvas.toJSON()));
反序列化
var canvas = new fabric.Canvas(‘canvas’);

canvas.loadFromJSON(‘{“objects”:[{“type”:”rect”,”left”:50,”top”:50,”width”:20,”height”:20,”fill”:”green”,”overlayFill”:null}’)
SVG
var canvas = new fabric.Canvas(‘canvas’);

var rect = new fabric.Rect({
width: 100,
height: 100,
fill: ‘red’
});

canvas.add(rect);

canvas.toSVG();
参考文档:http://fabricjs.com/articles/

退出移动版