Canvas-Editor 中控件 ID 管理的最佳实践

在 Canvas-Editor 项目中，控件 ID 的管理是一个需要特别注意的技术细节。许多开发者在调用 executeSetControlProperties 方法修改控件属性时，可能会发现控件的 ID 会自动发生变化，这给需要持久化存储控件 ID 的场景带来了困扰。

控件 ID 的两种类型

Canvas-Editor 中的控件实际上有两种不同的 ID：

1. 内部 ID：这是系统自动生成的 ID，可能会在控件属性修改时发生变化
2. 概念 ID (conceptId)：这是用户自定义的 ID，专门设计用于持久化存储场景

为什么内部 ID 会变化

当调用 executeSetControlProperties 方法时，Canvas-Editor 可能会重新生成控件的内部 ID，这是框架内部实现的一种机制。这种设计主要是为了：

• 确保控件状态的完整性
• 维护控件之间的引用关系
• 实现撤销/重做功能的需要

解决方案：使用 conceptId

对于需要持久化存储控件标识的场景，开发者应该使用 conceptId 而非自动生成的 ID。conceptId 具有以下特点：

• 由开发者显式设置
• 不会随控件属性修改而改变
• 专门为需要稳定标识的场景设计

实际应用建议

在实际开发中，建议采用以下模式：

// 创建控件时设置 conceptId
const control = {
  conceptId: 'my_stable_id_123',
  // 其他属性...
};

// 后续通过 conceptId 引用控件
editor.getControlByConceptId('my_stable_id_123');

这种模式可以确保即使在修改控件属性后，仍然能够通过稳定的 conceptId 找到并操作对应的控件。

总结

理解 Canvas-Editor 中控件 ID 的管理机制对于开发稳定可靠的编辑器应用至关重要。通过合理使用 conceptId，开发者可以避免因 ID 变化带来的问题，实现更健壮的编辑器功能。