Communitygithub.com

電影級捲軸互動網頁

設計並建構連續捲動耦合的互動式網頁體驗,包括電影敘事頁面、互動漫畫/編輯視覺、捲動驅動的產品展示或高轉換率的電子商務登陸頁面,並使用黏性 SVG/CSS 視區、彈簧-線性插值捲動物理、反應式 SVG 濾鏡以及精心編排的 6 階段軌道。

電影級捲軸互動網頁 是什麼?

此技能旨在創建零依賴、每秒 60 幀的連續捲動互動網頁體驗。其核心架構透過一個黏性視區 (sticky viewport) 與一個高達 700vh 的捲動軌道,將所有視覺元素(如鏡頭縮放、SVG 形變、粒子散射、物理風效、敘事文案)統一映射到一個標準化的捲動座標 (`position` in `[0, 1]`),實現流暢無縫的場景過渡。該技能支援兩種主要應用模式:分別針對敘事/漫畫的「物理與 SVG 引擎」模式,以及針對產品展示/電子商務的「電子商務適配指南」模式。開發者可以從提供的範本(如 `starter-template.html` 和 `ecommerce-product-showcase.html`)開始快速搭建。技能透過 `requestAnimationFrame` 驅動彈簧-線性插值 (spring-lerp) 循環來平滑化使用者滾動,並內建了 6 階段弧線 (6-Stage Arc) 的編排邏輯來組織內容章節。此外,文件中詳細列出了關鍵的 SVG 與 CSS 陷阱,例如 CSS `opacity` 與 SVG `setAttribute` 的衝突、SVG `transform` 與 CSS `transform-origin` 的兼容性等,幫助開發者避免常見錯誤。

相容平台~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 列)
  • 永遠不要只靠切換 class 來切換離散幻燈片。 改為透過 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 階段連續捲動框架,適用於任何主題。
  • 電子商務產品展示 — 使用此引擎建構的完整運作中奢華時計/硬體產品發布示範。

相關技能