Konva.js 中 StageConfig 容器属性的可选性优化

Konva.js 作为一个强大的 2D 绘图库，既可以在浏览器环境中使用，也可以在 Node.js 环境下运行。然而，在 TypeScript 类型定义中，StageConfig 的容器(container)属性被标记为必需，这与实际使用场景存在一些差异。

问题背景

在 Node.js 环境下使用 Konva.js 时，通常不需要指定 DOM 容器，因为 Node.js 没有浏览器环境中的 DOM 结构。虽然文档中说明可以省略 container 属性，但 TypeScript 的类型定义仍然强制要求这个属性，导致类型检查错误。

技术实现

Konva.js 的核心 Stage 类在创建时需要配置信息，这些配置通过 StageConfig 接口定义。在浏览器环境中，container 属性是必需的，因为它指定了 Konva 画布要挂载到的 DOM 元素。但在 Node.js 环境中，这个属性可以被安全地忽略。

解决方案

通过将 StageConfig 接口中的 container 属性改为可选属性，可以更好地支持 Node.js 环境下的使用场景。这一改动不会影响浏览器环境中的使用，同时为 Node.js 用户提供了更好的开发体验。

interface StageConfig {
  container?: string | HTMLElement;
  // 其他配置属性...
}

实际影响

这一改动对现有代码的影响极小：

1. 浏览器环境中的使用不受影响，仍然可以正常指定 container
2. Node.js 环境中不再需要提供无意义的 container 属性
3. TypeScript 类型检查会更加准确

最佳实践

对于需要在不同环境中使用 Konva.js 的开发者，建议：

1. 明确区分浏览器和 Node.js 环境的使用场景
2. 在浏览器环境中始终提供有效的 container
3. 在 Node.js 环境中可以安全地省略 container
4. 使用环境变量或构建工具来管理不同环境的配置

这一改进体现了 Konva.js 对多环境支持的持续优化，使得库在不同运行时环境中的使用更加灵活和符合直觉。