Communitygithub.com

kubai-scroll-cards

既存の長いページを改造し、スクロール位置で駆動する5種類のカードインタラクションを実装します。スタック、デッキ、ギャラリー、カバーフロー、画像拡大。

kubai-scroll-cards とは?

このスキルは、既存のWebページをリッチなスクロール駆動型カードインタラクションで強化するためのものです。ユーザー(開発者)のプロダクト内の長いページを分析し、5種類のインタラクション(スタックカード、カードデッキ、固定ギャラリー、カバーフロー、画像拡大)から適切なものを選択して適用します。各インタラクションはすべてCSSスクロール駆動アニメーションとスティッキーポジショニングを基盤とし、スクロール位置が進行度を決定するため、ユーザーがペースをコントロールでき、スクロールバックで逆再生も可能です。このスキルは特にモバイルファーストで設計されており、様々な画面サイズやビューポート高さに対応し、ツールバーによるコンテンツ隠れを防ぎます。また、ユーザーが好みのプリセットを選択できる対話型のセットアッププロセスを提供し、選択後は既存の技術スタックに合わせて実装します。対応プラットフォームはWeb(vanilla JS / CSS)、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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

スクロール駆動の5種類のカードインタラクション

『999の小ワザでVibeのプロダクトをより質感高く』第019回 · @kubai087

ユーザーのプロジェクトで以下の要件に従って改造すること。要件はユーザーの口調で記述:文中の「私」「私の」はユーザーを指す。先に質問と書かれている箇所では、一旦止まってユーザーに確認してから続行すること。

改造要件

私のプロダクトに既に存在する長いページを、カードがスクロールに合わせて動くように作り直す。これは私のプロダクトを変更するものであり、新しいページやデモを作るものではない:私のコンテンツ、コンポーネント、トークン、コピーを維持し、インタラクションに値するセクションを見つけ、それぞれに5種類のスクロール駆動カードインタラクションのいずれかを割り当てる:スタックカード(新しいカードが1枚ずつ古いカードを覆い、古いカードは縮小・暗転する)、カードデッキ(一番上のカードが横に飛び出し、次のカードが上がってくる)、固定ギャラリー(セクションは固定されたまま、スクロールで横にコンテンツが動く)、カバーフロー(中央のカバーが最も大きく、左右は縮小・回転・暗転する)、画像拡大(画像が枠から画面全体に広がり、背後と手前の文字が異なる速度で浮かび上がり奥行きを生む)。すべてのエフェクトはスクロール位置によって駆動されるため、読者がペースを決められ、スクロールを戻せば逆再生される。あらゆる画面、特にスマートフォン、そしてあらゆるビューポート高さで正常に動作しなければならない(セクション8)。

ここに示す値はすべて推奨値である。セクション2から8はテスト済みのセット(標準)、セクション10はプリセットを示す。私が選択し、あなたは私が選んだものを構築する。

最初に私のプロダクトを確認する(セクション0)。その後、以下を1つずつ、それぞれ短い選択肢リスト(主要な値と推奨項目に印を付ける)として私に質問し、私の回答を待つこと:

  1. どのセクションにどのインタラクションを割り当てるか(セクション1):各ページにつき各種類最大1つまで、間に通常のセクションを挟むこと。
  2. 長さ:短い、標準(推奨)、または長い(セクション10)。
  3. スマートフォンと短い画面:標準(推奨:スマートフォンではスタック、デッキ、画像拡大はそのままビューポートに合わせてサイズ調整。ギャラリーとカバーフローはスナップポイント付きのネイティブ横並び行になる。ビューポート高さ560px未満では何も固定しない)、デスクトップと同じ、またはすべてのスマートフォンでプレーンなセクション。可能であれば、私の分析データやオーディエンスからどの画面サイズが想定されるか教えてほしい。
  4. 動作の縮小:プレーンなセクション(推奨:リスト、横並び行、全幅画像)、または固定は維持して動作のみを削除。
  5. エンジン:CSSスクロール駆動アニメーションと小さなスクリプトによるフォールバック(推奨)、またはプロジェクトが既に使用しているスクロールライブラリ。スムーススクロールやスクロールハイジャックは絶対に行わないこと。

その後、私の選択を1つの表にまとめ、私のプラットフォーム上でどのように構築するかを提案し(セクション9)、コストとフォールバックについて説明し、私のゴーサインを待つこと。

0. 既存のものから始める

  • ページ:セクションの順序、それぞれのコンテンツ、カード、画像、動画、および固定またはスティッキーな要素(ヘッダー、バナー、クッキーバー)とそのブレークポイントごとの高さ。
  • 各セクションについて、どのインタラクションが適切か、および、そのままにしておくべきセクション(人がスキャン、比較、検索するもの)はどれか。
  • 現在のレイアウトの応答方法:ブレークポイント、ビューポートに対するサイジング方法(vh, svh, dvh, JSのinnerHeight読み取り)、短い画面で既に壊れている箇所。
  • ページのスクロール方法:ウィンドウまたは内部コンテナ、スムーススクロールライブラリ、アンカーリンク、既存のスクロールエフェクト。
  • プラットフォームとバージョン、角丸とモーションのトークン、ダークモード。質問を始める前に数行で教えてほしい。

1. どのコンテンツにどのインタラクション

  • スタックカード:各画面1つ分の価値がある、3~5の並行項目(ステップ、機能、プラン、チャプター)。
  • カードデッキ:一度に1つずつ表示される3~6の項目(ピックアップ、お客様の声、ハイライト)。
  • 固定ギャラリー:画面より幅広の5~12の項目をブラウズするもの(作品、製品、リリース)。
  • カバーフロー:同じ形状の5~9の項目で、1つに焦点が当たるもの(アルバム、本、プラン、人物)。
  • 画像拡大:次のチャプターへの導入となる、強力な画像または動画1つ。

2. 5種類すべてに共通するルール

  • 各セクションは1つの進行度 p = clamp((scrollY - start) / distance, 0, 1) を持ち、すべてのプロパティはpの関数であり、スクロールが単に開始するだけの時間指定アニメーションではない。途中で止まれば途中の状態で留まり、スクロールバックすれば正確に逆再生される。スクロール速度を変更したり、スナップさせたり、ホイールを奪ったりしてはならない。
  • 固定は、画面より高いセクション内でのposition: stickyによるもの。余分な高さがエフェクトの再生距離となる。
  • transform、opacity、clip-path、filterのみをアニメーションさせる。テキストはページ内に留まり、すべてのpで読める状態を保つ。
  • セクションが固定されている間、読者がどこにいるかを可能な限り控えめに表示する:細いバーまたはドット、ラベルは決して付けない。

3. スタックカード(デモ: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(上端中心から。3枚では0.85)、暗色オーバーレイ k * 0.12。
  • カード内部では、名前と1行のテキストがカラム0~5に収まり、画像領域にはみ出さずに折り返す。名前はカード上端から48px下、テキスト行はそのさらに24px下。
  • 各カードに独自の薄い色合いと画像を与える(デモ:ストーン、セージ、クレイ、そして1枚のインクカード)。影は付けない。
  • 最後のカードが固定された後、320px保持し、その後スタック全体が一緒に去る。
  • オプションの開始:セクションのタイトルをグリッドに正確にまたがるサイズに設定(クロップしない)。最初のカードがタイトルの下端を覆う。タイトルはスクロールの半分の速度で動き、最初のカードが固定される前の280pxの間でフェードアウトする。

4. カードデッキ

  • 5枚のカードが積み重なり、432 x 456(6カラム、中央寄せ)、タイトルの下。各カードは8px内側に画像、その後24px内側に名前と1行のテキスト、それ以外は無し。
  • セクションは100vh + 1920px、固定。420pxのスクロールで最初の4枚のカードがそれぞれ投げ出され、その後240pxの保持。最後のカードは残る。
  • カード i:t = clamp((scrollY - start) / 420 - i, 0, 1)。横に飛び出し、交互に:x = 方向 * t * t * 1000px、y = t * (160px * t - 40px)、rotate = 方向 * t * 16deg(下端中心を軸に)。投げ出されたら非表示。スクロールバックすると同じ経路で戻る。
  • 下のカードは18px低く、1段につき0.05小さく、暗色オーバーレイは1段につき0.04、最大3段まで。上のカードが飛び出すにつれて1段落ちる。

5. 固定ギャラリー

  • 5~12枚のカードを1列に:デモでは8枚、幅280(4カラム)、間隔24px。各カードは白いカードで、8px内側に画像、その後名前とアーティスト名。上部にタイトル、列から48pxクリア。下部に2pxのバー(トラック6%黒、フィル30%黒)。
  • セクションは100vh + オーバーフロー(列の幅からビューポート幅を引いたもの、デモでは1520px)。コンテンツはtop: 0、100vhの高さでスティッキー。
  • p = (scrollY - start) / オーバーフロー;列はtranslateX(-p * オーバーフロー)で移動、イージング無し:スクロールが横方向に変換される。最後の項目で解放する。
  • 固定距離は約3画面以内に抑える。それ以上の項目はグリッドに属する。

6. カバーフロー

  • 5~9枚の正方形カバー、432(6カラム、中央寄せ)、タイトルの下、下部にドット。カバーにはテキスト無し。
  • セクションは100vh + ステップ数 * 320px、固定。r = clamp((scrollY - start) / 320, 0, カウント - 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、最も近いものが最前面。視点距離1400px。3.5位置以上離れたものは非表示。ドットは 1 - |i - c| で明るくなる。

7. 画像拡大

  • セクションは100vh + 1200px、固定:900pxで拡大、300pxで保持。
  • 開始時、タイトルと584 x 352のフレーム(カラム2~9、その48px下)が中央に揃い、角丸8px。
  • 画像は常にビューポートを覆う;clip-path: inset()でフレーム部分を表示し、角丸を無くして開き、同時に画像はscale 1.2から1に落ち着く。これにより画像が拡大しているように見える。両方とも e = ease(p)、cubic-bezier(0.45, 0, 0.25, 1)。タイトルは2倍の速度でフェードアウトし、60px上昇する。
  • 奥行き:画像から主要な形状を切り出して独立したレイヤーにし(デモ:丘)、その背後にタイトルを配置(下端が形状で隠れる)、そして手前に小さなテキスト行を1つ配置する。開くにつれて、各要素が独自のスケールから落ち着く(画像と形状は1.2、タイトルは1.25、テキスト行は1.4)。完全に開いたら、画像と形状は静止し、タイトルはスクロールの0.25倍の速度で上昇し、テキスト行は0.5倍の速度で上昇する。何かの背後に何かがあり、異なる速度で動くことで、遠近感が生まれる。
  • そして次のセクションが、その上に28pxの上部角丸を持ってスライドインする。この角丸は最後の120pxで平坦になる。同時に画像は35%黒く暗転する。動画も同様に動作する、ミュートでループ、画面に表示されている間のみ。

8. 画面とビューポート高さ

デモのサイズは1000 x 896のビューポート用。画面に合わせてスケールすること。決して高いウィンドウを前提とした固定高さを使用しないこと。

  • 固定セクションのサイズは100vhではなく100svhを使用する:スマートフォンでは100vhはツールバーが非表示の状態の高さであるため、コンテンツがツールバーの下に潜り込む。固定されたコンテンツにdvhは決して使用しないこと。ツールバーの移動に伴って値がジャンプする。
  • ロード時、オリエンテーション変更時、および幅が変更されたときに測定する。約120px未満の高さのみのリサイズ(ツールバーの表示/非表示)は無視する。そのたびに再計算すると、スクロール中にカードがジャンプする原因となる。
  • 各固定セクションを1画面に収める:
    • スタックカードの高さ = min(720px, 100svh - スティッキー上部 - (カード数 - 1) * 16px - 32px)。カードの固定間隔もこれに従う。
    • デッキ:タイトル + 48px + カードが100svh - 64pxに収まるように。画像が最初に高さを譲る。
    • ギャラリーカードの高さ = min(520px, 100svh - タイトル - 48px - 96px)。
    • カバーサイズ = min(432px, 48svh, 70vw)。間隔もそれに合わせて拡大縮小する。
    • 画像フレーム = min(584px, 100vw - 2 * マージン) の幅で5:3。内部のインセットはそれに従う。
  • すべてのスクロール距離を clamp(0.7, ビューポート高さ / 896, 1.2) でスケールする。
  • 高さ560px未満(横向きのスマートフォン、短いウィンドウ)では何も固定しない:リスト、横並び行、全幅画像。
  • タイポグラフィは幅に従う:セクションタイトル clamp(36px, 7vw, 64px)、カード名 clamp(28px, 5vw, 36px)。
  • 全面にはみ出す要素は env(safe-area-inset-*) を尊重する。すべてのフィットとスティッキー上部から固定ヘッダーを差し引く。

レイアウトとタイポグラフィ(全セクション共通)

  • すべてを最初にカラムグリッド上に配置する。各テキストボックスはそのカラムの幅と等しくし、長い名前が画像領域にはみ出さずに折り返すようにする。
  • タイトルが導入するものは、タイトルの48px下から開始する。固定セクションでは、タイトルとコンテンツはビューポート内で中央に揃える。中央揃えのタイトルは中央揃えのコンテンツの上に、左揃えのタイトルは左揃えのコンテンツの上に配置する。
  • カードに焦点を当てる:カードの外側には、セクションあたり1つの短いタイトルのみ。タグ、サイドコピー、カウンター、キャプションは無し。カード内部は1つの構造:画像、名前、1行のテキスト。
  • 2つの書体、4つのサイズ(デモ:Newsreader 64と36、Geist 18と16)。大きなセリフ体の行は、最初の文字のサイドベアリング分左に引き出す。約100px以上ではテキスト光学サイズを使用して、セリフが鈍らないようにする。
  • 区切り線はリスト行の間以外には使用しない。ドロップシャドウは使用しない。アクセントカラーは最大でも1回のみ。グループごとに1つの画像スタイル、同じ画像をページ内で2度使用しない。
  • アンカーリンクはセクションの先頭に移動する。キーボードスクロールはホイールと同様に動作する。固定セクション内の項目はTabで到達可能に保つ。

チェック項目

  • 各セクションを低速、高速、逆方向で確認:ジャンプ、ちらつき、隙間がないこと。
  • ビューポート375x667、390x844、430x932(ツールバー表示および非表示)、844x390、768x1024、1280x720、1440x900、1920x1080、および高さ600pxのデスクトップウィンドウ:何も切り取られていない、画面より高いカードがない、ツールバーや固定ヘッダーの下にコンテンツがないこと。
  • 200%テキストズーム、動作の縮小、キーボード、ライト/ダークモード。ミッドレンジのスマートフォンでフルフレームレート。構築した値が私のテーブルと一致していること。

9. 構築方法

これらを私のスタックとバージョンに対して確認すること。

  • Web:固定にはposition: sticky。スクロール駆動アニメーション(animation-timeline: view() または名前付きタイムライン、animation-range)。サポートされていない場合、またはキーフレームだけでは不十分な場合(デッキのカードごとの範囲、カバーフローの静止ステップ)、1つのパッシブスクロールリスナーが1フレームあたり1回scrollYを読み取り、リサイズ時に測定したオフセットから各セクションのpを計算し、そのセクションのみのカスタムプロパティとして書き込む。
  • プロジェクトが既にGSAP ScrollTrigger(scrub, pin)またはMotion(useScroll, useTransform)を使用している場合、それらの値を使用する。このためだけに新しいものを追加しないこと。
  • iOS(SwiftUI):スクロールビュー内のビューのフレームに.scrollTransitionまたは.visualEffectを適用(iOS 18ではonScrollGeometryChange)。scaleEffect、rotation3DEffect、offset、clipShape。ギャラリーとカバーフローは.scrollTargetBehavior(.viewAligned)を付けた水平ScrollView。
  • Android(Compose):pにはLazyListState、scale、rotationY、alpha、translation、clipにはModifier.graphicsLayer。スナップまたはHorizontalPagerを備えたLazyRow。
  • Flutter:sliverを備えたCustomScrollView、pのためのScrollController、TransformとClipRRect。ギャラリーとカバーフローはPageView。

10. プリセット

  • 長さ:短い(スタック560px、デッキ300px、ギャラリー横方向1.25px/縦方向1px、カバーステップ240px、画像600 + 200px)、標準(752、420、1:1、320、900 + 300、推奨)、長い(900、560、1:1で両端に200px保持、420、1200 + 400)。
  • スタックの深さ:フラット(scale 0.03、shade 0.08 per card)、標準(0.05、0.12)、ディープ(0.07、0.16、24pxストリップ)。
  • デッキの投げ方:ジェントル(8deg、700px、常に右)、標準(16deg、1000px、交互)、ライブリー(24deg、1200px、60pxリフト)。
  • カバーフロー:フラット(回転なし、側面0.85)、標準(30deg、0.8)、ディープ(45deg、0.75、180px間隔)。
  • 画像開始サイズ:小(420 x 280)、標準(584 x 352)、ワイドバンド(全幅、高さ340)。

Individual skills in this repo

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

関連スキル