bpmn-js系列-自定义Palette工具(二)
前面文章介绍了bpmn-js的基本使用本篇介绍对左侧工具栏的自定义修改。自定义Palettebpmn-js默认的Palette有不怎么用的项目要求左侧把常用的展示出来所以我们只能自定义写个新的来代替默认的Palette。以下代码基于搭建好的React v18项目和引入了bpmn-js语法可根据自己项目修改1. 创建customBpmn文件夹在customBpmn文件夹下新建custom文件夹和index.tsx文件在custom文件夹下新建CustomPalette.tsx和index.tsx文件。最终目录结构如下图所示2. custom/CustomPalette.tsx文件内容如下:import { assign } from min-dash; export default function PaletteProvider( palette, create, elementFactory, handTool, lassoTool, spaceTool, globalConnect, translate ) { this.create create; this.elementFactory elementFactory; this.handTool handTool; this.lassoTool lassoTool; this.spaceTool spaceTool; this.globalConnect globalConnect; this.translate translate; palette.registerProvider(this); } PaletteProvider.$inject [ palette, create, elementFactory, handTool, lassoTool, spaceTool, globalConnect, translate ]; PaletteProvider.prototype.getPaletteEntries function (element) { const { create, elementFactory, handTool, lassoTool, spaceTool, globalConnect, translate } this; function createAction(type, group, className, title, options?: any) { function createListener(event) { var shape elementFactory.createShape(assign({ type: type }, options)); if (options) { shape.businessObject.di.isExpanded options.isExpanded; } create.start(event, shape, { hints: { autoSelect: [ shape ] } }); } var shortType type.replace(/^bpmn:/, ); return { group: group, className: className, title: title || translate(Create {type}, { type: shortType }), action: { dragstart: createListener, click: createListener } }; } return { lasso-tool: { group: tools, className: bpmn-icon-lasso-tool, title: Activate the lasso tool, action: { click: function (event) { lassoTool.activateSelection(event); } } }, tool-separator: { group: tools, separator: true }, create.start-event: createAction( bpmn:StartEvent, event, bpmn-icon-start-event-none, 开始事件 StartEvent ), create.end-event: createAction( bpmn:EndEvent, event, bpmn-icon-end-event-none, 结束事件 EndEvent ), create.task: createAction( bpmn:Task, activity, bpmn-icon-task, 任务 Task ), create.service-task: createAction( bpmn:ServiceTask, activity, bpmn-icon-service-task, 服务任务 ServiceTask ), create.script-task: createAction( bpmn:ScriptTask, activity, bpmn-icon-script-task, 脚本任务 ScriptTask ), create.receive-task: createAction( bpmn:ReceiveTask, activity, bpmn-icon-receive-task, 接收任务 ReceiveTask ), create.subprocess-collapsed: createAction( bpmn:SubProcess, activity, bpmn-icon-subprocess-collapsed, 子流程(折叠) SubProcess(collapsed), {isExpanded: false} ), create.subprocess-expanded: createAction( bpmn:SubProcess, activity, bpmn-icon-subprocess-expanded, 子流程(展开) SubProcess(expanded), {isExpanded: true} ), create.call-activity: createAction( bpmn:CallActivity, activity, bpmn-icon-call-activity, 调用活动 CallActivity ), create.exclusive-gateway: createAction( bpmn:ExclusiveGateway, gateway, bpmn-icon-gateway-xor, 排他网关 ExclusiveGateway ), create.parallel-gateway: createAction( bpmn:ParallelGateway, gateway, bpmn-icon-gateway-parallel, 并行网关 ParallelGateway ), create.inclusive-gateway: createAction( bpmn:InclusiveGateway, gateway, bpmn-icon-gateway-none, 包容网关 InclusiveGateway ), }; };Platte展示的shape就是最后return输出的那个字典数据定义的一个shape对应的数据格式如下create.start-event: { group: event, className: bpmn-icon-start-event-none, title: 开始事件 StartEvent, action: { click: function (event) { var shape elementFactory.createShape({ type: bpmn:StartEvent }); create.start(event, shape, { hints: { autoSelect: [ shape ] } }); }, dragstart: function() {...} } }其中key为这个shape的名称value为这个shape定义的一些属性主要有四个group 定义shape属于哪个组主要有tools、event、gateway和activity可以选择className 定义shape的chass名称可以通过这个class给shape指定具体的样式title 定义shape的title也就是鼠标移动到shape上的提示action 用户操作时触发的事件通过这个数据我们就可以随意添加、删除或者修改Palette的shape了3. custom/index.tsx中将Palette导出import CustomPalette from ./CustomPalette; export default { __init__: [paletteProvider], paletteProvider: [type, CustomPalette], };4. customBpmn/index.tsx 中编写自定义的CustomModeler类import inherits from inherits; import Modeler from bpmn-js/lib/Modeler; import CustomModule from ./custom; function CustomModeler(options) { Modeler.call(this, options); this._customElements []; } inherits(CustomModeler, Modeler); CustomModeler.prototype._modules [].concat(CustomModeler.prototype._modules, [ CustomModule ]); export { CustomModeler };5. 在bpmn组件中引用自定义的CustomModeler来替换原本引用的BpmnModelerimport React, { useEffect, useRef, useState } from react; import BpmnModeler from bpmn-js/lib/Modeler; //默认引入 import { CustomModeler } from ./customBpmn; //自定义引入 import bpmn-js/dist/assets/diagram-js.css; import bpmn-js/dist/assets/bpmn-font/css/bpmn.css; import bpmn-js/dist/assets/bpmn-js.css; import { defXmlStr } from ./xmlStr; import ./styles.less const BpmnModelerWidget ({ initialXml, onSave }) { const containerRef useRef(null); const modelerRef useRef(null); const [xml, setXml] useState(); const [error, setError] useState(null); useEffect(() { // 初始化建模器 // modelerRef.current new BpmnModeler({ //默认左侧Palette modelerRef.current new CustomModeler({ //自定义左侧Palette !!!重要修改------- container: containerRef.current }); // 加载初始XML if (initialXml) { loadDiagram(initialXml); } else { createNewDiagram(); } // 监听变化 modelerRef.current.on(commandStack.changed, async () { try { const { xml: newXml } await modelerRef.current.saveXML({ format: true }); setXml(newXml); } catch (err) { console.error(Failed to save XML, err); } }); return () { modelerRef.current?.destroy(); }; }, []); const loadDiagram async (xml) { try { await modelerRef.current.importXML(xml); const canvas modelerRef.current.get(canvas); canvas.zoom(fit-viewport); setError(null); } catch (err) { setError(Failed to load diagram); console.error(err); } }; const createNewDiagram async () { const newDiagram defXmlStr(New_Process, New Process) await loadDiagram(newDiagram); }; return ( div classNamebpmn-modeler div idcanvas classNamemodeler-container ref{containerRef} / /div ); }; export default BpmnModelerWidget;最终效果如图配置源码使用的时候可以直接查看源码bpmn-js/lib/features/palette/PaletteProvider.js和bpmn-js/lib/features/context-pad/ContextPadProvider.js文件进行自定义修改。对于部分类型需要添加options选项如上例中的子流程 bpmn:SubProcess代码仓库完整代码已上传至https://gitee.com/z-beast/bpmn-logic-flowchart

相关新闻

COSMO-RS 实操:从量子力学到热力学性质的“无参”预测之路

COSMO-RS 实操:从量子力学到热力学性质的“无参”预测之路

COSMO-RS 实操:从量子力学到热力学性质的“无参”预测之路 摘要:在化工热力学与药物设计中,COSMO-RS(Conductor-like Screening Model for Real Solvents)被视为连接微观量子化学与宏观相平衡的“圣杯”之一。不同于传统的基团贡献法(如UNIFAC),COSMO-RS不依赖大量的实…

2026/11/14 16:12:33 阅读更多 →
Vue Query Builder高级技巧:提升查询构建体验的7个方法

Vue Query Builder高级技巧:提升查询构建体验的7个方法

Vue Query Builder高级技巧:提升查询构建体验的7个方法 【免费下载链接】vue-query-builder A UI component for building complex queries with nested conditionals. 项目地址: https://gitcode.com/gh_mirrors/vu/vue-query-builder Vue Query Builder是一…

2026/11/14 17:37:24 阅读更多 →
Unity TMP_SDF 分析(三)顶点着色器中的屏幕空间缩放

Unity TMP_SDF 分析(三)顶点着色器中的屏幕空间缩放

Unity TMP_SDF 分析(三):顶点着色器中的屏幕空间缩放适用版本:Unity 2021.3.23f1c1|TextMeshPro 3.0.9|UGUI 1.0.0 分析范围:项目中的标准 Assets/TextMesh Pro/Shaders/TMP_SDF.shader 及其关联…

2026/11/6 16:58:16 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/17 8:22:52 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/17 12:46:04 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/17 12:46:04 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/17 11:26:33 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/17 12:46:05 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/17 12:46:05 阅读更多 →

日新闻

周新闻

月新闻