用途:指导在网页与框架项目中集成 Three.js,覆盖响应式 HTML、Next.js 等框架、滚动分区、覆盖层和多视图场景。
主要能力与做法:先检查项目的框架客户端/服务端边界、路由生命周期、层叠上下文与布局,再插入 canvas;渲染器只在浏览器生命周期中创建,不在服务端模块求值阶段访问 window 或 WebGL。用 CSS 预留稳定 canvas 区域并观察其容器;语义标题、控件、表单与可搜索产品信息保留在 HTML 中;加载、错误与降级状态沿用既有设计系统;非首屏的重型 3D 代码延迟加载。
交互与多视图:明确覆盖层与场景之间的指针路由,避免整页不可见 canvas 拦截链接或触摸滚动。场景锚定标签需投影世界坐标,并处理相机后方、遮挡、视口裁剪和可读放置。多个产品缩略图可考虑共享一个渲染器配合限定视口或静态预览,而非每卡片一个上下文;裁剪矩形与事件坐标须使用同一视图边界;离屏内容按实际运动需求暂停或失效。
限制与注意:路由清理需在异步加载和开发重挂载时保持安全;应验证页面滚动、浏览器缩放、嵌套滚动容器、布局偏移、离开再返回导航、减弱动效以及渲染失败时的内容可用性。API 的准确签名与版本相关行为以官方文档为准;无法查阅文档时,应检查已安装类型或源码,并说明仍存在的不确定性。具体安装命令与代码示例资料未提供。