Community程式設計與開發github.com

深度捲動 (Depth Scroll)

建立深度捲動頁面:一系列面板(圖畫、單一概念卡片、階段)沿著深度軸設置為車站,隨著捲動向下移動,每個面板從遠景中浮現,在螢幕平面處清晰靜止,然後通過觀看者,在 WhatTheFad (whatthefad.netlify.app) 的落地場域之後,有一串卡片在它們後面向觀看者飛來。

深度捲動 (Depth Scroll) 是什麼?

深度捲動是一種網頁格式,專為一組讓讀者逐一瀏覽的圖形而設計,靈感來自 WhatTheFad 網站的登陸頁面。它將一系列「車站」(可以是圖畫、單一概念卡片或序列中的各個階段)放置在一個以 CSS `perspective` 實現的虛擬深度軸上。瀏覽器的原生滾動控制一個「攝影機」,該攝影機在車站之間平滑移動,營造出每個面板從遠處浮現、在螢幕平面清晰靜止,然後在通過觀看者時淡出的錯覺。同時,一個由 requestAnimationFrame 驅動的動畫卡片串流會向觀看者飛來,並根據滾動速度調整其速度,以增強沉浸感。該工具包含一個 HTML 模板、一個根據 JSON 規格檔案生成頁面的 Python 建立腳本,以及一個用於在真實瀏覽器中進行即時視覺檢查的 Node.js 擷取工具,支援無障礙的「減少動畫」偏好設定,並提供詳細的調校常數。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rafaelcarlosabbariao/skills/tree/HEAD/agnostic/depth-scroll

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

如果此資料夾中存在 SKILL.local.md,請先讀取它;它包含您的路徑、資料和內部規則。

深度捲動 (Depth Scroll) 是做什麼的?

一種頁面格式,用於讓讀者逐一瀏覽一組圖形。第一個版本將一組說明性圖畫轉變為向觀看者捲動的體驗,其模型是 WhatTheFad 的登陸頁面(whatthefad.netlify.app,原始碼位於 github.com/rafaelcarlosabbariao/cultural-archaeology)。

此技能包含四個檔案:

檔案說明
template.html頁面:車站外框、串流、軌道及運作它們的腳本
build.py根據規格填入模板,可作為指令或模組使用
capture.mjs透過 DevTools 協議進行即時無頭擷取和導航檢查
SKILL.md本檔案

適用時機

  • 適用於 四到十二個自成一體且適合單一螢幕的面板:圖畫、單一概念卡片、序列的各個階段。
  • 不適用於 長篇散文、表格,或任何讀者需要並排比較或前後掃視的內容。這類內容請建立一般平面頁面。
  • 輸出。 頁面是一個自包含的 .html 檔案,無需外部腳本或 WebGL。模板在 :root 變數中附帶了溫暖的奶油色和墨水色調色板;您可以根據喜好重新設定樣式。

運作原理

WhatTheFad 的場域(原始來源)

請參閱 WhatTheFad 的 index.html(#landing-trendfield CSS 和 renderTrendField 函數)。

  • 投影。 場域是一個具有 perspective: 900px 的容器,每個晶片使用 translate3d(x, y, z) 放置。瀏覽器以 900 / (900 − z) 的比例繪製晶片:在 z = −2800 時為 0.24,在螢幕平面為 1,在 z = 220 時為 1.3。
  • 時鐘驅動運動。 requestAnimationFrame 迴圈以 150 px/s 的速度乘以每個晶片 0.75 到 1.25 的因子,將每個晶片移向觀看者。超過 z = 220 後,它會在 z = −2800 處的橢圓環上重生。
  • 淡入淡出與繪製順序。 晶片在其深度的前四分之一處淡入,並在 z = 60 到 220 之間淡出。該場域從不使用 preserve-3d,因此每個晶片的 z-index 根據其深度設定,以使較近的晶片繪製在上層。
  • 靜止中心。 徑向 mask-image 隱藏中間區域,因為遠處的晶片會在消失點匯聚。
  • 捕捉晶片。 瀏覽器僅在指標移動時重新檢查 :hover,因此在靜止游標下漂移的晶片永遠不會被點亮。WhatTheFad 在每個影格中針對每個晶片的投影矩形測試指標,被捕獲的晶片會將場域速度減慢至 8%。

此格式新增的功能

  • 捲軸即為攝影機。
    • 一個高軌道(main.depth)為每個車站設定一個停止點,間距為一個舞台高度,並具有 scroll-snap-type: y proximity。
    • 一個黏性(sticky)的舞台位於固定的頁首下方,用以容納場景。
    • 滾動位置會變成一個車站索引,在每個停止點為整數。攝影機以每秒 9 次的速度緩慢朝向該索引移動,而車站 i 則繪製在 z = (camera − i) × 1400 的位置。
  • 車站的通過。
    • 等待中的後方車站會變暗並稍微下沉,以便在向前移動時升起就位。
    • 靜止時,它位於 z = 0、縮放比例為 1,並對齊到整數像素,因此文字與一般頁面一樣清晰。
    • 通過觀看者後,它會在 z = 300、縮放比例 1.5 倍時淡出。
    • 比舞台高的車站會被縮放以適應。
  • 串流。 WhatTheFad 的場域,包含遮罩。卡片的速度基礎為 46,再加上攝影機速度的 0.9 倍,因此向前滾動會使它們快速飛過,向後滾動則會將它們送遠。一個車站可以指定其點亮的卡片群組(lit),當該車站位於前方時,這些卡片會亮起。
  • 輸入。
    • 滑鼠滾輪、觸控板、觸控、方向鍵、軌道和頁首內容都能控制同一個原生滾動條,因此所有輸入都作用於相同的停止點。
    • 焦點進入一個不在前方的車站時,會自動滾動到該車站。
    • 串流僅作為裝飾,且只有靜止的車站會接收指標事件,因此無需進行每影格的點擊測試。
  • 降級方案。 在沒有 JavaScript 或啟用了 prefers-reduced-motion: reduce 的情況下,頁面會以平面方式堆疊顯示所有車站。深度效果由腳本添加的 deep 類別啟用。在平面模式下,內容的錨點會移動到車站本身。

建立一個深度捲動頁面

以下 SK 代表您安裝此技能的位置,例如 ~/.claude/skills/depth-scroll。

  1. 先準備內容。 將每個面板放在一個平面頁面上,作為包含 .plate(圖畫)和 figcaption 的 `<figure class=

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能