Communitygithub.com

kubai-scroll-cards

改造現有長頁面:選出值得講的段落,用五種由滾動驅動的卡片互動呈現——層疊卡片、卡組飛出、橫向展廊、封面輪播與圖片展開。所有效果由滾動位置驅動,讀者掌控節奏,回滾即倒放,不劫持滾動。

kubai-scroll-cards 是什麼?

本技能旨在改造使用者產品中已存在的長頁面,將其特定段落轉化為五種由滾動驅動的卡片互動效果,包括「層疊卡片」(新卡片逐張覆蓋舊卡片,舊卡片縮小變暗)、「卡組飛出」(頂部卡片向一側甩出,下一張遞補)、「橫向展廊」(頁面固定,縱向滾動推動橫向作品集)、「封面輪播」(中間一張最大,兩側縮小轉開變暗)以及「圖片展開」(小圖鋪滿螢幕,搭配景深效果)。每種效果都由滾動位置嚴格驅動,讀者可完全控制節奏,向後滾動即反向播放動畫,且絕不劫持或干擾瀏覽器原生滾動行為。技能支援 Web (CSS scroll-driven animations)、iOS (SwiftUI)、Android (Compose) 和 Flutter 等主流平台,並針對手機螢幕及不同視窗高度進行了精確的尺寸計算,確保手機工具欄不會遮擋內容,矮螢幕則自動退回普通段落。技能內建多檔預設(短、標準、長),開始前會逐項詢問使用者的選擇(如哪些區塊對應哪種互動、手機處理策略、減動模式等),在確認後根據現有技術棧實作。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-scroll-cards

在你喜歡的 AI 中提問

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

說明文件

滾動驅動的五種卡片互動

《999 個小技巧,讓你 Vibe 的產品更有質感》第 019 期 · @kubai087

在使用者的專案裡按下面的要求改造。要求以使用者的口吻寫成:文中的 I、me、my 指使用者;寫著要先問的地方,先停下來問使用者再繼續。

改造要求

Rework a long page that already exists in my product so its cards move with scrolling. This changes my product, not a new page or a demo: keep my content, components, tokens and copy, find the sections that deserve it, and give each one of five scroll-driven card interactions: stacked cards (each new card covers the last, which shrinks and dims), a card deck (the top card flies off to one side and the next rises), a pinned gallery (the section holds still while scrolling moves a row sideways), a cover flow (the middle cover is largest; the others shrink, turn away and dim), or an image expand (a picture grows from a frame to the whole screen, with words behind and in front of it rising at different speeds for depth). The scroll position drives every effect, so the reader sets the pace and scrolling back plays it in reverse. It must hold up on every screen, phones above all, and at every viewport height (section 8).

Every value here is a recommendation. Sections 2 to 8 are a tested set (Standard); section 10 gives presets. I choose; you build what I choose.

First look at my product (section 0). Then ask me these one at a time, each as a short list of options with key values and the recommended one marked, and wait for my answer:

  1. Which sections get which interaction (section 1): at most one of each per page, with ordinary sections between them.

  2. Length: Short, Standard (recommended) or Long (section 10).

  3. Phones and short screens: Standard (recommended: on phones the stack, deck and image expand stay, sized to the viewport; the gallery and cover flow become native horizontal rows with snap points; below 560px of viewport height nothing pins), the same as desktop, or plain sections on all phones. Tell me which screen sizes my analytics or audience suggest, if you can find out.

  4. Reduced motion: plain sections (recommended: lists, horizontal rows, a full-width picture), or keep the pinning and drop the motion.

  5. Engine: CSS scroll-driven animations with a small script as fallback (recommended), or the scroll library my project already uses. Never smooth-scrolling or scroll-hijacking. Then sum up my choices in one table, propose how you will build it on my platform (section 9), with cost and fallback, and wait for my go-ahead.

  6. 從現有內容開始

  • 頁面:各區塊的順序、內容、卡片、圖片和影片,以及任何固定或黏性元素(頁首、橫幅、cookie 列)及其在各 breakpoint 的高度。
  • 每個區塊適合哪種互動,以及哪些區塊必須保持不變(任何人們會掃讀、比較或搜尋的內容)。
  • 當前佈局如何響應:breakpoints、如何根據視口大小設定尺寸(vh、svh、dvh、JS 讀取 innerHeight)、在短螢幕上已發生的問題。
  • 頁面如何滾動:window 或內部容器、平滑滾動函式庫、錨點連結、現有的滾動效果。
  • 平台與版本、圓角和動畫的 token、深色模式。在詢問前先用幾行告訴我。
  1. 哪種互動對應哪種內容
  • 層疊卡片:3 到 5 個並列項目,每個值得佔一整個螢幕(步驟、功能、方案、章節)。
  • 卡組飛出:3 到 6 個項目,一次只看一個(精選、推薦、亮點)。
  • 橫向展廊:5 到 12 個比螢幕寬的項目,用來瀏覽(作品、產品、版本)。
  • 封面輪播:5 到 9 個相同形狀的項目,其中一個為焦點(專輯、書籍、方案、人物)。
  • 圖片展開:一張強而有力的圖片或影片,用來開啟下一章。
  1. 五種互動的共通規則
  • 每個區塊只有一個進度值 p = clamp((scrollY - start) / distance, 0, 1),每個屬性都是 p 的函數,絕不是用時間驅動、滾動僅用來觸發的動畫。停在半路就是半路;往回滾動會完全反向。絕不改變滾動速度、吸附或攔截滾輪。
  • 固定是 position: sticky 放在一個比螢幕還高的區塊內;多出來的高度就是效果播放的距離。
  • 只動畫 transform、opacity、clip-path 和 filter。文字保持在頁面中,在任何 p 值下都可讀。
  • 當一個區塊被固定時,盡可能低調地顯示讀者所在位置:一條細線或圓點,不要有標籤。
  1. 層疊卡片(示範:1000 x 896 視口)
  • 卡片 936 x 720(佔滿全部 12 欄,向外出血 24px,因為其 24px 內邊距會讓內容回到欄位上),圓角 28px,間距 48px。
  • 每張比上一張低 16px:top = 40px + i * 16px(要加上固定頁首的高度)。較新的卡片覆蓋舊的,每張留出 16px 的邊。
  • 當後面的卡片到來時,前面的卡片會後退:k = clamp((scrollY - 它黏住時的位置) / 752px, 0, 後面的卡片數量);scale = 1 - k * 0.05 從其頂部中心縮放(三張以下為 0.85),暗色圖層透明度為 k * 0.12。
  • 卡片內部,名稱和一行文字放在第 0 到第 5 欄,只在該範圍內換行,絕不進入圖片區域;名稱從卡片頂部向下 48px 開始,文字再往下 24px。
  • 每張卡片給予各自低調的色調和圖片(示範:石色、鼠尾草色、陶土色,然後一張墨色卡片)。無陰影。
  • 最後一張卡片黏住後,保持 320px,然後整疊卡片一起離開。
  • 可選開場:區塊標題大小恰好跨滿欄位(不裁剪),第一張卡片蓋住其底部;標題以一半的滾動速度移動,並在 280px 的距離內淡出,直到第一張卡片黏住。
  1. 卡組飛出
  • 五張卡片疊成一疊,432 x 456(六欄,置中),在標題下方;每張卡片包含一張內縮 8px 的圖片,然後在內縮 24px 處放置名稱和一行文字,別無他物。
  • 區塊高度為 100vh + 1920px,固定:每 420px 的滾動拋出前四張卡片中的一張,然後保持 240px。最後一張卡片留下。
  • 卡片 i:t = clamp((scrollY - start) / 420 - i, 0, 1)。它飛向一側,方向交替:x = side * t * t * 1000px,y = t * (160px * t - 40px),繞其底部中心旋轉 rotate = side * t * 16deg。拋出後隱藏;往回滾動時沿相同路徑返回。
  • 下方的卡片每張低 18px,縮小 0.05,暗色圖層增加 0.04,最多深三層,並隨著頂部卡片離去而遞補其位置。
  1. 橫向展廊
  • 5 到 12 張卡片排成一行:示範八張,寬 280(四欄),間距 24px,每張白卡片內含圖片(內縮 8px)、名稱和創作者。標題在上方,與卡片行間隔 48px;下方有一條 2px 的橫條(軌道為 6% 黑,填充為 30%)。
  • 區塊高度為 100vh + 溢流量(行寬減去視口寬度,示範為 1520px);內容 sticky 固定在 top 0,高度為 100vh。
  • p = (scrollY - start) / overflow;該行移動 translateX(-p * overflow),無緩動:將滾動轉為橫向。在最後一個項目處放手。
  • 讓固定距離維持在大約三個螢幕以內;更多項目應使用網格佈局。
  1. 封面輪播
  • 5 到 9 個正方形封面,大小 432(六欄,置中),位於標題下方,下方有圓點指示器,封面上無文字。
  • 區塊高度為 100vh + 每步 320px,固定。r = clamp((scrollY - start) / 320, 0, count - 1);c = floor(r) + smoothstep(fract(r)),這樣每個封面都會在中間短暫停留。
  • 對於封面 i,d = i - c:translateX = d * 260px,rotateY = clamp(d, -1, 1) * -30deg,scale = max(0.6, 1 - |d| * 0.2),暗色圖層 min(|d|, 3) * 0.15,最近的在上層。Perspective 1400px。距離超過 3.5 則隱藏。圓點指示器亮度為 1 - |i - c|。
  1. 圖片展開
  • 區塊高度為 100vh + 1200px,固定:前 900px 用於展開,後 300px 保持。
  • 起始時,標題和一個 584 x 352 的框架(第 2 到第 9 欄,在標題下方 48px)一起居中,圓角 8px。
  • 圖片始終覆蓋視口;clip-path: inset() 顯示出框架,然後開啟到 0 且無圓角,同時圖片從 scale 1.2 穩定到 1,看起來像是在放大。兩者都使用 e = ease(p),cubic-bezier(0.45, 0, 0.25, 1)。標題以兩倍速度淡出並向上移動 60px。
  • 景深:從圖片中剪出主要形狀作為獨立圖層(示範:山丘),在其後方放置一個標題,其底部被形狀遮住,並在前方放置一行小字。展開時,每個元素從各自的縮放比例穩定下來(圖片和形狀 1.2,標題 1.25,文字行 1.4)。完全展開後,圖片和形狀保持靜止,而標題以滾動速度的 0.25 倍上升,文字行則以 0.5 倍上升。有東西在背後,以不同速度移動,會產生透視感。
  • 然後下一個區塊滑過它,頂部圓角 28px,在最後 120px 內變扁,同時圖片變暗至 35% 黑色。影片同樣運作,無聲循環播放,僅在螢幕上時播放。
  1. 螢幕與視口高度 示範尺寸基於 1000 x 896 的視口。根據實際螢幕縮放;絕不使用假定視窗高大的固定高度。
  • 對固定區塊使用 100svh,而非 100vh:在手機上 100vh 是隱藏工具欄後的高度,因此內容會跑到工具欄下方。固定內容絕不使用 dvh;它會在工具欄移動時跳動。
  • 在載入、方向變化和寬度改變時測量。忽略約 120px 以下的高度變化(工具欄顯示和隱藏);在此期間重新計算會使卡片在滾動中跳動。
  • 將每個固定區塊適配到一個螢幕中:
    • 層疊卡片高度 = min(720px, 100svh - 黏性頂部 - (卡片數量 - 1) * 16px - 32px);卡片之間黏住的距離隨之調整。
    • 卡組飛出:標題 + 48px + 卡片高度適配在 100svh - 64px 內;圖片優先犧牲高度。
    • 展廊卡片高度 = min(520px, 100svh - 標題 - 48px - 96px)。
    • 封面尺寸 = min(432px, 48svh, 70vw);展開範圍隨之縮放。
    • 圖片框架寬度 = min(584px, 100vw - 2 * margin),比例為 5:3;裁切範圍由此推導。
  • 每個滾動距離乘以 clamp(0.7, 視口高度 / 896, 1.2)。
  • 低於 560px 高度(手機橫向、短視窗),不固定任何內容:改為列表、橫向行或全寬圖片。
  • 字型跟隨寬度:區塊標題 clamp(36px, 7vw, 64px),卡片名稱 clamp(28px, 5vw, 36px)。
  • 全出血元素尊重 env(safe-area-inset-*)。從每個適配和黏性頂部減去固定頁首的高度。

佈局與字型(所有區塊)

  • 首先將所有內容放置在欄網格上。每個文字框與其欄位等寬,這樣長名稱會換行而不會侵入圖片區。
  • 標題介紹的內容從其下方 48px 開始;在固定區塊中,標題和內容一起在視口中垂直居中:置中標題對應置中內容,左對齊標題對應左對齊內容。
  • 保持卡片為焦點:外部每個區塊只有一個簡短標題,沒有標籤、側邊文字、計數器或說明;內部只有一種結構:圖片、名稱、一行文字。
  • 使用兩種字型、四種大小(示範:Newsreader 64 和 36,Geist 18 和 16)。將大型襯線文字行向左拉出第一個字母的側邊軸承;超過約 100px 時使用文字光學尺寸,使襯線保持鈍感。
  • 除列表行之間外無分隔線,無投影,最多使用一次強調色。每組圖片一種風格,同一頁面中絕不使用相同的圖片兩次。
  • 錨點連結定位到區塊開頭。鍵盤滾動與滾輪相同;固定區塊中的項目應可透過 Tab 鍵到達。

檢查

  • 每個區塊以慢、快和反向滾動測試:無跳動、閃爍或間隙。
  • 視口 375x667、390x844、430x932(工具欄顯示和隱藏)、844x390、768x1024、1280x720、1440x900、1920x1080,以及 600px 高的桌面視窗:無內容被裁切,無卡片高於螢幕,無內容位於工具欄或固定頁首下方。
  • 200% 文字縮放、減動模式、鍵盤、淺色與深色模式;在中階手機上維持全幀率;構建的值與我的選擇表相符。
  1. 如何構建 根據使用者的技術棧和版本檢查這些選項。
  • Web:使用 position: sticky 進行固定;使用滾動驅動動畫(animation-timeline: view() 或命名時間線,animation-range)。在不支援之處,或關鍵影格不足以應付(如卡組飛出的每張卡片範圍、封面輪播的停留步驟)時,使用一個被動滾動監聽器,每幀讀取一次 scrollY,根據 resize 時測量的偏移計算每個區段的 p,並將其作為自訂屬性寫入該區段。
  • 如果專案已使用 GSAP ScrollTrigger(scrub、pin)或 Motion(useScroll、useTransform),則使用它們搭配這些數值;絕不要只為了這個而新增。
  • iOS (SwiftUI):在滾動視圖中的視圖框架上使用 .scrollTransition 或 .visualEffect(iOS 18 的 onScrollGeometryChange)、scaleEffect、rotation3DEffect、offset、clipShape;展廊和封面輪播作為水平 ScrollViews,搭配 .scrollTargetBehavior(.viewAligned)。
  • Android (Compose):使用 LazyListState 取得 p,Modifier.graphicsLayer 進行 scale、rotationY、alpha、translation 和 clip;使用 LazyRow 搭配吸附功能或 HorizontalPager。
  • Flutter:使用帶有 slivers 的 CustomScrollView、用於 p 的 ScrollController、Transform 和 ClipRRect;展廊和封面輪播使用 PageView。
  1. 預設
  • 長度:Short(層疊 560px、卡組 300px、展廊 1.25px 橫向 / 1px 縱向、封面每步 240px、圖片 600 + 200px)、Standard(752、420、1:1、320、900 + 300,推薦)、Long(900、560、1:1 且兩端各保持 200px、420、1200 + 400)。
  • 層疊深度:Flat(每張卡片縮放 0.03、陰影 0.08)、Standard(0.05、0.12)、Deep(0.07、0.16,邊距 24px)。
  • 卡組拋出:Gentle(8deg、700px、恆向右)、Standard(16deg、1000px、交替方向)、Lively(24deg、1200px、抬起 60px)。
  • 封面輪播:Flat(不旋轉、側邊縮放至 0.85)、Standard(30deg、0.8)、Deep(45deg、0.75、間距 180px)。
  • 圖片起始:Small(420 x 280)、Standard(584 x 352)、Wide band(全寬、高 340)。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能