threejs-html

Web 和框架集成

使用项目已安装的版本和现有架构。这些说明是对用户任务的补充，不授权进行无关更改或外部操作。

在插入画布前，检查框架的客户端／服务端边界、路由生命周期、层叠上下文和布局。仅在浏览器生命周期内创建渲染器。不要在服务端模块求值时访问 window 或 WebGL。

在 CSS 中为画布预留稳定的区域，并观察其容器。将语义化标题、控件、表单和可搜索的产品信息保留在 HTML 中。使用现有设计系统呈现加载、错误和回退状态。对于初始视图中不需要的 3D 代码，采用懒加载。

明确指定覆盖层与场景之间的指针事件路由。避免全页不可见画布拦截链接或触摸滚动。对于锚定在场景中的标签，投影世界坐标，并处理相机后方、遮挡、视口裁切和可读位置。

对于多个产品缩略图，可考虑使用带范围视口的共享渲染器或静态预览，而不是为每张卡片创建一个上下文。剪裁矩形和事件坐标必须使用相同的视图边界。根据实际的动画需求暂停或使视口外内容失效。

确保路由清理在异步加载和开发环境中的重新挂载期间安全。验证页面滚动、浏览器缩放、嵌套滚动容器、布局偏移、离开后返回导航、减少动态效果设置，以及渲染失败时内容仍可用。

API 参考

请查阅官方文档，确认准确的签名和特定版本的行为。如果无法访问文档，请检查已安装的类型定义／源码，并说明仍未确定的事项。