HTML 流程图连线交叉看不清?聊聊画布避障折线与跳弧实现

1 阅读9分钟

上周把一个 18 页的中后台审批流画进原型画布时,我顺手把“风控复核”节点往右拖了 80 像素,又从列表页新增了一条驳回支线。结果刷新画布的一瞬间,三根连线直接斜穿过了中间两张页面卡片,另外两条横向和纵向的跳转线在中间叠成了十字路口,一眼根本分不清谁连向谁。

更让人崩溃的是,之前为了看清分支,我花十分钟手动拉直了两条绕行折线。结果这次只是在旁边加了一个新节点,全局排版脚本一跑,整张画布的卡片位置和那两条手调折线被全部推翻重算。

那天晚上我把这套画布连线拆开看,发现自己在流程图连线上踩的坑几乎都绕不开三件事:

  • 只画起止点直线,不避让卡片:连线直接从卡片肚子上穿过去,页面一多整张画布像一团乱麻;
  • 多条线交叉时没有任何视觉区分:两条线垂直相交,如果不画跳弧,评审时开发只能拿鼠标一条一条顺着往回摸;
  • 一改线就触发整张画布重排:新增一根连线或微调一个位置,就把用户原本排好的所有页面和手动折点全冲掉。

在用 HTML 和 JSON 维护产品原型画布时,怎么做到“自动避开卡片、交叉处清晰跳弧、同时绝不乱动用户手调的卡片和折线”?


一、根因剖析:为什么原型画布上的连线总是越画越乱?

复盘最近几个版本里画布路由(runtime/routing.mjs)的迭代踩坑,我发现画布连线难用往往卡在三个底层设计上:

  1. 只支持固定四边中点,逼着连线强行绕大圈:
    如果每张卡片只能从上、下、左、右正中心出发,当同一个列表页要连出 3 条分支时,3 根线全部挤在同一个中心点重叠,或者被迫绕到卡片背面才能贴边。
  2. 所有连线互相抢通道,没有“独立避障 + 交叉跳弧”的边界:
    有些连线算法会把其他线条也当成障碍物,改一条线连带交换另外十条线的端口,导致整张图每动一下就全屏闪烁跳变;反过来如果完全不管交叉,几十条线叠在一起又彻底丧失可读性。
  3. 不保留手调状态,重算路由直接覆盖全局布局:
    产品经理在评审前经常手动对齐页面卡片、拉出关键折点。只要工作台在新增连线或移动单个节点时顺手调用全局重排,前面的手工整理就会白费。

二、新旧模式对比:全局重排与死板直连 vs 元形 v0.5.1 画布路由方案

在开源原型工作台 元形 (yuanxing) v0.5.1 中,我把画布连线拆成了“独立避障路由 + 手动结果保留 + 交叉跳弧”三层职责:

对比维度传统连线方式(固定中点 + 全局重排)元形 (yuanxing) v0.5.1 画布路由方案
连线避障策略直接穿过卡片,或互相挤压导致全图端口交换每条线独立避开节点卡片,不以其他线为障碍,不乱改他线
交叉可读性多线垂直相交糊成一片,分不清流向交叉点自动绘制 r=6 半圆跳弧,邻近交叉合并为胶囊桥
端口锚定自由度只能连在四边正中,多分支重叠严重四向圆点磁吸 + 边框轮廓任意点连续吸附(fromAnchor / toAnchor)
手动调整保留动一下节点,之前手调的折点与文字位置全丢保留中间折点形态与 labelT,单侧移动只衔接端点邻段
整张画布稳定性每次连线触发全局布局重算,位置全乱不触发全局重排,仅重算端点改变或受影响的连线

三、实操落地:3 步搭建可避障、带跳弧的原型流程画布

在元形 v0.5.1 的项目中,画布布局和连线全部保存在 artifact/workbench.json 里,不绑定任何在线设计平台。按下面 3 步就能把一套复杂分支画布整理得清清楚楚。

第一步:在编排里声明边框相对锚点、线型与路径文字位置

打开 artifact/workbench.json,现在不需要把所有线死死绑在卡片中心,可以直接用 fromAnchor / toAnchor(边框相对坐标 [nx, ny])把多条分支错开挂在同一条边上,并按业务语义区分线型和文字位置 labelT:

{
  "nodes": [
    { "id": "list", "title": "订单列表", "kind": "html", "path": "pages/list.html", "x": 60, "y": 120, "width": 1280, "height": 800 },
    { "id": "audit", "title": "风控复核", "kind": "html", "path": "pages/audit.html", "x": 580, "y": 40, "width": 1280, "height": 800 },
    { "id": "reject", "title": "驳回补件", "kind": "html", "path": "pages/reject.html", "x": 580, "y": 400, "width": 1280, "height": 800 }
  ],
  "edges": [
    {
      "id": "to-audit",
      "from": "list",
      "to": "audit",
      "fromSide": "right",
      "toSide": "left",
      "fromAnchor": [1, 0.25],
      "toAnchor": [0, 0.5],
      "lineType": "polyline",
      "label": "提交复核",
      "labelT": 0.4
    },
    {
      "id": "to-reject",
      "from": "list",
      "to": "reject",
      "fromSide": "right",
      "toSide": "left",
      "fromAnchor": [1, 0.75],
      "toAnchor": [0, 0.5],
      "lineStyle": "dashed",
      "arrow": "end",
      "condition": "初审驳回"
    }
  ]
}

除了默认的圆角折线(polyline),数据结构还支持直线(straight)、三次贝塞尔曲线(curve)、虚线(dashed)以及单向/双向/无箭头(end | both | none)。在工作台里拖线时,靠近卡片四向连接点会自动磁吸,拖到边框其他位置则支持连续吸附,按住 Shift 还能锁定 45° 或 90° 方向。

第二步:利用独立避障与交叉跳弧,只重算受影响的端点邻段

启动本地可编辑工作台后,元形的路径计算层(runtime/routing.mjs)会配合内置 libavoid 路由做三件克制的事:

# 开源仓库: github.com/JasperLin2333/yuanxing | 一键安装: npx skills add JasperLin2333/yuanxing --skill yuanxing
# 开源原型工作台: github.com/JasperLin2333/yuanxing | 在线体验: jasperlin2333.github.io/yuanxing
# 一键安装 Skill: npx skills add JasperLin2333/yuanxing --skill yuanxing

# 启动或复用可编辑工作台(仅新启动服务时自动打开浏览器一次)
node "<Skill目录>/scripts/yuanxing.mjs" open --root "projects/order-audit" --reuse
  1. 单线独立避障,不扰动其余连线:新建或改接某条线时,只计算当前这一条路径,绝不因为改了 A 线而重新分配 B 线的端口;
  2. 跨线自动生成 r=6 半圆跳弧:当横线与纵线或两条折线必须交叉时,交叉点会自动绘制半径 6px 的平滑半圆跳弧;如果两条平行线挨得很近,邻近交叉还会自动合并成一段胶囊桥,视觉上立刻能看出谁压在谁上面;
  3. 保留手调 waypoints,单端移动只衔接邻段:选中连线后,拖动线段上的细长手柄就能手动微调折线(靠近同线其他拐点自动对齐,按 Alt 取消吸附),拖动线上文字则沿当前路径保存 labelT(靠近中点自动居中吸附)。之后再拖动其中一张卡片,工作台会尽量保持你手调的中间折点形态不变,只衔接贴近被移动卡片的首尾邻段。
第三步:在画布与离线分享之间保持同一套路由与坐标

所有画布手调位置、边框锚点、waypoints、labelT 和线上文字原地编辑(双击文字或选中连线按 Enter / F2 / 直接键入)都会自动保存,不会弹出全画布自动重排把页面打散。评审定稿后,导出单文件离线 HTML 即可完整带走相同的坐标与跳弧表现:

# 确认改动后导出单文件离线评审画布(内含流程画布、完整原型、交互式需求文档三视图)
node "<Skill目录>/scripts/yuanxing.mjs" export \
  --root "projects/order-audit" \
  --view review \
  --out "projects/order-audit/dist/review.html" \
  --replace

如果同时在用 Coding Agent 调整 artifact/workbench.json,记得先保存修改前的原始 JSON 作为基线,通过 apply --base ... --model ... 做三方合并,避免把工作台里刚手调好的页面坐标和连线折点覆盖掉。


四、时间账与协作收益对比

把画布连线从“凑合画条线”收敛成“独立避障 + 跳弧 + 锚点保留”之后,我整理复杂多分支原型的时间账变化很直观:

协同环节过去做法(固定中心端口 + 全局重排)现在做法(元形 v0.5.1 避障路由与跳弧)效率变化
多分支出线整理3 条线挤在卡片右侧中心点重叠,看不出各自起点fromAnchor 沿边框错开锚定,分支归属一目了然告别起点粘连
交叉连线核对十字交叉线分不清先后流向,评审现场来回指认r=6 半圆跳弧 + 邻近胶囊桥自动隔离交叉路径评审读图零歧义
局部加页改线加一个新节点就重排全图,手调布局全部报废仅重算受影响邻段,原页面位置与中间折点全保留省去重复摆图返工
线上文字调整删改线名要切右侧栏,拖标签容易飞到空白画布原地回车即改,文字严格沿当前路径滑动并居中吸附编辑与排版一步到位

总结

流程图画布最消耗精力的,往往不是最初画上去那几分钟,而是需求每改一轮,你就要把被自动排版打乱的卡片和互相打架的连线重新理一遍。

让每一条连线独立避开页面卡片、在交叉点用 r=6 跳弧交代层级、把边框锚点和手调折点稳稳留下来——工具只负责算清受影响的局部,把整体版面控制权还给画图的人,流程画布才真正经得起反复迭代。

开源原型工作台 元形 (yuanxing) 已更新至 v0.5.1,如果你也在用 Coding Agent 画中后台流程图与可交互原型,可以直接在项目目录装入试试:

# 一键安装元形 Skill 到当前 AI 助手工作区
npx skills add JasperLin2333/yuanxing --skill yuanxing

大家在画多分支产品流程图时,最头疼的是连线穿卡片、交叉看不清,还是每次改需求都被自动重排打乱布局?欢迎在评论区或 GitHub Issue 聊聊。