FrontLaxWeb:視差與高階互動滾動
此檔案為「大腦」:方法論。食譜與程式碼片段存在
plantillas/中,並按需讀取。路徑plantillas/、references/、Designs/與Components/均相對於此檔案所在的資料夾。
此技能能達成什麼
將普通的登陸頁面轉換為網頁體驗:滾動與指針成為連續動畫的控制器。不受品牌限制:它接收每個專案的色彩/權杖。
七種效果(目錄)
- 平滑滾動(基礎): Lenis。讓一切感覺高階的基礎。
- 圖層視差: 慢速背景 / 快速前景 = 深度感。
- 滾動連結動畫: 屬性綁定到滾動百分比。
- 捲動觸發: 進入視口時觸發/動畫。
- 固定 / 釘選: 某個元素「釘住」,同時周圍內容變化(堆疊卡片)。
- 指針微互動: 3D 傾斜、自訂游標、懸停。
- 彈簧手勢: 拖曳、放開、輕觸:使用可中斷的彈簧物理,而非固定持續時間的 CSS 過渡。請參閱下方專屬章節。
手勢與彈簧(融合自 Emil Kowalski 的 apple-design 技能,WWDC 精華)
這是一個不同於上方滾動/視差的領域:它是關於觸碰與拖曳某物(選單、可滑動卡片、模態視窗、滑桿)的物理。最適用於網頁的可執行原則(來自原始 17 條;摘要請見 references/recetas-y-matriz.md §4bis):
- 可中斷性,17 條中最重要: 任何動畫都應能夠在中途被抓取並重新導向。對於使用者可以觸碰的所有事物,使用彈簧(參數:
damping/阻尼 +response/速度),絕不使用固定持續時間的 CSStransition:彈簧總是知道如何從其當前位置開始動畫,而固定過渡則不能。 - 速度傳遞: 放開手勢時,動畫會以手指的速度繼續(而非從零開始),從而避免視覺「接縫」。在 Motion 中:使用
dragMomentum加上來自PanInfo的 velocity 作為彈簧的初始速度。 - 橡皮筋效果: 在邊界處,提供漸進阻力,絕不硬性停止。
- 空間一致性: 從右側進入的面板應向右側退出;將
transform-origin錨定到觸發過渡的元件。 - 材質與深度: 浮動的半透明圖層(
backdrop-filter: blur())用於視覺層次,絕不直接堆疊兩個半透明表面。在無顯卡模式下,輕量模式會移除模糊效果:其半透明背景必須能單獨良好閱讀。 - 交叉驗證(非新食譜):其「幀級流暢度」規則與我們在「不可協商的基礎」中已有的規則完全相同(僅
transform/opacity):兩個獨立來源得出相同規則,因此更加可信。 - 背後的哲學(Apple 的 8 項基礎): 目的、自主性、責任、熟悉感、彈性、簡潔、工藝、愉悅(是前七項正確的結果)。這是 ethos,而非可實現的技術:用它來證明設計決策的合理性(「這是有目的還是噪聲?」),而非作為技術檢查清單。
✅ 已解決的衝突。 Apple 的第 14 條原則(使用 prefers-reduced-motion: reduce,以透明度淡入淡出取代動畫)曾與我們的原則(「為所有人,忽略該偏好」)直接衝突。最終找到了第三條路:動畫不會被關閉,只會降低幅度。 第 14 條原則既未被捨棄也未被複製:它被整合為同一個撥盤的極端情況(--motion-gain: 0 正好產生一個僅有淡入淡出的網站),因此無需維護每個效果的兩個版本。完整機制請見「我們的原則:動畫政策」(下方專屬章節)。
不可協商的基礎
- 效能: 僅動畫
transform與opacity(GPU)。絕不使用top/left/width/height/margin。審慎使用will-change、requestAnimationFrame,並避免佈局抖動。 - 無顯卡,輕量模式: 每個網站天生內建軟體繪圖檢測及其輕量模式(無 Lenis、無模糊或混合模式、3D 附帶其無 3D 版本)。請參閱下方專屬章節。
- 我們的原則:動畫政策: 每個專案必須遵守。緊接著有專屬章節,因為這是最常因疏忽而被違反的規則。
我們的原則:動畫政策(強制執行)
為所有人提供,但幅度適中。 沒有人會看到一個死氣沉沉的網站。根據訪客不同而改變的,不是是否有動畫,而是多少移動量。一個統一的撥盤控制整個網站:CSS 變數 --motion-gain,由 <head> 中的一個腳本設置在 <html> 上。
| 情境 | --motion-gain | 訪客看到的內容 |
|---|---|---|
| 預設 | 1 | 完整體驗。 |
系統設定 prefers-reduced-motion: reduce | 0.25 | 相同的設計,但移動量降為四分之一:動畫被解讀為強調,而非鏡頭移動。 |
URL 帶有 ?motion=off | 0 | 所有僅自行移動的內容都靜止不動,並移除 motion class。訪客用手指拖曳的內容仍然回應:一張不能滑動的可滑動卡片不是簡潔的介面,而是一張壞掉的圖片。這是不想要動畫的訪客的閥門,而非一種設計模式。 |
URL 帶有 ?motion=full | 1 強制 | 忽略系統偏好。用於在關閉 Windows 動畫效果的設備上檢查作品。 |
0.25 是預設值,可根據專案效果調整,但絕非 1:如果 reduce 時沒有任何變化,則表示你沒有套用此政策。
撥盤的三條規則
gain倍乘移動量:像素、縮放、旋轉、傾斜。對於連續效果(跑馬燈、循環),則倍乘速度。gain絕不倍乘透明度。淡入淡出不會讓任何人頭暈。因此,當調低撥盤時,效果不會中斷:它會降級。使用gain: 0.25的「俄羅斯套娃」效果仍然講述相同的故事,但以連鎖淡入淡出而非鏡頭縮放呈現。而這正是此政策無需為每個效果編寫第二個版本的原因,這也是第 14 條原則過去代價高昂的原因。gain不影響使用者驅動的運動:拖曳、懸停、指針傾斜、游標 lerp、手勢彈簧。內耳前庭不會因為自己引起的動作而抗議。它僅影響非自願的運動:視差、滾動縮放、俄羅斯套娃、序列 scrubbing、水平移動、速度傾斜、跑馬燈。
此外,始終:
4. 可見的閥門。 除了 ?motion=off,還應在介面(例如頁尾)提供一個可觸及的控制項。僅存在於 URL 中的閥門,需要它的人找不到。
5. 鍵盤焦點與錨點保持完整,且無需 JavaScript 即可閱讀內容(漸進增強)。
無障礙,嚴謹對待(針對 WCAG、MDN 與 web.dev 驗證,2026-08-19):
- 此政策中使其合規的部分不是撥盤,而是閥門。WCAG 2.3.3(AAA 級)要求能夠停用動畫,而不僅僅是減少;
?motion=off就是這個機制,因此它是強制且可發現的。一個只能縮小、沒有真正關閉功能的撥盤,無法滿足 2.3.3 的文字要求。 reduce下的0.25是一個起點,而非絕對值。真正令人頭暈的是大範圍運動(視差、縮放、大面積平移),而非透明度或小位移。精細規則:在reduce下,那些大範圍運動應降至接近零或替換為淡入淡出,而不是讓它「更小但仍然存在」。對於一個 16 像素的觸發效果,0.25 綽綽有餘;但對於一個 300 像素的視差,0.25` 仍然令人頭暈,需要更低的數值或直接改為透明度。這正是 MDN 和 web.dev 所支持的:「移除、減少或替換」。- WCAG 2.2.2「暫停、停止、隱藏」(A 級,強制執行,而非 AAA 級): 任何持續超過 5 秒的自動循環動畫(跑馬燈、背景影片、移動的漸層)必須提供暫停或停止的控制項,而撥盤不能取代它。如果你放入一個無限跑馬燈,請務必附帶一個單獨的暫停按鈕。
中央開關(直接複製到 <head>,在任何動畫 CSS 之前):
<script>
(function () {
var h = document.documentElement;
var q = new URLSearchParams(location.search).get('motion');
var reduce = matchMedia('(prefers-reduced-motion: reduce)').matches;
var gain = q === 'off' ? 0 : q === 'full' ? 1 : reduce ? 0.25 : 1;
h.style.setProperty('--motion-gain', String(gain));
h.classList.toggle('motion', gain > 0); // 相容性:動畫狀態掛在 html.motion 上
})();
</script>
在 CSS 中,用於 calc() 內部;在 JS 中,讀取一次並相乘:
const GAIN = parseFloat(getComputedStyle(document.documentElement)
.getPropertyValue('--motion-gain')) || 0;
無顯卡:輕量模式(每個新網站預設內建)
案例。 在一台硬體加速已關閉的電腦上(許多舊電腦或公司電腦常見),三個帶有動畫滾動的網站出現卡頓,而 cloudflare.com 則流暢。在 CPU 6 倍速且無顯卡、1920x1080 解析度下測量,計算實際到達螢幕的幀數:
| 網站 | 之前 | 啟用輕量模式後 | cloudflare.com (對照組) |
|---|---|---|---|
| SaaS(Lenis, 玻璃效果, 3D) | 1.7 幀/秒, 停頓 2.4 秒 | 27.5 與 0.13 秒 | 42.6 與 47 毫秒 |
| 作品集(Lenis, 模糊球體, 3D) | 4.6 與 372 毫秒 | 24.8 與 84 毫秒 | 45.3 與 49 毫秒 |
| 產品(無 Lenis;模糊雲朵, 疊加顆粒, 玻璃效果示範) | 30.1 與 260 毫秒 | 42.6 與 74 毫秒 | 46.5 與 46 毫秒 |
使用顯卡時,輕量模式不會啟用,且一切如常(在三個網站上逐像素驗證)。
原因。 沒有顯卡時,處理器需要承擔原本顯卡的工作:模糊、混合模式、3D 渲染以及合成每一幀。而使用 Lenis 時,滾動是由我們的程式碼在每一幀驅動:如果主執行緒每秒只能處理 5 幀,畫面就會以 5 幀的速度移動。瀏覽器的原生滾動由另一個執行緒處理,即使主執行緒繁忙也能保持流暢(這就是 cloudflare.com 表現良好的原因:它的程式碼每秒產生 2 幀,但螢幕更新率為 86)。
1. 檢測 (plantillas/react/dibujoPorSoftware.ts,或 plantillas/vanilla/modo-ligero.js):使用 getContext("webgl2"|"webgl", { failIfMajorPerformanceCaveat: true }) 請求一個 context;若回傳 null 則表示為軟體繪圖。如果獲得 context,則立即釋放它(使用 WEBGL_lose_context)。每次訪問僅執行一次,且必須在首次內容繪製 (LCP) 之後,絕不能在 LCP 之前。?ligero=1 強制啟用,?ligero=0 取消啟用;在同源的 <iframe> 內,也會檢查外部視窗的 URL。在 jsdom 和預渲染環境中,預設視為有顯卡。
2. 僅在上述檢測為真時:
- (a) 不啟動 Lenis:使用瀏覽器原生滾動,並以一個原生元件取代 Lenis,擁有相同的外觀(使用
smooth的scrollTo,透過<html>的overflow: hidden實現選單的stop/start,使用on("scroll")、animatedScroll)。此邏輯僅由plantillas/react/useLenis.ts(以及 Vanilla 中的arrancarScroll())處理。錨點和選單無需各自加上if判斷。不依賴window.lenis:Lenis 1.3 已將資料儲存在該處。 - (b)
<html data-ligero>與plantillas/vanilla/modo-ligero.css中的 CSS:backdrop-filter: none;一個使用filter: blur()的光暈會改為一個本來就已模糊的radial-gradient(透過scale屬性放大兩倍,這不會與視差的transform衝突);一個mix-blend-mode(例如 overlay 中的顆粒)會改為具有較低透明度的普通混合模式。外觀幾乎相同,且動畫效果依舊。 - (c) 3D:網頁中的每個
getContextWebGL 都必須使用failIfMajorPerformanceCaveat: true請求,這樣它就會自動回退到其無 3D 版本,而這個版本必須存在(一個圖片、平面的 Logo,或者如果原本只是背景裝飾,則什麼都沒有)。 - (d) 動畫,則不變。 我們的原則保持不變:為所有人提供動畫,調整幅度,而非關閉。而且已經過測量:在上面 SaaS 網站的例子中,移除動畫背景或暫停 CSS 動畫並未帶來改變(從 28 幀到 29-30 幀);在產品網站中,微粒子與光束光源也是如此。真正消耗效能的是 (a)、(b) 和 (c)。
3. 測量,而非猜測 (plantillas/medir-scroll-visible.mjs,從一個包含 playwright-core 的目錄執行):計算透過滾動操作實際到達螢幕的幀數(使用 Chrome 的螢幕輸出),而非 requestAnimationFrame 的幀數,因為後者在原生滾動下會產生誤導。始終進行兩次測量,並在同一輪中將 cloudflare.com 作為對照組:SIN_GRAFICA=1 node medir-scroll-visible.mjs <url> 3 6(在一台無顯卡的電腦上)以及不使用 SIN_GRAFICA、CPU 4 倍速(一台普通筆記型電腦)。無頭 Chrome(Lighthouse 使用的那種)是使用顯卡繪圖的:不適用於此測試。要找出罪魁禍首,請逐一移除元素,使用注入的 CSS(display: none, filter: none, mix-blend-mode: normal)並重新測量:正是這樣找出了產品表格中的雲朵(從 0.8 秒降至 0.35 秒直到首幀)、其顆粒和示範效果,同時也證明了其首頁的玻璃效果和微粒子對效能沒有影響。
有顯卡時的效能:五條適用於任何動畫滾動網站的規則
根據兩個真實網站的測量結果(其中一個,在 CPU 4 倍速下,慢速幀的處理時間從 580 毫秒降至 355 毫秒)。 沒有任何一條規則會停止或減慢動畫:它們移除的是看不見的工作。
- 不要在
animationend事件中使用getAnimations():這會強制重新計算整個頁面的樣式(在 4 倍速下約 50 毫秒,且常在滾動中途發生)。請計算元素的animationstart和animationend事件。 - 不要在滾動時暫停僅移動
transform/opacity的動畫:這些動畫在合成器執行緒上運行,暫停並不會節省資源,而且暫停和恢復每次滾動都會造成兩次大量的重新計算。 - 不要在滾動進行時「利用空閒時間」渲染章節:Lenis 會在幀之間留下空閒時間,
requestIdleCallback正好會在此時觸發。請等待滾動停止。 - 如果滾動每一幀的樣式沒有改變,就不要寫入它們(例如在每一幀都設置
--bn: 0)。
[其餘內容疑遭截斷,但翻譯應遵循相同原則。]