Communitygithub.com

coastdigitalgroup/coastai-skills

モバイルファーストのボトムシートオーバーレイシステムを設計します。設定可能なディテント(高さスナップ)、ドラッグアフォーダンス、セーフエリアパディング、レスポンシブなデスクトップモーダル/ポップオーバーへの適応、およびWCAG AAアクセシビリティ準拠を提供します。

coastai-skills とは?

このスキルは、モバイルファーストのWebアプリケーション向けに、標準化されたボトムシートデザインシステムを作成するための包括的なガイドラインを提供します。大きなアスペクト比を持つ現代のモバイルデバイスでは、画面下部にインタラクティブなタスクを配置することで、親指の自然なリーチ範囲内で操作できるため、ユーザビリティが向上します。このスキルは、ディテントスナップ高さ(最小表示、半画面、全画面)、タッチドラッグアフォーダンス(グラブハンドル)、背景の暗転(スクリム)、ボディスクロールロック、ビューポートのセーフエリアインセット、および1024px以上のビューポートでボトムシートを中央配置モーダルやポップオーバーに変換するレスポンシブデスクトップ適応戦略の設計手順を定義します。これにより、開発者は一貫性のあるアクセシブルなモバイルインタラクションを構築し、デスクトップでも洗練されたUIを提供できるようになります。

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

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

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

ドキュメント

ボトムシートデザインシステム

目的

ボトムシートデザインシステムは、WebインターフェースおよびプログレッシブWebアプリケーション(PWA)向けに、スライドアップ式ボトムシート、アクションシート、およびモーダルボトムドロワーのための、標準化されたモバイルファーストのデザインフレームワークを提供します。大きなアスペクト比を持つ現代のモバイルデバイスでは、画面上部に配置されたオーバーレイや中央のモーダルポップアップは片手で操作するのが困難です。ボトムシートは、対話型タスク、コンテキストメニュー、フィルターコントロール、および詳細なサブビューを画面下部に固定し、ユーザーの親指が自然に届く範囲内に配置します。

効果的なボトムシートシステムを設計するには、ディテントスナップ高さ(最小表示/折りたたみ、部分/半画面、全画面)、タッチドラッグアフォーダンス(グラブハンドル)、背景の暗転(スクリム/バックドロップ)、ボディスクロールロック機構、ビューポートのセーフエリアインセット(env(safe-area-inset-bottom))、およびシームレスなレスポンシブデスクトップ変換(広いビューポートでボトムシートを中央配置モーダルまたはポップオーバーに変換)を確立する必要があります。

ユースケース

  • モバイル製品オプションセレクター: eコマース商品詳細ページで、サイズ、色、数量、購読頻度セレクターを、PDPから移動することなく表示します。
  • モバイルフィルター&ソートコントロール: eコマースカタログページまたはSaaS検索ビューに、多面的なフィルタリングオプションを提供し、下部に「フィルターを適用」アクションバーを固定表示します。
  • コンテキストアクションシート: ソーシャルフィード、メディアカード、データテーブル上で、1タップクイックアクション(共有、ブックマーク、リストに追加、報告)をトリガーします。
  • ロケーション&マップ詳細カード: マップビュー上にスライドアップする、拡張可能なポイントオブインタレストの詳細や配送追跡タイムラインを表示します(最小表示から全画面まで拡張)。
  • モバイルマルチステップサブワークフロー: チェックアウト時の支払い方法選択、住所選択、簡単なフィードバック送信など、迅速なインラインタスクを完了します。

使用すべきでない場合

  • グローバルナビゲーションルーティング: 主要なアプリケーションセクション間のナビゲーションには、bottom-navigation-system または site-navigation-system を使用してください。
  • 破壊的な確認アラート: 「アカウント削除」など、重大で不可逆的なアクションには、明示的な確認を要求する中央配置の overlay-and-dialog-system モーダルダイアログ(role="alertdialog")を使用してください。
  • ページ内折りたたみコンテンツ: ページフロー内でインラインで展開可能なコンテンツを切り替えるには、accordion-ui-system または tab-ui-system を使用してください。
  • ワイドスクリーンデスクトップレイアウト(1024px超): デスクトップ画面で全幅のボトムシートを表示しないでください。代わりに、中央配置モーダルダイアログ(overlay-and-dialog-system)、サイドドロワー(dashboard-layout-system)、またはアンカー付きポップオーバー(tooltip-and-hint-system)に適応させてください。

入力

  1. タスクタイプと深さ: コンテンツの性質(クイック1タップアクションリスト、複数フィールドフォーム、スクロール可能な詳細リスト)。
  2. ディテント設定: スナップ高さの選択(単一ディテント: 100%全画面、二重ディテント: 50%半画面と100%全画面、三重ディテント: 20%最小表示、50%半画面、90%全画面)。
  3. トリガーコンテキスト: シートを起動する要素またはユーザーアクション(ボタンタップ、長押し、スワイプジェスチャー、ディープリンク)。
  4. デザイントークン: サーフェス背景色、境界半径、ドラッグハンドル寸法、エレベーションシャドウ、バックドロップ不透明度、タイポグラフィスケール。
  5. デスクトップ適応戦略: 1024px以上のビューポートに選択したレイアウト遷移(中央配置モーダルに変換、アンカー付きポップオーバーに変換、スライドインサイドドロワーに変換)。

出力

  1. ボトムシート構造仕様: ドラッグハンドルバー、ヘッダー(タイトル+閉じるボタン)、スクロール可能なボディ、固定フッター(CTAバー)、およびセーフエリアインセットパディングを定義するレイアウト設計図。
  2. ディテント高さとジェスチャートークンマトリックス: CSS変数とスナップ閾値の定義(--sheet-detent-peek、--sheet-detent-half、--sheet-detent-full)、およびドラッグ速度による却下ルール。
  3. バックドロップとエレベーション仕様: バックドロップ不透明度トークン、バックドロップブラーフィルター設定、z-index階層、およびボディスクロールロックルール(ボディの overflow: hidden)。
  4. キーボードとスクリーンリーダーのARIAマッピング: role="dialog"、aria-modal="true"、aria-labelledby、フォーカストラップ仕様、および Escape キーハンドラーの定義。
  5. レスポンシブデスクトップ適応設計図: モバイルボトムシートをタブレットおよびデスクトップ向けの中央配置モーダルダイアログまたはポップオーバーに変換するメディアクエリブレークポイント。

ワークフロー

1. シートタイプとディテント構造の分類

コンテンツ量とインタラクション頻度に基づいて、適切なディテントモードを選択します:

  • 非モーダルアクションシート(最小表示/フィットコンテンツ): 短いコンテンツ(2~5個のメニューアクション)に合わせて自動サイズ調整。高さは通常180px~320px。アクション選択またはバックドロップタップで解除されます。
  • 半画面/二重ディテントシート(ビューポートの50%と90%): 商品バリエーション選択や並べ替えなど、中程度の密度のタスクに使用。50%の高さ(50vh)で開き、上にドラッグすると90%の高さ(90vh)にスナップします。
  • 全画面/拡張シート(ビューポートの90%~100%): 多面フィルターやチェックアウトステップなど、複雑なモバイルワークフローに使用。固定ヘッダーとフッター、内部にスクロール可能なボディを提供します。

2. 視覚構造と空間階層の定義

5つの異なる構造レイヤーを使用してシートを構築します:

  • バックドロップ(スクリム): ビューポート全体を覆う固定オーバーレイ(background: rgba(0, 0, 0, 0.5); backdrop-filter: blur(4px); z-index: 1000;)。
  • シートコンテナ: 画面下部に固定されたパネル(position: fixed; bottom: 0; left: 0; right: 0; border-radius: 16px 16px 0 0; background: var(--surface-bg); z-index: 1001;)。
  • ドラッグハンドルバー(アフォーダンス): 上部中央の視覚的なピル(width: 36px; height: 5px; border-radius: 999px; background: var(--border-neutral); margin: 8px auto; cursor: grab;)。
  • ヘッダーレイヤー: シートタイトル(h2)、オプションのサブタイトル、明示的な閉じるボタン(<button aria-label="Close sheet">✕</button>)を含みます。
  • スクロール可能なボディレイヤー: overflow-y: auto; -webkit-overflow-scrolling: touch; で設定された内部コンテンツコンテナ。
  • 固定フッターCTAレイヤー: メイン/セカンダリボタンとセーフエリアインセットパディング(padding-bottom: calc(16px + env(safe-area-inset-bottom, 0px)))を備えた、下部に固定されたアクションバー。

3. ジェスチャー、スナップ、および却下メカニズムの確立

物理的なジェスチャーフィードバックのためのスムーズなタッチインタラクションを設定します:

  • ドラッグアフォーダンスインタラクション: ドラッグハンドルまたはヘッダーを下にドラッグすると、transform: translateY() を使用してシートがスムーズに下に移動します。
  • スナップ閾値:
    • 現在の高さの30%以上ドラッグダウンされた場合、または速度 > 0.5px/ms で下方向にフリックされた場合、完全に閉じることをトリガーします。
    • 二重ディテントモードで30%~70%の間でドラッグされた場合、最も近いディテント(50%または90%)にスナップします。
  • スクロールロックの衝突: スクロール可能なボディレイヤー内でドラッグする場合、ボディスクロール位置が scrollTop === 0 でユーザーが下方向にスワイプした場合にのみ、シートのドラッグによる閉じる操作を開始します。
  • ボディスクロールロック: モーダルボトムシートが開いているときは、document.body に overflow: hidden を適用して、背景ページのスクロール漏れを防ぎます。

4. ビューポートセーフエリアとサーフェスコントラストの実装

モバイルハードウェアのディスプレイ切り欠きやライト/ダークモードとの完全な視覚的統合を保証します:

  • セーフエリアインセット処理: 常に padding-bottom: env(safe-area-inset-bottom, 16px) をシートコンテナまたはスティッキーフッターに適用して、コンテンツ/ボタンがiOSホームインジケーターで隠れないようにします。
  • 最大高さ制限: 全画面シートの高さを max-height: calc(100vh - 48px) または max-height: calc(100dvh - 48px) に制限して、上部に暗転した親ページコンテキストの48pxのスライスを表示します。
  • サーフェスエレベーション: 深いエレベーションシャドウトークン(box-shadow: 0 -4px 24px rgba(0, 0, 0, 0.15))を使用して、背景ページコンテンツとの分離を作成します。

5. アクセシビリティとキーボードナビゲーションの設定

WCAG 2.1 / 2.2 AA 基準への完全な準拠を保証します:

  • ARIAロール: コンテナは role="dialog" または role="region"(非モーダル最小表示シートの場合)、aria-modal="true"、および aria-labelledby="sheet-title-id" を使用する必要があります。
  • フォーカス管理:
    • 開く際に、プログラムでフォーカスをシート内の最初のフォーカス可能要素または閉じるボタンに移動します。
    • フォーカストラップ を実装して、Tab または Shift+Tab がシートから非アクティブな背景に逃げるのを防ぎます。
    • 閉じる際に、シートを開いたトリガー要素にフォーカスを戻します。
  • キーボードコントロール: Escape キーを押すと、すぐにシートが閉じる必要があります。
  • スクリーンリーダー通知: シート内の動的なコンテンツ変更には、aria-live="polite" 領域を使用する必要があります。

6. レスポンシブデスクトップ適応の設計

デスクトップモニター(1024px以上)で全幅に引き伸ばされると、ボトムシートは見栄えが悪くなります。明示的なレスポンシブ変換ルールを実装します:

  • デスクトップモーダルモード(デフォルト): 1024px以上のビューポートでは、ボトムシートを中央配置のモーダルダイアログに変換します(width: 100%; max-width: 540px; border-radius: 16px; margin: auto; position: fixed; top: 50%; left: 50%; transform: translate(-50%, -50%);)。
  • デスクトップポップオーバーモード(コンテキストメニュー): クイックアクションシートの場合、シートをトリガーボタンの隣に配置されたアンカー付きポップオーバーに変換します。
  • デスクトップサイドドロワーモード(複雑なフォーム/フィルター): 深い多面フィルターやマルチステップフローの場合、右寄せのスライドインサイドドロワーに変換します(width: 400px; height: 100vh; top: 0; right: 0; border-radius: 16px 0 0 16px;)。

決定ルール

ディテント選択マトリックス

シートタイプディテント設定コンテンツ量理想的なユースケース
アクションシートフィットコンテンツ(単一ディテント)2~6個のアクションリンク/項目クイック共有、コンテキストメニュー、簡単なオプション切り替え。
選択シート二重ディテント(初期50vh、展開90vh)5~15個のスクロール可能項目商品サイズ/カラーピッカー、住所セレクター、支払い方法。
インタラクティブドロワー三重ディテント(120px最小表示、50vh、90vh)複雑な空間/マップデータ配送追跡マップカード、リアルタイム交通停留所、ライドシェア詳細。
フルフローシート単一ディテント(90vh~100vh固定)複数セクションフォーム/フィルターカタログ多面フィルター、モバイルチェックアウトステップ、サーベイワークフロー。

デスクトップ変換の選択

  • 中央配置モーダルを使用: シートに構造化フォーム、バリエーションセレクター、またはチェックアウトオプションが含まれる場合。
  • アンカー付きポップオーバーを使用: シートに短いコンテキストアクション(共有、編集、削除)が含まれる場合。
  • サイドドロワーを使用: シートにダッシュボードやデータテーブルのフィルターコントロールまたは編集パネルが含まれる場合。

制約

  • アクセシビリティ(WCAG 2.1 / 2.2 AA):
    • aria-modal="true" がアクティブな場合、明示的なフォーカストラップを提供する必要があります。
    • すべての内部項目と閉じるボタンのタッチターゲットは、少なくとも 44x44px である必要があります(WCAG 2.5.8 / 2.5.5)。
    • モーダルボトムシートの背後にある背景コンテンツは、inert としてマークするか、支援技術から隠す必要があります。
  • タッチ&ジェスチャーサイジング:
    • ドラッグハンドルのヒットターゲットは、視覚的なハンドルが36x5pxであっても、非表示パディング(min-height: 24px、min-width: 60px)で拡大する必要があります。
  • ビューポート動的単位:
    • サポートされている場合は dvh(動的ビューポート高さ)を使用し(height: 90dvh)、動的なモバイルアドレスバーの拡張と折りたたみに対応するために vh にフォールバックします。

一般的な障害パターン

  • セーフエリアパディングの欠如: env(safe-area-inset-bottom) を省略し、フッターのプライマリアクションボタンがiOSジェスチャーバーと重なる。
  • デスクトップでの全幅ストレッチ: モバイルボトムシートをデスクトップモニターで1920px幅に拡張してしまう。
  • スクロールハイジャックによるロック: コンテンツスクロールとシートのドラッグによる閉じるジェスチャーを分離できず、ユーザーがテキストを下にスクロールしようとするとシートが閉じてしまう。
  • キーボードのEscapeハンドラーの欠如: Escape キーのイベントリスナーを省略し、デスクトップのキーボードユーザーをモーダルシートオーバーレイ内に閉じ込めてしまう。
  • 背景へのフォーカス漏れ: モーダルボトムシートが開いているときに、背景ページ要素が Tab キーで到達可能なままになっている。

検証基準

  • シートレイアウトに、視覚的なドラッグアフォーダンス、タイトル付きヘッダー、スクロール可能なボディ、スティッキーフッターが含まれている。
  • セーフエリアインセット(padding-bottom: env(safe-area-inset-bottom))がスティッキーフッターとシートコンテナに実装されている。
  • ドラッグハンドルのヒットゾーンがタッチアクセシビリティのために最低44pxの高さを満たしている。
  • シートが role="dialog"、aria-modal="true"、aria-labelledby を使用し、アクティブな間フォーカスをトラップする。
  • Escape キーを押すか、バックドロップをタップすると、モーダルシートが閉じ、トリガーボタンにフォーカスが戻る。
  • モーダルシートが開いているとき、背景のボディスクロールがロックされている(overflow: hidden)。
  • 1024px以上のビューポートで、ボトムシートが中央配置モーダルダイアログ、ポップオーバー、またはサイドドロワーに適切に変換される。

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 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 modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

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.

関連スキル