電影級捲軸耦合網頁技能
建立零依賴、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。
建構工作流程
- 選擇領域模式:
- 敘事 / 漫畫:請遵循 物理與 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: ...僅適用於 CSS 的el.style.transform。對於 SVG 的setAttribute('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)),讓文案即使在明亮的月亮、光暈或金屬產品亮點上方掠過時也能保持清晰可讀。
參考資料與範例
- 物理與 SVG 引擎 — 彈簧-線性插值數學、
smooth()、反應式 SVG 濾鏡、同心旋轉、移動的貝茲波以及粒子散射公式。 - 電子商務適配指南 — 將 6 章節弧線適配於產品發布、爆炸圖、配色切換、規格說明以及黏性購買列。
- 入門範本 — 乾淨的 6 階段連續捲動框架,適用於任何主題。
- 電子商務產品展示 — 使用此引擎建構的完整運作中奢華時計/硬體產品發布示範。