2 萬 Star!一個強大而簡單的 JS 畫布庫

來源于前端超人 ,作者榮頂

導(dǎo)語

我們想在畫布上畫個基本的簡單形狀的時候,使用 Canvas 不會覺得有什么繁瑣。但當畫布上需要任何形式的互動,繪制復(fù)雜的圖形和在特定情況需要改變圖片的時候,使用原生 canvas API 將會變得很困難。

而 Fabric 旨在解決這個問題。

https://github.com/fabricjs/fabric.js

Fabric.js 是一個強大而簡單的 Javascript HTML5 畫布庫。Fabric 在畫布元素之上提供交互式對象模型 Fabric 還具有 SVG-to-canvas(和 canvas-to-SVG)解析器。

為了方便,下面我將通過 vue項目 為大家講解如何使用 Fabric

一、安裝

yarn add fabric -S
#or
npm i fabric -S

也可以在 官網(wǎng) 下載最新 js 文件,通過 script 標簽引入

二、使用

<!-- html -->
<canvas id="canvas" width="500" height="500"></canvas>

2.1 繪制一個簡單的圖形

Fabric 提供了 7 種基礎(chǔ)形狀:

  • fabric.Circle (圓)
  • fabric.Ellipse (橢圓)
  • fabric.Line (線)
  • fabric.Polyline (多條線繪制成圖形)
  • fabric.triangle (三角形)
  • fabric.Rect (矩形)
  • fabric.Polygon (多邊形)
  • 矩形
// js

//引入fabric
import { fabric } from "fabric";

// 創(chuàng)建一個fabric實例
let canvas = new fabric.Canvas("canvas"); //可以通過鼠標方法縮小,旋轉(zhuǎn)
// or
// let canvas = new fabric.StaticCanvas("canvas");//沒有鼠標交互的fabric對象

// 創(chuàng)建一個矩形對象
let rect = new fabric.Rect({
    left: 200, //距離左邊的距離
    top: 200, //距離上邊的距離
    fill: "green", //填充的顏色
    width: 200, //矩形寬度
    height: 200, //矩形高度
});

// 將矩形添加到canvas畫布上
canvas.add(rect);

可以看到界面中填充了一個可以通過鼠標放大縮小且可以旋轉(zhuǎn)的綠色矩形
通過對象的形式配置元素樣式,非常的方便!

  • 圓形和三角形
// 創(chuàng)建一個圓形對象
let circle = new fabric.Circle({
    left: 0, //距離左邊的距離
    top: 0, //距離上邊的距離
    fill: "red", //填充的顏色
    radius: 50, //圓的半徑
});
// 創(chuàng)建一個三角形對象
let triangle = new fabric.Triangle({
    left: 200, //距離左邊的距離
    top: 0, //距離上邊的距離
    fill: "blue", //填充的顏色
    width: 100, //寬度
    height: 100, //高度
});
// 將圖形形添加到canvas畫布上
canvas.add(circle, triangle);

我們可以通過以下屬性設(shè)置,決定是否可以對相關(guān)元素進行交互

canvas.selection = false; // 禁止所有選中
rect.set("selectable", false); // 只是禁止這個矩形選中

2.2 繪制圖片

主要有通過 url 和 img 標簽繪制兩種方式

//通過url繪制圖片
fabric.Image.fromURL(
    //本地圖片需要通過require來引入,require("./xxx.jpeg")
    "https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fimg.thaihot.com.cn%2Fuploadimg%2Fico%2F2021%2F0711%2F1625982535739193.jpg&refer=http%3A%2F%2Fimg.thaihot.com.cn&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1630940858&t=e1d24ff0a7eaeea2ff89cedf656a9374",
    (img) => {
        img.scale(0.5);
        canvas.add(img);
    }
);
//也可以通過標簽繪制
let img = document.getElementById("img");
let image = new fabric.Image(img, {
    left: 100,
    top: 100,
    opacity: 0.8,
});
canvas.add(image);

2.3 通過自定義的路徑繪制

在此之前我們需要了解幾個參數(shù)的含義

  • M : “move”移動到某點
  • L : “l(fā)ine”畫線 x,y
  • C : “curve”曲線
  • A : “arc”弧
  • z : 閉合路徑(類似 PS 中的創(chuàng)建選區(qū))
let customPath = new fabric.Path("M 0 0 L 300 100 L 170 100  z");
customPath.set({
    left: 100,
    top: 100,
    fill: "green",
});
canvas.add(customPath);
let customPath = new fabric.Path(
    "M 0 0 L 300 100 L 170 100 L 70 300 L 20 200 C136.19,2.98,128.98,0,121.32,0 z"
);

可以看到通過路徑繪制,我們可以制作非常復(fù)雜的圖形(但是一般用不到,我們一般用它來解析 SVG 后拿到 path 復(fù)原圖形)

動畫

第一個參數(shù)是動畫的屬性,第二個參數(shù)是動畫的最終位置,第三個參數(shù)是一個可選的對象,指定動畫的細節(jié):持續(xù)時間,回調(diào),動效等。

第三個參數(shù)主要有

  • duration 默認為 500ms??梢杂脕砀淖儎赢嫷某掷m(xù)時間。
  • from 允許指定動畫屬性的起始值(如果我們不希望使用當前值)。
  • onComplete 動畫結(jié)束之后的回調(diào)。
  • easing 動效函數(shù)。

絕對動畫

let canvas = new fabric.Canvas("canvas");let rect = new fabric.Rect({    left: 400, //距離左邊的距離    top: 200, //距離上邊的距離    fill: "green", //填充的顏色    width: 200, //寬度    height: 200, //高度});rect.animate("left", 100, {    onChange: canvas.renderAll.bind(canvas),    duration: 1000,});canvas.add(rect);

相對動畫(第二個參數(shù)通過+=,-=等來決定動畫的最終效果)

rect.animate("left", "+=100", {
    onChange: canvas.renderAll.bind(canvas),
    duration: 1000,
});
rect.set({ angle: 45 });
rect.animate("angle", "-=90", {
onChange: canvas.renderAll.bind(canvas),
duration: 2000,
});

定義動畫的動效函數(shù)

默認情況下,動畫使用“easeInSine”動效執(zhí)行。如果這不是你需要的,fabric 為我們提供了很多內(nèi)置動畫效果, fabric.util.ease 下有一大堆動效的選項。
常用的有easeOutBounce,easeInCubic,easeOutCubic,easeInElasticeaseOutElastic,easeInBounceeaseOutExpo

rect.animate("left", 100, {
    onChange: canvas.renderAll.bind(canvas),
    duration: 1000,
    easing: fabric.util.ease.easeOutBounce,
});

圖像濾鏡

目前 Fabric 為我們提供了以下內(nèi)置濾鏡

  • BaseFilter 基本過濾器
  • Blur 模糊
  • Brightness 亮度
  • ColorMatrix 顏色矩陣
  • Contrast 對比
  • Convolute 卷積
  • Gamma 伽瑪
  • Grayscale 灰度
  • HueRotation 色調(diào)旋轉(zhuǎn)
  • Invert 倒置
  • Noise 噪音
  • Pixelate 像素化
  • RemoveColor 移除顏色
  • Resize 調(diào)整大小
  • Saturation 飽和

單個濾鏡

fabric.Image.fromURL(require("./aaa.jpeg"), (img) => {
    img.scale(0.5);
    canvas.add(img);
});
fabric.Image.fromURL(require("./aaa.jpeg"), (img) => {
    img.scale(0.5);
    // 添加濾鏡
    img.filters.push(new fabric.Image.filters.Grayscale());
    // 圖片加載完成之后,應(yīng)用濾鏡效果
    img.applyFilters();
    img.set({
        left: 300,
        top: 250,
    });
    canvas.add(img);
});

疊加濾鏡

“filters”屬性是一個數(shù)組,我們可以用數(shù)組方法執(zhí)行任何所需的操作:移除濾鏡(pop,splice,shift),添加濾鏡(push,unshift,splice),甚至可以組合多個濾鏡。當我們調(diào)用 applyFilters 時,“filters”數(shù)組中存在的任何濾鏡將逐個應(yīng)用,所以讓我們嘗試創(chuàng)建一個既色偏又明亮(Brightness)的圖像。

fabric.Image.fromURL(require("./aaa.jpeg"), (img) => {
    img.scale(0.5);
    // 添加濾鏡
    img.filters.push(
        new fabric.Image.filters.Grayscale(),
        new fabric.Image.filters.Sepia(), //色偏
        new fabric.Image.filters.Brightness({ brightness: 0.2 }) //亮度
    );
    // 圖片加載完成之后,應(yīng)用濾鏡效果
    img.applyFilters();
    img.set({
        left: 300,
        top: 250,
    });
    canvas.add(img);
});

可以看到多個濾鏡的效果疊加顯示了,當然 Fabric 還支持自定義濾鏡,在本篇文章點贊過 500 后我將更新 fabric 高級篇,感謝大家的支持~

顏色

無論你是使用十六進制,RGB 或 RGBA 顏色,F(xiàn)abric 都能處理的很好

定義顏色

new fabric.Color("#f55");
new fabric.Color("#aa3123");
new fabric.Color("356333");
new fabric.Color("rgb(100,50,100)");
new fabric.Color("rgba(100, 200, 30, 0.5)");

顏色轉(zhuǎn)換

new fabric.Color('#f55').toRgb(); // "rgb(255,85,85)"
new fabric.Color('rgb(100,100,100)').toHex(); // "646464"
new fabric.Color('fff').toHex(); // "FFFFFF"

我們還可以用另一種顏色疊加,或?qū)⑵滢D(zhuǎn)換為灰度版本。

let redish = new fabric.Color("#f55");
let greenish = new fabric.Color("#5f5");
redish.overlayWith(greenish).toHex(); // "AAAA55"
redish.toGrayscale().toHex(); // "A1A1A1"

漸變

Fabric 通過 setGradient 方法支持漸變,在所有對象上定義。調(diào)用 setGradient('fill', { ... })就像設(shè)置一個對象的“fill”值一樣。

let circle = new fabric.Circle({
  left: 100,
  top: 100,
  radius: 50
});

circle.setGradient("fill", {
    // 漸變開始的位置
    x1: 0,
    y1: 0,
    // 漸變結(jié)束的位置
    x2: circle.width,
    y2: 0,
    //漸變的顏色
    colorStops: {
        // 漸變的范圍(0,0.1,0.3,0.5,0.75,1)0-1之間都可以
        0: "red",
        0.2: "orange",
        0.4: "yellow",
        0.6: "green",
        0.8: "blue",
        1: "purple"
    },
});

文本

fabric.Text 對象對于文本,提供了比 canvas 更豐富的功能,包括:

  • 支持多行 Multiline support 不幸的是,原生文本方法忽略了新建一行。
  • 文本對齊 Text alignment 左,中,右。使用多行文本時很有用。
  • 文本背景 Text background 背景也支持文本對齊。
  • 文字裝飾 Text decoration 下劃線,上劃線,貫穿線。
  • 行高 Line Height 在使用多行文本時有用。
  • 字符間距 Char spacing 使文本更緊湊或更間隔。
  • 子范圍 Subranges 將顏色和屬性應(yīng)用到文本對象的子對象中。
  • 多字節(jié) Multibyte 支持表情符號。
  • 交互式畫布編輯 On canvas editing 可以直接在畫布上鍵入文本。
let text = new fabric.Text(
    "大家好~這里是前埔寨\n我是榮頂~\n一個要成為開發(fā)王的男人!",
    {
        left: 0,
        top: 200,
        fontFamily: "Comic Sans", //字體
        fontSize: 50, //字號
        fontWeight: 800, //字體粗細,可以使用關(guān)鍵字(“normal”,“bold”)或數(shù)字(100,200,400,600,800)
        shadow: "green 3px 3px 2px", //文字陰影,顏色,水平偏移,垂直偏移和模糊大小。
        underline: true, //下劃線
        linethrough: true, //刪除線
        overline: true, //上劃線
        fontStyle: "italic", //字體風格,normal(正常)或italic(斜體)
        stroke: "#c3bfbf", //描邊的顏色
        strokeWidth: 1, //描邊的寬度
        textAlign: "center", //文本對齊方式
        lineHeight: 1.5, //行高
        textBackgroundColor: "#91A8D0", //文本背景顏色
    }
);
canvas.add(text);

事件

fabric 中通過 on 方法來初始化事件,off 方法用來刪除事件。

常用的事件有以下

  • “mouse:down” 鼠標被按下
  • “object:add” 對象被添加
  • “after:render” 渲染完成

還有一大堆:
鼠標事件:“mouse:down” ,“mouse:move”和“mouse:up...” 選擇相關(guān)的事件:“before:selection:cleared”, “selection:created”, 詳細的可以查看 官方文檔

canvas.on("mouse:down", function(options) {
    canvas.clear();
    let text = new fabric.Text("你點我啦~", {
        left: 200,
        top: 200,
    });
    canvas.add(text);
    console.log(options.e.clientX, options.e.clientY);
});
canvas.on("mouse:up", function(options) {
    this.text = "你沒點我0.0";
    canvas.clear();
    let text = new fabric.Text("你沒點我0.0", {
        left: 200,
        top: 200,
    });
    canvas.add(text);
    console.log(options.e.clientX, options.e.clientY);
});

Fabric 允許將偵聽器直接附加到 canvas 畫布中的對象上。

let rect = new fabric.Rect({ width: 100, height: 50, fill: "green" });
rect.on("selected", function() {
    console.log("哦吼~你選擇了我");
});

let circle = new fabric.Circle({ radius: 75, fill: "blue" });
circle.on("selected", function() {
    console.log("哈哈哈~你選擇了我");
});

自由繪畫

Fabric canvas 的 isDrawingMode 屬性設(shè)置為 true 即可實現(xiàn)自由繪制模式.
這樣畫布上的點擊和移動就會被立刻解釋為鉛筆或刷子。

let canvas = new fabric.Canvas("canvas");
canvas.isDrawingMode = true;
canvas.freeDrawingBrush.color = "blue";
canvas.freeDrawingBrush.width = 5;

最后

很開心寫下這篇文章,它是我用來總結(jié)歸納 fabric 的知識點并且非常用心的一篇文章,希望這篇文章對你有所幫助,目前 fabric 在國內(nèi)還不是很火,但是 github 上已經(jīng)有 20k 的 star 了,也算是一個明星項目。

我們?nèi)粘i_發(fā)經(jīng)常會用到 canvas,但是它的 api 對于處理復(fù)雜的業(yè)務(wù)邏輯會令人感到非常的勞累,所以我分享這篇文章,希望對大家有所幫助。

開源前哨 日常分享熱門、有趣和實用的開源項目。參與維護 10萬+ Star 的開源技術(shù)資源庫,包括:Python、Java、C/C++、Go、JS、CSS、Node.js、PHP、.NET 等。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容