聊一聊bpmn-js中的Viewer和Modeler

本篇文章首发于我的个人博客站,点击查看原文

通过之前对于bpmn-js的学习,可以完成一个基础的Bpmn编辑器(或者叫建模器)的显示和简单绘制,若需要做更多工作还需加强对其的内部实现的了解。通过使用我们可以知道bpmn-js中有两个比较重要的操作对象:bpmnViewerbpmnModeler

  • Viewer:一般习惯性对齐命名对象称之为bpmnViewer,这是bpmn-js提供的一个基础的bpmn流程图的查看器,其主要是用于控制流程图绘制的显示区域部分。
  • ModelerBpmn建模器,这是整个流程编辑的核心构成部分,负责流程图的构建编辑,也是我们操作较多的部分。

我们使用的常规逻辑:viewer负责展示,modeler负责构建。仔细查看bpmn-js的实现可以看出Modeler我们可以理解成在Viewer上的一层扩展。

javascript 复制代码
// viewer 创建
var bpmnViewer = new Viewer({ additionalModules: [ extensionModule ] });

// Viewer源码:构造函数
export default function Viewer(options) {
  BaseViewer.call(this, options);
}

// modeler 创建
var bpmnModeler = new Modeler({ additionalModules: [ overrideModule ]});

// Modeler.js源码:构建函数
export default function Modeler(options) {
  BaseModeler.call(this, options);
}

// BaseModler.js源码:构建函数
export default function BaseModeler(options) {
  BaseViewer.call(this, options);

  // hook ID collection into the modeler
  this.on('import.parse.complete', function(event) {
    if (!event.error) {
      this._collectIds(event.definitions, event.elementsById);
    }
  }, this);

  this.on('diagram.destroy', function() {
    this.get('moddle').ids.clear();
  }, this);
}

上述代码可以看出无论是Viewer还是Modeler其构建核心都是由BaseViewer提供的,查看BaseViewer构建的options配置参数类型如下:

typescript 复制代码
// 构建参数
export type BaseViewerOptions = {
    width?: number | string; 
    height?: number | string;
    position?: string;
    container?: string | HTMLElement; // 绘制挂载父节点
    moddleExtensions?: ModdleExtensions; // 格式定义,通常适用于描述Activiti、flowable、camunda的描述文件
    additionalModules?: ModuleDeclaration[];// 扩展插件,这是bpmn-js中的核心功能
} & Record<string, any>;


// 默认参数
const DEFAULT_OPTIONS = {
  width: '100%',
  height: '100%',
  position: 'relative'
};

Modeler就是基于additionalModules功能给BaseViewer扩展了编辑建模功能,它扩展了Palette、AutoPlace、ContextPad、Move、Modeling等等模块来组件成一个建模器,这也是Bpmn-js留给开发人员扩展插件的入口,原则上可以完全由开发者自定义实现。

typescript 复制代码
// additionalModules 扩展支持插件格式
export type ModuleDeclaration = {
  [name: string]: ServiceDeclaration<unknown> | unknown;
  __init__?: Array<string|InitializerFunction>;
  __depends__?: Array<ModuleDeclaration>;
  __exports__?: Array<string>;
  __modules__?: Array<ModuleDeclaration>;
};

如下为Modeler中的内置扩展模块,又或者叫建模组件:

  • AlignElements:这是几个元素对齐方式功能的插件的集合,包含contenxtpad部分、bpmn图形图像部分、popupMenu部分。
  • AutoPlacebpmn元素自动放置行为插件
  • AutoScroll:这个是使用的diagram-js中的auto-scroll特性功能插件
  • AutoResizeBPMN特定的调整大小行为
  • ContextPadBPMN特定的上下文填充提供程序【即元素选择右侧快捷面板操作区域】。
  • CopyPasteBPMN中的复制粘贴功能
  • DistributElements:为当前不支持分发的元素注册元素排除筛选器
  • EditorActions:注册并执行BPMN特定的编辑器操作。
  • GridSnapping:追踪网格移动事件,本质就是一个eventbus的监听器插件
  • InteractionEventsBPMN特定的命中区域和交互修复。
  • Keyboard:键盘绑定插件
  • LabelEditingBPMN流程图元素SVG中绘制label的展示和编辑插件
  • Modeling:这是BPMNModeler的核心功能插件,实现modeler的主要功能:更新编辑
  • Palette:这是Modeler的工具栏区域,用于提供可绘制的BPMN元素来绘制BPMN流程图
  • ReplacePreview:替换上下文中所有可替换元素的视觉效果
  • Search:提供搜索BPMN元素的功能,不一定能用得到。

还有几个使用didi或者是diagram-js中的自带功能插件不一一介绍了,若有需要会另外提及。本篇文章先整体对bpmn-js中的模块做一个了解,后续会根据功能需要对其中的单个功能一一介绍使用以及如何扩展我们需要的定制功能。

相关推荐
开心工作室_kaic24 分钟前
ssm161基于web的资源共享平台的共享与开发+jsp(论文+源码)_kaic
java·开发语言·前端
刚刚好ā24 分钟前
js作用域超全介绍--全局作用域、局部作用、块级作用域
前端·javascript·vue.js·vue
沉默璇年2 小时前
react中useMemo的使用场景
前端·react.js·前端框架
yqcoder2 小时前
reactflow 中 useNodesState 模块作用
开发语言·前端·javascript
2401_882727572 小时前
BY组态-低代码web可视化组件
前端·后端·物联网·低代码·数学建模·前端框架
SoaringHeart2 小时前
Flutter进阶:基于 MLKit 的 OCR 文字识别
前端·flutter
会发光的猪。3 小时前
css使用弹性盒,让每个子元素平均等分父元素的4/1大小
前端·javascript·vue.js
天下代码客3 小时前
【vue】vue中.sync修饰符如何使用--详细代码对比
前端·javascript·vue.js
猫爪笔记3 小时前
前端:HTML (学习笔记)【1】
前端·笔记·学习·html
前端李易安3 小时前
Webpack 热更新(HMR)详解:原理与实现
前端·webpack·node.js