在 LogicFlow 里做子流程,本质是把一组相关节点用 group 节点框起来,形成一个可整体移动、可复用的单元。很多新手直接把子图平铺进主图,节点越堆越多,连线乱成一团,后续几乎没法维护。本文先给结论:LogicFlow 实现子流程主要有三种做法——用内置 group 分组、用自定义节点封装、用子画布隔离状态;先看清数据回流、坐标偏移、事件透传这三个坑,能少走大量弯路。下面从最小示例讲起,覆盖每种做法的适用场景、边界与失败处理,帮你按需求选对方案,不被「看起来都差不多」的选项拖进重写。真正难的不是画几个节点,而是想清楚子流程与主图之间的职责边界,边界想清楚了,选型自然就收窄到一两种。

先看结论
先把结论摆清楚。LogicFlow 实现子流程没有标准答案,关键看你的子流程要不要被主图感知、要不要独立编辑、数据要不要回流。第一种用 group 节点框选,配置最省,但子节点仍是主图的一部分;第二种用自定义节点封装,对外只露一个锚点,内部逻辑自己管;第三种用子画布,子流程有独立坐标系和事件,最彻底但要处理数据同步。选型口诀:能分组就别自定义,能自定义就别开子画布。配合 Vue.js 入门教程 理解组件化思路,你会发现子流程本质就是「把一块图当成一颗大节点」,用 Vue 组件去渲染它就能复用整套交互。
前置:已装好 LogicFlow 依赖;操作:按 group → 自定义节点 → 子画布三步试;验证:导出 JSON 看子节点是否独立;失败处理:id 冲突就加前缀、状态串了就收口到 node.data。
一、用 group 节点做分组复用
最快的路径是用内置 group 节点。它不改变节点的归属,只是把若干个节点视觉上框成一个整体,拖拽时一起动,导出时每个子节点还是独立 id。适合「几个节点经常一起出现、但逻辑上仍是平级」的场景,比如把「审核—通过—驳回」三个步骤框成一组,方便整体搬运。
lf.render({
nodes: [
{ id: 'n1', type: 'rect', x: 100, y: 100, text: '开始' },
{ id: 'g1', type: 'group', x: 80, y: 60, text: '子流程A' }
],
edges: []
});
lf.setNodeGroup('n1', 'g1'); // 把 n1 收进 group
需要注意的是,group 只是分组,不隔离数据。如果你在子节点上存了状态,主图照样能读到,多个子流程之间也不会自动隔离。所以 group 适合简单复用,一旦子流程内部有独立状态,就该升级到自定义节点。坐标体系可参考 WebGL 速查手册 里的视口与变换思路,理解 group 的内外坐标如何换算。

另外,group 的包围盒是自动算的,如果子节点被动态增删,要手动调 group 的宽高或用 fitView 重新适配。新手常犯的错是手改了子节点 id,结果和主图其它节点冲突,导出后关系错乱。性能上,group 本身几乎零开销,因为它只是给节点加了个视觉容器,不会新增渲染层;但当单个 group 内节点超过几百个、且频繁整体拖拽时,建议配合局部重绘而不是全量 render,否则大图会卡。
二、用自定义节点封装子流程
当子流程内部逻辑复杂、又希望主图保持干净时,自定义节点是更优解。LogicFlow 允许你参考 Java Web 教程 里的后端分层思想,把子流程画进一个自定义节点的内部视图:对外只暴露一个入口锚点和若干参数,内部用独立的状态管理维护。换句话说,主图只看到一个矩形,双击才展开内部细节。
具体做法是注册一个 type 为 subflow 的自定义节点,节点组件内部再挂一个迷你 LogicFlow 实例或纯 SVG 画布。主图只看到这个节点,双击才展开内部。这里的状态管理必须自闭环:子流程的输入参数从节点 data 拿,输出写回 node.data,绝不偷偷读写主图全局。否则多个子流程实例会共享同一份状态,出现串数据。
import { RectNode, RectNodeModel } from '@logicflow/core';
class SubflowNode extends RectNode {}
class SubflowModel extends RectNodeModel {
getNodeStyle() {
return { ...super.getNodeStyle(), stroke: '#7c5cff' };
}
}
这种写法的边界是:自定义节点内部是黑盒,主图无法知道它连了哪些线,调试时要进节点内部看。同时它和 Mobile Web 笔记 里提到的跨端渲染一样,要自己处理事件透传——子流程内部的点击、拖拽不能直接冒泡到主图。失败处理上,建议给自定义节点加一个 onError 兜底:一旦内部数据校验失败,把节点描边变红并在主图抛出事件,避免黑盒 silently 出错。

三、用子画布隔离与数据回流
最彻底的用法是子画布:给子流程一个独立 LogicFlow 实例,拥有自己的坐标系、节点与事件,通过桥接节点和主图通信。它适合「子流程极其复杂、需要独立编辑、还要把结果回传主图」的场景,比如嵌套流程图、可复用的流程模板。代价是工程量最大,需要自己处理坐标偏移、id 前缀和撤销重做跨实例。
关键在数据回流。子画布编辑完,要把内部节点树合并回主图数据,而不是各存各的。常见做法是在子画布监听 change 事件,把变更通过桥接节点 push 给主图:
subLf.on('node:add', () => {
const data = subLf.getGraphData();
mainLf.updateAttributes(bridgeId, { subData: data });
});
边界是工程量大:坐标偏移要重算、id 要加前缀防冲突、撤销重做要跨两个实例。但换来的是真正的隔离——子流程怎么改都不影响主图,主图只认桥接节点上的汇总数据。选型时想清楚:你的子流程是「图的一部分」还是「另一个图」,前者用 group/自定义节点,后者才上子画布。用 JavaScript 入门教程 理解事件与状态边界,能少踩很多透传的坑。性能取舍上,子画布适合「少而精」的复杂子流程,如果一次性开几十个子画布实例,内存与事件监听会迅速膨胀,此时应改为单实例按需挂载。
实操检查清单
- 前置:先确认 LogicFlow 版本与节点体系,配置好可渲染的画布环境。
- 操作:按 group → 自定义节点 → 子画布三步试做,观察实际渲染与导出。
- 检查:导出 JSON 看子节点是否独立,预期与选型一致。
- 失败处理:若 id 冲突或状态串号,按「节点 id 加前缀 → 状态收口到 node.data」逐条修复并重新验证。
- 适用边界:能分组就别自定义,能自定义就别开子画布,性能敏感场景慎用多实例。
总结
回到开头:LogicFlow 实现子流程按隔离程度三选一。能分组复用用 group,要黑盒封装用自定义节点,要彻底隔离用子画布。三个坑贯穿始终:group 改 id 串号、自定义节点状态没隔离、子画布数据没回流。先想清楚子流程要不要被主图感知、数据要不要回流,再动手能省掉大量返工。把边界想清楚,选型就不再是玄学,而是一道可推演的工程题。
常见问题
Q:group 节点改了内部 id 为什么主图乱了?
group 不隔离数据,子节点 id 和主图共用命名空间。手改 id 容易和主图冲突,导出后关系错乱。正确做法是 id 全局唯一,或子流程用带前缀的 id,例如 subA_node_1。
Q:自定义节点内部状态怎么避免串数据?
把子流程状态收口在节点自己的 data 里,输入输出都走 node.data,绝不直接读写主图全局 store。多个实例各自独立,互不干扰。
Q:子画布数据怎么回传主图?
在子画布监听 change,把内部图数据通过桥接节点 updateAttributes 写回主图。注意 id 加前缀、坐标重算,避免和主图冲突。
Q:三种方案能组合使用吗?
能,而且常见。比如主图用 group 做粗粒度分组,局部复杂块用自定义节点封装,最独立的子流程才开子画布。组合时记住一条原则:隔离程度从低到高按需升级,别一上来就上最重的子画布,否则维护成本翻倍。

TRAE-AI编程



