电影级滚动交互网页技能
构建零依赖、60fps的连续滚动交互式网页体验,其中每个视觉层——相机缩放、SVG变形、粒子散射、风物理和叙事/销售文案——都共享一个归一化的滚动坐标(position in [0, 1])。
架构概览
每个页面都遵循一个位于高滚动轨道内的四层粘性舞台:
#track (高度: 700vh, 创建自然滚动距离)
└── #viewport (position: sticky; top: 0; height: 100vh; overflow: hidden)
├── #sky / 环境背景层 (颜色与氛围插值)
├── #world (独立舞台: 英雄中心元素, SVG滤镜, 粒子, 氛围)
├── #rail (position: absolute; N个堆叠的100vh章节连续平移)
└── #texture / HUD (#bar, #meter, #guide, 电商粘性CTA栏)
- 切勿仅靠CSS类切换离散幻灯片。 通过
translate3d(0, ${-position * (N - 1) * innerHeight}px, 0)驱动#rail,并使用smoothstep (smooth(a, b, position)) 插值所有场景过渡。 - 保持
#world和#rail不阻塞 (pointer-events: none),除非是显式交互元素 (#overlay button, 款式切换器, 购买/购物车CTA),这些必须设置pointer-events: auto和更高的z-index。
构建工作流
- 选择领域模式:
- 故事讲述 / 漫画: 遵循 物理与SVG引擎 并从 starter-template.html 开始。
- 产品展示 / 电商: 遵循 电商适配指南 并研究 ecommerce-product-showcase.html。
- 设计分层英雄SVG:
- 在单个归一化的
viewBox内构建英雄中心元素(角色、徽章或产品硬件),并使用命名的<g>图层,以便各个子部件可以独立旋转、爆炸分离、缩放或交换颜色。
- 在单个归一化的
- 连接弹簧-插值循环 (
requestAnimationFrame):- 计算
target = clamp(-track.getBoundingClientRect().top / maxScroll, 0, 1)。 - 缓和
position += (target - position) * 0.115并推导平滑的speed和受限的impulse(wind),以便快速滚动自然驱动布料、头发、粒子和SVG位移滤镜。
- 计算
- 编排6阶段弧线:
- 将
0.00 -> 1.00映射到6个均匀分布的100vh.chapter部分(从top: 0到top: 500vh)。 - 将渐进式缩放 (
scale) 和图层交叉淡入淡出 (smooth(a, b, position)) 与简洁的.caption卡片以及顶部的#bar+#meterHUD配对。
- 将
- 发布前验证:
- 通过本地HTTP提供服务,并测试
00%、25%、50%、75%和100%滚动位置。 - 确认交互式叠加层 (
#enter)、变体选择器和粘性CTA保持可点击 (pointer-events: auto)。 - 确认零控制台错误、明亮焦点元素上的文本对比度可读,以及在桌面端 (
1280x800) 和移动端 (390x844) 视口下清晰的构图。
- 通过本地HTTP提供服务,并测试
关键SVG与CSS陷阱
构建SVG密集型滚动页面时,需避免以下常见故障模式:
- CSS
#id { opacity: 0 }会阻塞setAttribute('opacity', ...): CSS中的ID选择器会覆盖SVG呈现属性。要么在CSS中省略opacity: 0(一开始使用SVG属性opacity="0"+setAttribute('opacity', ...)),要么在JS中更新el.style.opacity。 - SVG
transform属性忽略CSStransform-origin:transform-box: fill-box; transform-origin: ...仅适用于CSSel.style.transform。对于SVGsetAttribute('transform', ...),需要明确围绕中心(cx, cy)包装旋转/缩放:translate(cx cy) rotate(deg) scale(s) translate(-cx -cy)。 - 使用三次贝塞尔曲线 (
C) 而非尖角楔形: 对于有机头发、丝带、布料、烟雾或液体轨迹,避免使用三角形的L尖角和大的CSSskewX变形。使用正弦波偏移沿着phase和受限wind平滑动画化三次贝塞尔控制点。 - 锁定英雄包装器宽高比至
viewBox: 为英雄SVG容器指定aspect-ratio: <W>/<H>; height: auto;(而不是混合独立的vw和vh尺寸),以便transform-origin缩放坐标在所有屏幕尺寸上保持锁定在目标上。 - 防止屏幕中间的氛围接缝:
不要沿着一条水平的直线(
L1440 490 ... Z)并带有可见描边来闭合屏幕中间的雾/薄雾<path>形状。使用stroke: none,并在视口下方平滑地闭合云带,或使用起伏的底部曲线。 - 保护发光焦点区域上的文本对比度:
在大型显示标题上应用分层深色投影 (
text-shadow),在说明文字上应用深色半透明卡片 (backdrop-filter: blur(4px)),以确保文案即使在明亮的月亮、辉光或金属产品高光上经过时也保持清晰可读。