如果此資料夾中存在 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。
- 先準備內容。 將每個面板放在一個平面頁面上,作為包含
.plate(圖畫)和figcaption的 `<figure class=