Communitygithub.com

カードUIシステム

階層性、構造的一貫性、アクションの整合性を維持しながら、可変コンテンツとレスポンシブビューポートに対応するモジュラーコンテンツコンテナの体系的なフレームワークを設計および実装します。

カードUIシステム とは?

このスキルは、発見重視のインターフェースにおける基本構成要素である「カード」の体系的な設計・実装方法論を提供します。カードUIシステムは、製品グリッド、記事プレビュー、ランディングページの機能セクション、ダッシュボードウィジェットなど、複数の情報をスキャン・比較する場面で特に有効です。ワークフローは「3点ルール(アンカー・コンテキスト・ターゲット)」に基づくアナトミー定義、内部スペーシングの設計、視覚的階層の整備、インタラクションパターンの確立、レスポンシブ適応とアクセシビリティ検証の5ステップで構成されます。CSS Gridのauto-fill/auto-fitやコンテナクエリを使用したレイアウト、WCAG 2.2に準拠したタッチターゲット(最小24x24px)やフォーカス表示の要件など、具体的な実装ガイドラインも含まれています。このスキルは、Claude Code、Cursor、CodexなどのAIエージェント向けに設計されており、一貫性のあるカードシステムを効率的に構築するための明確な判断基準と制約を提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/card-ui-system

お気に入りのAIに質問する

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

ドキュメント

カードUIシステム は何をしますか?

目的

カードUIシステムは、関連する情報とアクションをグループ化するためのモジュラー構成要素であるカードを設計・構造化するための方法論を提供します。カードは、発見重視のインターフェースにおける基本的な構成要素であり、ユーザーが統一されたグリッドまたはリスト内で複数の異なるアイテム(製品、記事、プロフィール)をスキャンして比較できるようにします。カードへの体系的なアプローチにより、コンテンツがスキャン可能で、視覚的にまとまりがあり、さまざまなレイアウトコンテキスト(グリッド、カルーセル、スタック)に適応し、アクセシビリティと明確な意図を維持できます。

ユースケース

  • 電子商取引の一覧ページ(PLP)向け製品グリッドのデザイン
  • コンテンツハブ向け記事またはブログ投稿プレビューの作成
  • ランディングページでの「特徴」または「サービス」セクションの作成
  • ダッシュボードウィジェット、機能ハイライト、データサマリーの整理
  • ページ下部の「関連コンテンツ」セクションの実装
  • 検索またはフィルタービュー用の「結果」コンポーネントの定義

使用すべきでない場合

  • 高密度データテーブル: ユーザーが多数の行にわたって特定の属性を同時に比較する必要がある場合。代わりにresponsive-data-tablesを使用してください(ただし、カードはレスポンシブフォールバックとして使用できます)。
  • 単一のナラティブコンテンツ/単純なテキストフロー: コンテンツが厳密な線形ストーリーまたは標準的な段落に従う場合、カードラッパーは不要な視覚的ノイズを追加したり、読書リズムを妨げたりする可能性があります。
  • ミニマリストなアクションのみのUI: 単一フィールドの検索バーやシンプルなログインフォームなど、カードラッパーが不要な視覚的ノイズを追加する場合。

入力

  1. コンテンツアナトミー: 必須要素のリスト(例:画像、タイトル、カテゴリ、価格、説明、CTA)。
  2. インタラクション意図: カード全体がクリック可能か、それとも特定のアクションターゲットがあるか?
  3. 親コンテキスト: カードはどこに配置されるか?(例:3列グリッド、サイドバー、横スクロール?)
  4. コンテンツのばらつき: タイトルと説明に予想されるテキストの最小量と最大量は?
  5. 既存システム: 親デザインシステムからの流体スペーシング、タイポグラフィスケール、カラーパレット。

出力

  1. カードアナトミー仕様: 定義されたリージョン(ヘッダー、メディア、ボディ、フッター)とそれらの内部スペーシング。
  2. カード設計図: カードの内部レイアウトとレイヤーの構造定義。
  3. レスポンシブバリアント: カードの適応方法に関するルール(例:モバイルで縦から横に切り替える)。
  4. インタラクション仕様: 定義された状態(ホバー、フォーカス、アクティブ)とクリック可能領域の定義。
  5. アクセシビリティマップ: 見出し階層とキーボードインタラクションパターンに関するガイダンス。

ワークフロー

1. 「3点ルール」を適用し、アナトミーを定義する

すべてのカードには、スキャン可能性を確保するために、明確な3つの階層ポイントが必要です:

  1. アンカー(視覚): 即座に認識できる高品質な画像またはアイコン。画像のアスペクト比を定義します(例:16:9、1:1)。
  2. コンテキスト(コンテンツ): タイトルとコアメタデータ(例:価格、日付、カテゴリ)。
  3. ターゲット(アクション): 明確なプライマリアクション(例:「カートに追加」、「続きを読む」)。

完全な内部階層をマッピングします:ヘッダー(タグ/日付などのメタ情報)、メディアエリア、コンテンツ/ボディ(タイトル+説明)、フッター/アクション(CTA、価格、ソーシャルプルーフ)。

2. 内部スペーシングと内部グリッドを確立する

fluid-spacing-systemをカードの内部に適用します:

  • パディング: カードの端とそのコンテンツの間のスペース(通常は--space-m)。
  • スタッキングギャップ: 内部要素間の垂直方向のスペース(通常は--space-xsまたは--space-s)。

カード内でコンテンツがどのように分散されるかを決定します:

  • 上から下(標準): 画像が上、コンテンツが中央、アクションが下。
  • 横並び(水平): 画像が左、コンテンツとアクションが右(モバイルリストやサイドバーに最適)。
  • オーバーレイ: コンテンツが画像の上に配置されます(可読性のために高コントラスト処理が必要)。

3. 視覚的階層を設計し、コンテンツのばらつきを処理する

visual-hierarchy-systemのレバーを適用してコンテンツを区別します:

  • ウェイト: タイトルを太字で説明よりも大きくします。
  • コントラスト: メタテキストにはミュートカラーを使用します(例:「2024年10月24日公開」)。
  • エレベーション: 境界線や微妙なボックスシャドウを使用して、カードを背景から分離します。

「最悪のケース」のコンテンツシナリオを設計します:

  • 切り詰め vs 折り返し: 長いタイトルを省略記号で切り詰めるか、複数行に折り返すかを決定します。
  • 配置: アクションコンテナにFlexboxのmargin-top: autoを使用して、グリッド内の異なる高さのカード間でボタンが完全に揃うようにします。

4. インタラクションパターンを確立する

インタラクションの機能パターンを選択します:

  • ビッグボックス: カード全体がリンクです(スクリーンリーダー向けの注意深いアクセシビリティ処理が必要)。
  • ネストされたアクション: 特定のボタンまたはタイトルのみがクリック可能です。
  • ハイブリッド: カード表面にホバー効果がありますが、特定のアクションは異なるタスクを実行します(例:「カートに追加」 vs 「詳細を見る」)。

インタラクティブ性を示すために、ホバー時に微妙な変形(例:少し持ち上がる、境界線の色が変わる)を使用します。

5. レスポンシブ適応を定義し、アクセシビリティを検証する

カードが異なるビューポートでどのように機能するかを計画します:

  • 縦から横へ: モバイルでは、カードが画像上部レイアウトから画像左側レイアウトに切り替わり、垂直スペースを節約する場合があります。

サインオフ前にアクセシビリティを検証します:

  • 見出しレベル: カードタイトルが適切な見出しレベル(通常はH3またはH4)を使用して、ページのドキュメントアウトラインを維持することを確認します。
  • タッチターゲット: カード内のすべてのインタラクティブ要素はWCAG 2.2 SC 2.5.8(最小24x24px、小さいターゲットが避けられない場合は適切な間隔が必要)を満たしている必要があります。スペースが許せば44x44pxを推奨します。
  • 代替テキスト: すべてのアンカー画像には説明的な代替テキストが必要か、装飾用としてマークされている必要があります。
  • キーボードナビゲーション: カード内のすべてのインタラクティブ要素はTabキーで到達可能であり、隣接するカードやスティッキーヘッダーによってクリップされたり隠されたりしないフォーカスインジケーターが必要です(WCAG 2.2 SC 2.4.11、フォーカスが隠されていないこと)。

決定ルール

  • 「3点」ルール: カードに3つ以上の明確な優先順位を持たせることはほとんど避けるべきです(例:1. 画像、2. タイトル、3. 価格)。詳細が多すぎると「ミニページ」になり、カードとは言えなくなります。
  • アスペクト比ルール: 画像のアスペクト比は一貫して使用します(例:4:3、16:9、または1:1)。そうしないと、グリッド内でのレイアウトが「跳ねる」原因になります。
  • 近接スコア: タイトルと説明の間のギャップは、説明とCTAの間のギャップよりも小さくする必要があります。
  • 「みなしご禁止」ルール: カードがグリッドの一部である場合、グリッドは残りのスペースを適切に処理する必要があります(例:grid-template-columns: repeat(auto-fill, minmax(280px, 1fr)))。
  • 等しい高さ: グリッド内では、同じ行のカードは理想的には同じ高さである必要があります(Flexboxのalign-items: stretchを使用)。
  • プライマリ vs セカンダリアクション: 視覚的に支配的なアクションは1つだけにすべきです(プライマリCTA)。他のアクション(例:「ウィッシュリストに保存」)はアイコンまたは低コントラストリンクにします。
  • インタラクティブアフォーダンス: カードがクリック可能な場合、目に見えるホバー状態が必要です。

制約

  • レスポンシブ性: カードはビューポート幅を超えてはならず、固定幅を持ってはいけません。responsive-grid-system内の列にまたがり、小さな画面では垂直に積み重なるか、水平レイアウトに切り替わる必要があります。
  • アクセシビリティ: キーボードナビゲーション(インタラクティブ要素をTabで移動)をサポートし、テキストの最小コントラスト比4.5:1を維持する必要があります。カード全体がクリック可能な場合は、「ストレッチリンク」パターンを使用して、スクリーンリーダーに冗長なリンクが作成されるのを避けます。
  • パフォーマンス: 過度に大きな画像を避け、srcsetを使用してカードコンテナに適切なサイズのアセットを提供します。
  • レイアウト: 固定ブレークポイントではなく、auto-fill/auto-fitとclamp()ベースのギャップを持つCSS Gridを優先してカードが自然にフローするようにし、カードの内部レイアウトがビューポートではなく自身の幅に適応する必要がある場合(例:同じカードが全幅グリッドと狭いサイドバーの両方にある場合)は、コンテナクエリ(@container)を使用します。

よくある失敗パターン

  • 「階段状/千鳥状ボタン」効果: タイトルの長さが異なるためにボタンが異なる高さに配置され、グリッドが見苦しくなる。
  • 過度な装飾: 境界線、シャドウ、グラデーションを使用しすぎて、コンテンツが読みにくくなる。
  • 低情報密度: カードを大きくしすぎてコンテンツが少なすぎるため、不必要なスクロールを強いる。
  • 情報過多: 1つのカードにあまりに多くの詳細を詰め込みすぎて、3点ルールを破り、ユーザーを混乱させる。
  • アクセス不能/見えないクリックターゲット: モバイルデバイスでタップしにくい小さなボタンやリンク、または実際のトリガーが小さなアイコンだけでカードをクリック可能に見せかけている。
  • パディング不足: テキストをカードの端や画像にぴったりと詰め込んでいる。

検証基準

  • 「3点ルール」(アンカー、コンテキスト、ターゲット)が明確に可視化されている。
  • 内部スペーシング(パディング/ギャップ)が流体スペーシングシステムのトークンを使用している。
  • タイポグラフィがサイトの確立されたスケールと階層に従っている。
  • プライマリアクション(ボタン)がグリッド行の下部で揃っている。
  • システム内のすべてのカードで画像のアスペクト比が一貫している。
  • インタラクティブ状態(ホバー/フォーカス)が定義され、アクセス可能である。
  • グリッド内のカードが正しく整列し、さまざまなコンテンツの長さを適切に処理している。
  • 見出しレベルがページ内で論理的な階層に従っている。
  • タッチターゲットがWCAG 2.2 SC 2.5.8(最小24x24px)を満たしている。
  • フォーカスインジケーターが重なっているカード、画像、またはスティッキー要素によって隠されることがない(WCAG 2.2 SC 2.4.11)。

Individual skills in this repo

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

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and specify a systematic dark theme framework, establishing rules for elevation-based surface colors, desaturated brand accents, text legibility, and media adaptation to ensure an accessible, low-fatigue experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

関連スキル