开源图片编辑器的插件化架构-编程知识

开源图片编辑器的插件化架构

news/2024/11/16 11:47:57/文章来源:https://www.cnblogs.com/nihaojob/p/18352282

大家好，我是开源图片编辑器的作者，在开发图片编辑器的过程中，因为一些功能无法扩展，出现过一次较大的重构，将整个编辑器改为了插件化的架构，经历过这次重构，规范了编辑器功能的扩展方式，解决了项目里很多重要的问题。

如果你也在做类似的项目，或者对图片编辑器架构比较感兴趣，希望我的经验能给你一点点参考。

大纲

项目介绍
为什么要做插件化
如何实现插件化
如何开发一个插件

项目介绍

项目地址：https://github.com/ikuaitu/vue-fabric-editor
预览：https://ikuaitu.github.io/vue-fabric-editor/

项目中文名称是快图设计，英文名称为技术栈拼接的：vue-fabric-editor，使用 Vue3 + Fabric.js 开发的开源图片编辑器。

Fabric.js 是业界知名的Canvas工具库，它已经12岁了，在业界得到了广泛的应用和认可，可用于开发图片编辑、物联网组态、平面设计工具等场景。

本文以介绍插件架构开发经验为主题，不对Fabric.js 做过多介绍。

项目特点

插件化架构：可通过插件的形式进行扩展，定义快捷键、右键菜单、复用的API/Event。
简洁易用：拖拽式设计，让普通人轻松上手操作。
功能完善：PSD解析、辅助线、历史记录、渐变、自定义字体、裁剪等功能，满足轻量图片编辑需求。

可应用于自媒体/海报设计、平面设计、PPT、价签设计等场景，以下为项目的实际应用截图。

为什么要做插件化

项目最初使用vue2 + Fabric.js 开发，通过使用Vue2的 Provide/Inject 的 API方法，将Fabric.js 的 canvas对象注入到各个子组件当中。

看起来好像组件各司其职，也符合满足单一职责原则，实际上隐藏着很大的问题。

问题说明

如果要实现以下 2 个功能：

画布功能需要在导入源文件时储存画布尺寸变量，需要尺寸修改的 API 方法，其他组件可订阅尺寸修改事件。
自定义字体功能需要初始化时生成字体引用的 CSS 代码，需要在导入源文件前获取到所有使用的字体名称，并进行加载，加载完成后再进行源文件的的渲染。

在没有扩展规范的情况下，很有可能出现的情况是：

导入逻辑出现过多业务处理代码。
多个组件的订阅事件出现相互依赖。

一个功能的代码散落在各个组件中，扩展功能无规范，很多逻辑相互缠绕。

如果按照硬编码的方式实现，那么组件将会错综复杂，相互紧密耦合，修改一个微小功能都要梳理众多组件的影响范围。

根本原因

图片编辑器不同于Canvas库，需要有自己的生命周期Hook方法、API复用方法、事件订阅、快捷键/右键菜单绑定等功能，编辑器需要有明确的扩展规范。

Fabric.js是一个典型的 Canvas库，不满足也不应该处理这些需求，需要有一个原则来明确定义Canvas库与图片编辑器的关系。

如何实现插件化

要实现插件化，需要先明确关系与扩展规范，最后再按照设计去实现功能即可。

抽象分层

要解决扩展规范的问题，首先要明确编辑器与 Canvas 库的关系，用汽车来类比。

Canvas库为引擎：有很强的驱动能力，是汽车的核心，就像Fabric.js有很完善的绘制图像能力，是编辑器的核心。
Editor编辑器为底盘：围绕引擎在为汽车行驶提供更多功能和接口，比如方向盘驱动、轮子、减震、钥匙启动等，就像图片编辑器必要的辅助线、历史记录、右键菜单、快捷键等。
UI 框架为车壳：React/Vue + UI 组件就像车壳，只需要调用底盘提供的功能接口即可完成驱动。

这样的分层关系，能够让我们在开发时，更清晰的拆分功能应该放在哪里更合适，绘制能力给 Fabric.js，集成复用能力给底盘，而不是将所有逻辑一股脑的塞在组件里。

扩展规范

通过对历史逻辑的梳理，对编辑器做扩展需要生命周期Hook、API挂载、事件订阅、右键菜单扩展、快捷键绑定，一个编辑器的扩展功能应该内聚在一个文件中，而插件化架构更为合适，扩展规范也就明晰了。

生命周期
- 导入前
- 导入后
- 保存前
- 保存后
挂载 API
事件订阅
右键菜单扩展
快捷键绑定

引用插件：

  const canvas = new fabric.Canvas('canvas');// 编辑器初始化canvasEditor.init(canvas);// 引用插件canvasEditor.use(DringPlugin, { repoSrc: 'https://api.kuaitu.cc' });

插件化实现

接下来终于进入编码的环节，已经有很多成熟的库可以满足我们的功能需求，以下是我们用到的依赖库。

1. Editor对象

负责编辑器、插件、Hook的初始化，监听右键菜单并渲染所有插件内的menu方法，监听快捷键方法并所有插件内的绑定事件，主要逻辑见截图，详细实现逻辑见代码：
https://github.com/ikuaitu/vue-fabric-editor/blob/main/packages/core/Editor.ts

2. 主流程插件

ServersPlugin与其他插件不同，是作为主流程插件存在，与Editor对象同等重要，提供了Hook的顺序控制和基础API。

Hook控制：
https://github.com/ikuaitu/vue-fabric-editor/blob/main/packages/core/ServersPlugin.ts

3. 其他插件

编辑器其他插件可按需单独引入，统一放置在 plugin目录下：
https://github.com/ikuaitu/vue-fabric-editor/tree/main/packages/core/plugin

以上就是插件化的主要实现思路，具体细节逻辑可参见源码。

如何开发一个插件

插件以类的形式初始化，采用声明式编程的方式对外部暴露 API、事件、快捷键，所有需要使用的 API、事件、快捷键都需要在apis、events、hotkeys里声明。

Hook方法直接在插件内部按规范命名即可：

hookImportBefore
hookImportAfter
hookSaveBefore
hookSaveAfter

右键菜单可根据选中的元素类型进行判断，可增加分割线、二级菜单嵌套。

快捷键的扩展可根据点击事件的 keyCode、up/down 绑定对应的方法即可。

插件代码实例：

import Editor from './Editor';
type IEditor = Editor;class FontPlugin {public canvas: fabric.Canvas;public editor: IEditor;// 插件名称static pluginName = 'FontPlugin';// 挂载API名称static apis = ['downFontByJSON'];// 发布事件static events = ['textEvent1', 'textEvent2'];// 快捷键 keyCode hotkeys-jspublic hotkeys: string[] = ['backspace', 'space'];// 私有属性repoSrc: string;constructor(canvas: fabric.Canvas, editor: IEditor, config: { repoSrc: string }) {// 初始化this.canvas = canvas;this.editor = editor;// 可插入外部配置this.repoSrc = config.repoSrc;}// 钩子函数 hookImportAfter/hookSaveBefore/hookSaveAfter PromisehookImportBefore(json: string) {return this.downFontByJSON(json);}// 挂载API方法downFontByJSON() {//}// 私有方法 + 发布事件_createFontCSS() {const params = [];this.editor.emit('textEvent1', params);}// 右键菜单contextMenu() {const selectedMode = this.editor.getSelectMode();if (selectedMode === SelectMode.ONE) {return [null, // 分割线{text: '翻转',hotkey: '❯',subitems: [{text: t('flip.x'),hotkey: '|',onclick: () => this.flip('X'),},{text: t('flip.y'),hotkey: '-',onclick: () => this.flip('Y'),},],},];}}// 快捷键hotkeyEvent(eventName: string, { type }: KeyboardEvent) {// eventName：hotkeys中的属性 backspace、space// type：keyUp keyDown// code：hotkeys-js Codeif (eventName === 'backspace' && type === 'keydown') {this.del();}}// 注销destroy() {console.log('pluginDestroy');}
}export default FontPlugin;