Communitygithub.com

电影级滚动交互网页

设计和构建连续滚动交互式网页体验——包括电影叙事页面、交互式漫画/编辑视觉、滚动驱动的产品展示或高转化率的电商着陆页——使用粘性SVG/CSS视口、弹簧-插值滚动物理、反应式SVG滤镜和编排的6阶段轨道。

电影级滚动交互网页 是什么?

该技能专注于创建零依赖、60fps的连续滚动交互式网页体验。其核心架构基于一个四层粘性舞台,嵌入在较高的滚动轨道内。所有视觉层(如相机缩放、SVG变形、粒子散射、风物理和叙事文案)都共享一个归一化的滚动坐标(position in [0, 1])。技能支持故事讲述/漫画和产品展示/电商两种领域模式,并提供了详细的构建工作流,包括设计分层英雄SVG、连接弹簧-插值循环、编排6阶段弧线,以及关键的SVG与CSS陷阱指南。它适用于创建滚动触发式故事站点、高端产品揭幕、爆炸式微距缩放展示或连续单页销售体验,支持桌面和移动端。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TuanAnhPhan-pika/cinematic-scroll-skill/tree/main/cinematic-scroll-web

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

电影级滚动交互网页技能

构建零依赖、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。

构建工作流

  1. 选择领域模式:
  2. 设计分层英雄SVG:
    • 在单个归一化的 viewBox 内构建英雄中心元素(角色、徽章或产品硬件),并使用命名的 <g> 图层,以便各个子部件可以独立旋转、爆炸分离、缩放或交换颜色。
  3. 连接弹簧-插值循环 (requestAnimationFrame):
    • 计算 target = clamp(-track.getBoundingClientRect().top / maxScroll, 0, 1)。
    • 缓和 position += (target - position) * 0.115 并推导平滑的 speed 和受限的 impulse (wind),以便快速滚动自然驱动布料、头发、粒子和SVG位移滤镜。
  4. 编排6阶段弧线:
    • 将 0.00 -> 1.00 映射到6个均匀分布的 100vh .chapter 部分(从 top: 0 到 top: 500vh)。
    • 将渐进式缩放 (scale) 和图层交叉淡入淡出 (smooth(a, b, position)) 与简洁的 .caption 卡片以及顶部的 #bar + #meter HUD配对。
  5. 发布前验证:
    • 通过本地HTTP提供服务,并测试 00%、25%、50%、75% 和 100% 滚动位置。
    • 确认交互式叠加层 (#enter)、变体选择器和粘性CTA保持可点击 (pointer-events: auto)。
    • 确认零控制台错误、明亮焦点元素上的文本对比度可读,以及在桌面端 (1280x800) 和移动端 (390x844) 视口下清晰的构图。

关键SVG与CSS陷阱

构建SVG密集型滚动页面时,需避免以下常见故障模式:

  1. CSS #id { opacity: 0 } 会阻塞 setAttribute('opacity', ...): CSS中的ID选择器会覆盖SVG呈现属性。要么在CSS中省略 opacity: 0(一开始使用SVG属性 opacity="0" + setAttribute('opacity', ...)),要么在JS中更新 el.style.opacity。
  2. SVG transform 属性忽略CSS transform-origin: transform-box: fill-box; transform-origin: ... 仅适用于CSS el.style.transform。对于SVG setAttribute('transform', ...),需要明确围绕中心 (cx, cy) 包装旋转/缩放: translate(cx cy) rotate(deg) scale(s) translate(-cx -cy)。
  3. 使用三次贝塞尔曲线 (C) 而非尖角楔形: 对于有机头发、丝带、布料、烟雾或液体轨迹,避免使用三角形的 L 尖角和大的CSS skewX 变形。使用正弦波偏移沿着 phase 和受限 wind 平滑动画化三次贝塞尔控制点。
  4. 锁定英雄包装器宽高比至 viewBox: 为英雄SVG容器指定 aspect-ratio: <W>/<H>; height: auto;(而不是混合独立的 vw 和 vh 尺寸),以便 transform-origin 缩放坐标在所有屏幕尺寸上保持锁定在目标上。
  5. 防止屏幕中间的氛围接缝: 不要沿着一条水平的直线(L1440 490 ... Z)并带有可见描边来闭合屏幕中间的雾/薄雾 <path> 形状。使用 stroke: none,并在视口下方平滑地闭合云带,或使用起伏的底部曲线。
  6. 保护发光焦点区域上的文本对比度: 在大型显示标题上应用分层深色投影 (text-shadow),在说明文字上应用深色半透明卡片 (backdrop-filter: blur(4px)),以确保文案即使在明亮的月亮、辉光或金属产品高光上经过时也保持清晰可读。

参考资料与示例

  • 物理与SVG引擎 — 弹簧-插值数学、smooth()、反应式SVG滤镜、同心旋转、传播贝塞尔波和粒子散射公式。
  • 电商适配指南 — 将6章节弧线适配到产品发布、爆炸视图、颜色切换、规格标注和粘性购买栏。
  • 入门模板 — 适用于任何主题的干净6阶段连续滚动框架。
  • 电商产品展示 — 使用此引擎构建的完整工作的高端钟表/硬件产品发布演示。

相关技能