Communitygithub.com

FrontLaxWeb

在 React(Motion + Lenis)與純 HTML/CSS/JS(GSAP + Lenis)中,為登陸頁面與網站打造視差、互動滾動、微互動與高階手勢效果。

FrontLaxWeb 是什麼?

FrontLaxWeb 是一個專注於將普通登陸頁面轉化為「網頁體驗」的 AI 代理技能,讓滾動與指針成為連續動畫的控制器。它支援 React(使用 Motion 和 Lenis)以及純 HTML/CSS/JS(使用 GSAP 和 Lenis),涵蓋七種核心效果:平滑滾動、圖層視差、滾動連結動畫、捲動觸發、固定/釘選、指針微互動(如 3D 傾斜、自訂游標)以及可中斷的彈簧手勢(拖曳、滑動)。此技能的核心原則是「為所有人提供動畫,但調整幅度」:它透過 CSS 變數 `--motion-gain` 以及 URL 參數 `?motion=off` 提供可見的開關,來符合 WCAG 無障礙標準,而不是完全關閉動畫。此外,它內建一個「輕量模式」,可在無獨立顯卡(軟體繪圖)的機器上自動停用 Lenis、模糊特效與 3D 渲染,以確保在低階硬體上仍能流暢運行(依據 Playwright 測量結果可達 60fps)。該技能也強制執行效能最佳化規則(僅動畫 `transform` 與 `opacity`),並提供可複用的模板與組件,位於 `plantillas/`、`Components/` 等目錄中。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Mun1to/FrontLaxWeb/tree/main

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

FrontLaxWeb:視差與高階互動滾動

此檔案為「大腦」:方法論。食譜與程式碼片段存在 plantillas/ 中,並按需讀取。路徑 plantillas/、references/、Designs/ 與 Components/ 均相對於此檔案所在的資料夾。

此技能能達成什麼

將普通的登陸頁面轉換為網頁體驗:滾動與指針成為連續動畫的控制器。不受品牌限制:它接收每個專案的色彩/權杖。

七種效果(目錄)

  1. 平滑滾動(基礎): Lenis。讓一切感覺高階的基礎。
  2. 圖層視差: 慢速背景 / 快速前景 = 深度感。
  3. 滾動連結動畫: 屬性綁定到滾動百分比。
  4. 捲動觸發: 進入視口時觸發/動畫。
  5. 固定 / 釘選: 某個元素「釘住」,同時周圍內容變化(堆疊卡片)。
  6. 指針微互動: 3D 傾斜、自訂游標、懸停。
  7. 彈簧手勢: 拖曳、放開、輕觸:使用可中斷的彈簧物理,而非固定持續時間的 CSS 過渡。請參閱下方專屬章節。

手勢與彈簧(融合自 Emil Kowalski 的 apple-design 技能,WWDC 精華)

這是一個不同於上方滾動/視差的領域:它是關於觸碰與拖曳某物(選單、可滑動卡片、模態視窗、滑桿)的物理。最適用於網頁的可執行原則(來自原始 17 條;摘要請見 references/recetas-y-matriz.md §4bis):

  • 可中斷性,17 條中最重要: 任何動畫都應能夠在中途被抓取並重新導向。對於使用者可以觸碰的所有事物,使用彈簧(參數:damping/阻尼 + response/速度),絕不使用固定持續時間的 CSS transition:彈簧總是知道如何從其當前位置開始動畫,而固定過渡則不能。
  • 速度傳遞: 放開手勢時,動畫會以手指的速度繼續(而非從零開始),從而避免視覺「接縫」。在 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: reduce0.25相同的設計,但移動量降為四分之一:動畫被解讀為強調,而非鏡頭移動。
URL 帶有 ?motion=off0所有僅自行移動的內容都靜止不動,並移除 motion class。訪客用手指拖曳的內容仍然回應:一張不能滑動的可滑動卡片不是簡潔的介面,而是一張壞掉的圖片。這是不想要動畫的訪客的閥門,而非一種設計模式。
URL 帶有 ?motion=full1 強制忽略系統偏好。用於在關閉 Windows 動畫效果的設備上檢查作品。

0.25 是預設值,可根據專案效果調整,但絕非 1:如果 reduce 時沒有任何變化,則表示你沒有套用此政策。

撥盤的三條規則

  1. gain 倍乘移動量:像素、縮放、旋轉、傾斜。對於連續效果(跑馬燈、循環),則倍乘速度。
  2. gain 絕不倍乘透明度。淡入淡出不會讓任何人頭暈。因此,當調低撥盤時,效果不會中斷:它會降級。使用 gain: 0.25 的「俄羅斯套娃」效果仍然講述相同的故事,但以連鎖淡入淡出而非鏡頭縮放呈現。而這正是此政策無需為每個效果編寫第二個版本的原因,這也是第 14 條原則過去代價高昂的原因。
  3. 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:網頁中的每個 getContext WebGL 都必須使用 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 毫秒)。 沒有任何一條規則會停止或減慢動畫:它們移除的是看不見的工作。

  1. 不要在 animationend 事件中使用 getAnimations():這會強制重新計算整個頁面的樣式(在 4 倍速下約 50 毫秒,且常在滾動中途發生)。請計算元素的 animationstart 和 animationend 事件。
  2. 不要在滾動時暫停僅移動 transform/opacity 的動畫:這些動畫在合成器執行緒上運行,暫停並不會節省資源,而且暫停和恢復每次滾動都會造成兩次大量的重新計算。
  3. 不要在滾動進行時「利用空閒時間」渲染章節:Lenis 會在幀之間留下空閒時間,requestIdleCallback 正好會在此時觸發。請等待滾動停止。
  4. 如果滾動每一幀的樣式沒有改變,就不要寫入它們(例如在每一幀都設置 --bn: 0)。

[其餘內容疑遭截斷,但翻譯應遵循相同原則。]

相關技能