Canvas-Editor 中关于页面尺寸更新的注意事项

在 Canvas-Editor 项目中，开发者需要注意页面尺寸更新的正确方式。近期有用户反馈在使用 executeUpdateOptions 方法更新页面宽度和高度时出现了渲染异常问题，这实际上是由于对 API 使用方式的误解导致的。

问题现象

当开发者尝试通过 executeUpdateOptions 方法直接修改页面宽度和高度时，例如：

const res = instance.command.getValue();
res.width = 2000;
res.height = 2000;
instance.command.executeUpdateOptions({
  ...res
});

会导致页面渲染出现异常，表现为内容显示不正确或布局错乱。

原因分析

Canvas-Editor 的设计中，executeUpdateOptions 方法并不支持直接修改页面的宽度和高度属性。这个方法主要用于更新编辑器的一些配置选项，而不是用于调整页面尺寸。这是 API 设计的明确边界，目的是保持不同功能模块的职责清晰。

正确解决方案

要修改页面尺寸，应该使用专门设计的 executePaperSize 方法。这个方法专门用于处理页面尺寸的变更，能够确保页面布局的正确更新和重新渲染。

instance.command.executePaperSize(width, height);

最佳实践建议

1. 在使用 Canvas-Editor 的 API 时，建议先查阅相关文档，了解每个方法的适用场景和参数要求
2. 对于页面尺寸调整这种特定功能，优先使用专门设计的方法
3. 避免将不相关的配置参数混入到不支持的 API 调用中
4. 如果需要对编辑器进行多项配置更新，可以考虑分步调用不同的专用方法

总结

Canvas-Editor 提供了丰富的 API 来满足不同的编辑需求，但每个 API 都有其特定的用途和限制。理解这些边界并按照设计意图使用 API，可以避免出现渲染问题和其他异常情况。对于页面尺寸调整，请始终使用 executePaperSize 方法，这是最可靠和推荐的做法。