画布类应用的撤销重做应通过 Proxy 拦截 setter 实现自动化记录,仅对影响可视状态的字段生成路径+原值快照,结合上下文标记、微任务聚合与差分还原,确保颗粒合理、精准高效。

在画布类应用(如图形编辑器、流程图工具、低代码设计器)中,微任务粒度的撤销重做,不能依赖手动调用 push 或全局事件监听——而应通过拦截属性赋值行为,让每次关键状态变更自动入栈。Setter 属性正是实现这一自动化记录的核心机制。
用 Proxy + setter 封装可追踪状态对象
直接在原始对象上定义 setter 有局限(如无法动态代理新增属性),推荐用 Proxy 包裹状态对象,并在 set 拦截器中触发历史记录:
- 拦截所有写操作,但只对「影响画布可视状态」的字段(如
node.x、group.children、canvas.zoom)生成快照 - 快照不深拷贝整个对象,而是记录「变更路径 + 原值」,例如:
{ path: ['nodes', 'id-123', 'x'], oldValue: 100, newValue: 150 } - 将变更条目推入
historyStack,同时清空重做栈(因新操作使重做失效)
区分用户操作与程序内部更新
不是所有 setter 调用都该记入历史(比如动画插值、布局计算、响应式同步)。需引入上下文标记:
- 定义一个全局标志
isUndoableContext = true,默认开启 - 在非用户驱动的逻辑中(如
autoLayout()),临时设为false,setter 拦截器检测到后跳过记录 - 也可用函数装饰器方式:用
withHistory(() => { node.x = 200 })显式包裹需记录的操作
支持批量操作合并为单次历史项
拖拽节点时可能连续修改 x、y、rotation,若每改一次都入栈,会导致撤销颗粒过细。解决方案:
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
- 利用
Promise.resolve().then()或queueMicrotask()将多次 setter 延迟到微任务末尾统一聚合 - 维护一个待提交变更队列,在微任务清空前去重合并同路径变更(保留最终值),再生成一条历史项
- 用户松开鼠标时触发
commitHistory(),确保拖拽过程只记一次“移动节点”
撤销/重做时精准还原而非全量替换
历史栈存的是变更差分,还原时也应反向应用差分,而非替换整个对象(避免丢失未变更字段或破坏引用):
- 撤销时遍历历史项,按路径
set(obj, path, item.oldValue)恢复原值 - 重做时同理,设回
newValue - 路径解析支持数组索引(
['items', 0, 'label'])和嵌套对象(['config', 'theme', 'primary']),可用 Lodash 的set/get工具函数
不复杂但容易忽略:setter 自动化记录的关键不在“拦截”,而在“判断何时值得记”。聚焦用户意图、合并微小变更、隔离副作用更新,才能让撤销重做真正服务于交互直觉。










