前端通用交互式几何编辑器的开发经验

前端通用交互式几何编辑器:设计系列导读

1. 为什么写这套东西

做前端的人大多碰过"在地图上画点什么"的需求。画个点、连条线、圈一块区域,看起来不难,可真要把它做成能被业务系统集成、能被别人二次开发的编辑器,市面上能找到的工具却大多差着一口气:

  • 有的和一套界面深度绑定------编辑器长在自己的面板里,业务想换皮、想内嵌,动不了;
  • 有的只支持单一地图库------绑死 Leaflet 或 Cesium,换个场景就得重写;
  • 有的把绘制、编辑、撤销、图层树全堆在一起,改一处崩一片,越用越不敢动。

它们缺的不是功能,而是一种工程美学:让一个编辑器像库一样被信任------边界清晰、依赖单向、可组合、可替换、可长期维护。

于是有了这套 skill(geometry-interactive-editor)和这一系列文章。

github.com/maanfa/skil...

它们其实在做两件事:

  1. 提出适用场景:交互式几何编辑器不止"地图"------二维画布、三维场景、任意 canvas 几何编辑,都是它的舞台;它应当能跨库、无 UI、纯指令式地存在;
  2. 总结经验教训:这是我多年开发编辑功能踩坑、重构、被"集成需求"逼出来的设计取舍。如果能帮到读者和广大相关从业者少走弯路,那是对我的一种荣耀。

系列里没有玄学,只有"为什么这么分、什么时候可以不做"。

2. 整体设计一览

先看一张"总图",后续每篇都是对它的展开:

读图要点:

  • 虚线框 = 本设计交付的"可复用库"边界:宿主(上方)与地图库(下方)都在框外,库对它们只有两处接口------对外事件 / 指令式 API,以及坐标契约 / 渲染适配;
  • 外观类 Facade 是唯一入口:宿主只面对它;它装配一组控制器,其中热键、光标可选;
  • 绘制器 / 变更器通过策略模式组合能力 ,Element 经 Hoverable / Editable 标记获得"可悬停 / 可编辑"能力(图中未展开,见第 3、4 篇);
  • 适配器在最外层:实现坐标换算,把 core 翻译成具体地图库的渲染------这就是"库无关"的边界所在。

3. 两个经典流程

先剧透两个"最小闭环",感受一下宿主与库的交互长什么样(完整版见第 4、5 篇)。

画一个多边形:

sequenceDiagram actor U as 用户 participant F as Facade(外观类) participant D as Drawer(绘制器) participant A as MapAdapter(地图库适配器) U->>F: startDraw('polygon') loop 每点一个顶点 U->>D: leftdown(经鼠标管家) D->>D: 策略追加顶点 end U->>D: doubleclick 完成 D-->>F: draw:finished F->>A: updateElement(增量渲染)

拖一个顶点:

sequenceDiagram actor U as 用户 participant F as Facade(外观类) participant M as Modifier(变更器) participant A as MapAdapter(地图库适配器) U->>F: select(id) + startEdit(id) F->>M: 创建顶点手柄 U->>M: 拖拽手柄 M-->>F: edit:vertex-dragged F->>A: updateElement(增量渲染)

两处共有的味道:宿主只碰 Facade,绘制 / 编辑逻辑不直接碰地图库,渲染一律经适配器。

4. 系列篇目

5. 阅读顺序

1 → 2 → 3 → 4 → 5 → 6 → 7。每篇独立可读,但后者会引用前者的概念;每篇末尾附"何时该用 / 何时不必"------因为好的设计,也懂得在不需要的地方停手。

6. 图例约定

文中图均为 mermaid:

  • flowchart:流程 / 数据流
  • sequenceDiagram:时序
  • stateDiagram:状态机

愿这套东西,能让某个深夜还在为"编辑器怎么被集成"发愁的同行,少一点纠结。

相关推荐
AAA修煤气灶刘哥10 小时前
同一个项目,为什么换个 Agent 又得从头解释?
后端·架构·代码规范
oil欧哟10 小时前
Oil UI 的设计思路与日常使用方式:让 AI 摆脱默认模板并保持多页面风格统一
前端
恋猫de小郭10 小时前
Jetpack Compose 1.13 发布,憋了这么久终有交代了
android·前端·flutter
头发还在的女程序员11 小时前
智慧物业源码解析:房屋档案与业主变更怎样保持历史业务连续
前端·javascript·vue.js·物业管理·小区物业·智慧物业
JianZhen✓11 小时前
电商 SKU 选择器:后端只给扁平列表,前端怎么反推规格矩阵并做到 O(1) 命中
前端·矩阵·状态模式
谙弆悕博士11 小时前
多智能体架构详解:网状去中心化架构(Mesh对等P2P)
人工智能·架构·去中心化·p2p·多智能体·智能体·langgraph
feixing_fx19 小时前
第一个 JS 程序:在浏览器控制台和 Node 中分别运行
开发语言·前端·javascript·前端框架·ecmascript
feixing_fx20 小时前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
微订校园外卖系统1 天前
自己做校园外卖跑腿小程序用什么系统:多商户与单店架构
小程序·架构·外卖系统·本地生活·微订
JavaGuide1 天前
Cloudflare 开源的这套神级安全审计 Skill 太好用了!
前端·后端