{
  "name": "UI図鑑 (UI Zukan)",
  "url": "https://uizukan.dev",
  "description": "UI components and UI actions catalog with canonical names, aliases, platform names, and AI prompt examples (ja/en).",
  "categories": [
    {
      "id": "buttons",
      "kind": "component",
      "nameEn": "Buttons",
      "nameJa": "ボタン",
      "blurb": "押す部品。目立ち方ごとに名前がある。"
    },
    {
      "id": "inputs",
      "kind": "component",
      "nameEn": "Inputs & Selection",
      "nameJa": "入力",
      "blurb": "打つ、選ぶ、切り替える。"
    },
    {
      "id": "navigation",
      "kind": "component",
      "nameEn": "Navigation",
      "nameJa": "ナビゲーション",
      "blurb": "画面の上下で、行き先を示す。"
    },
    {
      "id": "surfaces",
      "kind": "component",
      "nameEn": "Surfaces & Overlays",
      "nameJa": "面・オーバーレイ",
      "blurb": "内容を載せる面。カード、シート、ダイアログ。"
    },
    {
      "id": "feedback",
      "kind": "component",
      "nameEn": "Feedback & Status",
      "nameJa": "フィードバック",
      "blurb": "状態と結果を知らせる。"
    },
    {
      "id": "display",
      "kind": "component",
      "nameEn": "Data Display",
      "nameJa": "表示",
      "blurb": "画像、リスト、数値を見せる。"
    },
    {
      "id": "gestures",
      "kind": "action",
      "nameEn": "Gestures",
      "nameJa": "ジェスチャー",
      "blurb": "タップ、長押し、スワイプ。指の動きの名前。"
    },
    {
      "id": "haptics",
      "kind": "action",
      "nameEn": "Haptics",
      "nameJa": "触覚フィードバック",
      "blurb": "振動の種類と使い分け。実機で体験。"
    },
    {
      "id": "transitions",
      "kind": "action",
      "nameEn": "Transitions",
      "nameJa": "画面遷移",
      "blurb": "画面と画面をつなぐ動き。"
    },
    {
      "id": "motion",
      "kind": "action",
      "nameEn": "Motion & Micro-interactions",
      "nameJa": "マイクロインタラクション",
      "blurb": "結果を伝える、小さな動き。"
    },
    {
      "id": "scrolling",
      "kind": "action",
      "nameEn": "Scrolling Behaviors",
      "nameJa": "スクロール挙動",
      "blurb": "スクロールに合わせて起きること。"
    }
  ],
  "entries": [
    {
      "id": "elevated_button",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/elevated_button/",
      "nameEn": "Elevated Button",
      "nameJa": "エレベーテッドボタン（浮き上がったボタン）",
      "aliases": [
        "Raised Button",
        "Shadow Button",
        "Z軸に浮いたボタン"
      ],
      "platformNames": {
        "material3": "Elevated button",
        "material2": "Contained button（影付き。さらに旧称は Raised button）",
        "compose": "ElevatedButton",
        "hig": "該当なし（Filled button に shadow を付けて表現）",
        "swiftUi": "該当なし（Button + .shadow() で表現）",
        "web": "<button>（box-shadow で elevation を表現）",
        "flutter": "ElevatedButton"
      },
      "summary": "影が付いて画面から少し浮き上がって見えるボタン。",
      "description": "背景色の面に影（elevation）を付け、Z軸方向に浮いているように見せたボタン。押すと影が深くなり「持ち上がる」ように反応する。Material 2 では Raised Button と呼ばれていた。",
      "whenToUse": "背景と同系色の面の上でボタンを目立たせたいとき。ただし Material 3 では「影は控えめに」が方針なので、主要アクションには Filled Button、影で浮かせたいときだけ Elevated Button を使う。",
      "tags": [
        "button",
        "elevation",
        "shadow",
        "影",
        "浮く",
        "浮いてるボタン",
        "浮いてる"
      ],
      "related": [
        "filled_button",
        "filled_tonal_button",
        "press_scale",
        "ripple"
      ],
      "needsDevice": false,
      "flutterApi": "ElevatedButton",
      "prompt": {
        "ja": "Material 3 の Elevated Button（影付きで少し浮き上がって見えるボタン）を作って。押している間は elevation が上がり、押し込んだ感が出るようにして。",
        "en": "Create a Material 3 Elevated Button (a button with a drop shadow that appears to float above the surface). Increase its elevation while pressed so it feels tactile."
      }
    },
    {
      "id": "filled_button",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/filled_button/",
      "nameEn": "Filled Button",
      "nameJa": "フィルドボタン（塗りつぶしボタン）",
      "aliases": [
        "Primary Button",
        "Contained Button",
        "CTA Button",
        "Solid Button"
      ],
      "platformNames": {
        "material3": "Filled button",
        "material2": "Contained button",
        "compose": "Button（既定が Filled）",
        "hig": "Button（prominent。UIKit の filled style）",
        "swiftUi": "Button + .buttonStyle(.borderedProminent)",
        "web": "<button>（Primary button）",
        "flutter": "FilledButton"
      },
      "summary": "画面で一番目立つ、塗りつぶされた主要アクション用ボタン。",
      "description": "primary 色でベタ塗りされたボタン。画面内で「一番押してほしい操作」を示す。影は基本なし（Material 3）。1画面に1つが原則。",
      "whenToUse": "「保存」「購入」「次へ」など、その画面の主目的となる操作。複数並べると強調が薄れるので、2番手は Filled Tonal / Outlined にする。",
      "tags": [
        "button",
        "primary",
        "cta",
        "主要",
        "塗りつぶし"
      ],
      "related": [
        "elevated_button",
        "filled_tonal_button",
        "outlined_button",
        "loading_button"
      ],
      "needsDevice": false,
      "flutterApi": "FilledButton",
      "prompt": {
        "ja": "画面の主要アクション用に、primary 色で塗りつぶした Filled Button（CTA ボタン）を作って。幅は画面いっぱい、高さ 52dp、角丸 14dp で。",
        "en": "Create a full-width primary Filled Button (CTA) for the main action of the screen. Height 52dp, corner radius 14dp, primary background with onPrimary text."
      }
    },
    {
      "id": "filled_tonal_button",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/filled_tonal_button/",
      "nameEn": "Filled Tonal Button",
      "nameJa": "トーナルボタン（淡色の塗りつぶしボタン）",
      "aliases": [
        "Secondary Button",
        "Tonal Button",
        "Soft Button"
      ],
      "platformNames": {
        "material3": "Filled tonal button",
        "material2": "該当なし（M3 で追加。近いのは secondary 色の Contained button）",
        "compose": "FilledTonalButton",
        "hig": "Button（UIKit の tinted style が相当）",
        "swiftUi": "Button + .buttonStyle(.bordered) + .tint()",
        "web": "該当なし（Secondary button として実装）",
        "flutter": "FilledButton.tonal"
      },
      "summary": "主要ボタンより一段控えめな、淡い色で塗られたボタン。",
      "description": "secondaryContainer 色で塗った中間の強調度のボタン。Filled ほど叫ばず、Outlined より存在感がある。iOS の「Tinted」ボタンに相当。",
      "whenToUse": "主要 CTA の隣に置く「もう一つの選択肢」（例：購入する／カートに入れる）。",
      "tags": [
        "button",
        "secondary",
        "tonal",
        "淡色"
      ],
      "related": [
        "filled_button",
        "outlined_button"
      ],
      "needsDevice": false,
      "flutterApi": "FilledButton.tonal",
      "prompt": {
        "ja": "主要ボタンの隣に、secondaryContainer 色で淡く塗った Filled Tonal Button を置いて。",
        "en": "Next to the primary button, add a Filled Tonal Button using the secondaryContainer color."
      }
    },
    {
      "id": "outlined_button",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/outlined_button/",
      "nameEn": "Outlined Button",
      "nameJa": "アウトラインボタン（枠線ボタン）",
      "aliases": [
        "Ghost Button",
        "Secondary Button",
        "Bordered Button"
      ],
      "platformNames": {
        "material3": "Outlined button",
        "material2": "Outlined button",
        "compose": "OutlinedButton",
        "hig": "該当なし（UIKit の style は plain / gray / tinted / filled の 4 種）",
        "swiftUi": "該当なし（.overlay(Capsule().stroke()) で自作）",
        "web": "<button>（Outlined / Secondary button）",
        "flutter": "OutlinedButton"
      },
      "summary": "背景を塗らず、枠線だけで形を作った控えめなボタン。",
      "description": "1dp の枠線と透明背景のボタン。主要アクションの邪魔をしない補助的な操作に向く。",
      "whenToUse": "「キャンセル」「あとで」「詳細を見る」など、主要 CTA と並ぶ二次的な操作。",
      "tags": [
        "button",
        "outline",
        "border",
        "枠線"
      ],
      "related": [
        "text_button",
        "filled_tonal_button"
      ],
      "needsDevice": false,
      "flutterApi": "OutlinedButton",
      "prompt": {
        "ja": "枠線だけの Outlined Button を作って。枠は 1dp の outline 色、角丸 12dp、文字は primary 色。",
        "en": "Create an Outlined Button: 1dp outline-colored border, transparent background, 12dp corner radius, primary-colored label."
      }
    },
    {
      "id": "text_button",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/text_button/",
      "nameEn": "Text Button",
      "nameJa": "テキストボタン",
      "aliases": [
        "Flat Button",
        "Link Button",
        "Plain Button"
      ],
      "platformNames": {
        "material3": "Text button",
        "material2": "Text button",
        "compose": "TextButton",
        "hig": "Button（UIKit の plain style）",
        "swiftUi": "Button + .buttonStyle(.plain) / .borderless",
        "web": "<button>（Tertiary / Link-style button）",
        "flutter": "TextButton"
      },
      "summary": "文字だけで背景も枠もない、最も控えめなボタン。",
      "description": "文字色（primary）だけで「押せる」ことを示す。ダイアログの「OK / キャンセル」や、カード内の補助リンクに使う。",
      "whenToUse": "ダイアログのアクション、「すべて見る」「パスワードをお忘れですか？」のような補助リンク。",
      "tags": [
        "button",
        "flat",
        "link",
        "テキスト"
      ],
      "related": [
        "outlined_button",
        "alert_dialog"
      ],
      "needsDevice": false,
      "flutterApi": "TextButton",
      "prompt": {
        "ja": "「パスワードをお忘れですか？」を Text Button（背景も枠もない文字だけのボタン）にして、フォームの右下に置いて。",
        "en": "Make \"Forgot password?\" a Text Button (label only, no background or border), aligned to the bottom-right of the form."
      }
    },
    {
      "id": "icon_button",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/icon_button/",
      "nameEn": "Icon Button",
      "nameJa": "アイコンボタン",
      "aliases": [
        "Toggle Icon Button",
        "Icon-only Button"
      ],
      "platformNames": {
        "material3": "Icon button（Standard / Filled / Filled tonal / Outlined）",
        "material2": "Icon button",
        "compose": "IconButton / FilledIconButton / FilledTonalIconButton / OutlinedIconButton",
        "hig": "Button（SF Symbol のみ。専用名は無い）",
        "swiftUi": "Button { Image(systemName:) } / Label + .labelStyle(.iconOnly)",
        "web": "<button aria-label=\"…\">（Icon button）",
        "flutter": "IconButton / IconButton.filled / IconButton.filledTonal / IconButton.outlined"
      },
      "summary": "アイコンだけのボタン。ON/OFF で見た目が変わるトグル型もある。",
      "description": "文字のないアイコンだけのボタン。App Bar の右上や、カードの「お気に入り」などに使われる。Material 3 では standard / filled / tonal / outlined の4段階と、選択状態を持つ toggle 型がある。",
      "whenToUse": "意味がアイコンで十分伝わる操作（検索・共有・お気に入り・その他メニュー）。",
      "tags": [
        "button",
        "icon",
        "toggle",
        "お気に入り",
        "ハート"
      ],
      "related": [
        "fab",
        "like_burst",
        "app_bar"
      ],
      "needsDevice": false,
      "flutterApi": "IconButton / IconButton.filled / IconButton.filledTonal / IconButton.outlined",
      "prompt": {
        "ja": "ハートのトグル型 Icon Button を作って。未選択は Icons.favorite_border、選択中は Icons.favorite を赤で表示。",
        "en": "Create a toggle Icon Button with a heart: Icons.favorite_border when unselected, Icons.favorite in red when selected."
      }
    },
    {
      "id": "fab",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/fab/",
      "nameEn": "Floating Action Button",
      "nameJa": "フローティングアクションボタン（FAB）",
      "aliases": [
        "FAB",
        "Floating Button",
        "浮いている丸ボタン"
      ],
      "platformNames": {
        "material3": "Floating action button（FAB）",
        "material2": "Floating action button（Regular / Mini）",
        "compose": "FloatingActionButton / SmallFloatingActionButton / LargeFloatingActionButton",
        "hig": "該当なし（iOS 標準には無い。Toolbar の主ボタンで代替）",
        "swiftUi": "該当なし（ZStack + Button で自作）",
        "web": "該当なし（Material 系ライブラリの FAB）",
        "flutter": "FloatingActionButton"
      },
      "summary": "画面右下に浮かぶ、最重要アクション用の丸いボタン。",
      "description": "画面のスクロール内容の上に固定で浮かぶボタン。「新規作成」「投稿」など、その画面の代表的な操作を1つだけ載せる。Material 3 では角丸四角（16dp）が標準。",
      "whenToUse": "リスト画面での「追加」、メール画面での「作成」など、どの位置でも押せる必要がある主要操作。",
      "tags": [
        "button",
        "fab",
        "floating",
        "追加",
        "右下"
      ],
      "related": [
        "extended_fab",
        "icon_button",
        "scroll_to_hide_bar"
      ],
      "needsDevice": false,
      "flutterApi": "FloatingActionButton",
      "prompt": {
        "ja": "画面右下に「＋」の Floating Action Button（FAB）を置いて。Material 3 の角丸四角スタイルで。",
        "en": "Add a \"+\" Floating Action Button (FAB) at the bottom-right of the screen, Material 3 rounded-square style."
      }
    },
    {
      "id": "extended_fab",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/extended_fab/",
      "nameEn": "Extended FAB",
      "nameJa": "拡張 FAB（ラベル付き FAB）",
      "aliases": [
        "Extended Floating Action Button",
        "Labeled FAB"
      ],
      "platformNames": {
        "material3": "Extended FAB",
        "material2": "Extended FAB",
        "compose": "ExtendedFloatingActionButton",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": "該当なし（ZStack + Button + Label で自作）",
        "web": "該当なし（Material 系ライブラリの Extended FAB）",
        "flutter": "FloatingActionButton.extended"
      },
      "summary": "アイコンと文字ラベルが付いた横長の FAB。",
      "description": "通常の FAB にテキストを添えた横長版。スクロールで通常 FAB に縮む（collapse）動きと組み合わせることが多い。",
      "whenToUse": "アイコンだけでは意味が伝わりにくい主要操作（例：「新しいメモ」「ルートを開始」）。",
      "tags": [
        "button",
        "fab",
        "extended",
        "ラベル"
      ],
      "related": [
        "fab",
        "scroll_to_hide_bar"
      ],
      "needsDevice": false,
      "flutterApi": "FloatingActionButton.extended",
      "prompt": {
        "ja": "アイコン＋「新規作成」ラベル付きの Extended FAB を右下に置いて。下にスクロールするとラベルが消えて丸い FAB に縮むようにして。",
        "en": "Add an Extended FAB with an icon and a \"Create\" label at the bottom-right. When scrolling down, collapse it into a regular icon-only FAB."
      }
    },
    {
      "id": "segmented_button",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/segmented_button/",
      "nameEn": "Segmented Button",
      "nameJa": "セグメントボタン（セグメンテッドコントロール）",
      "aliases": [
        "Segmented Control",
        "Sliding Segmented Control",
        "Tab Switch",
        "Pill Toggle"
      ],
      "platformNames": {
        "material3": "Segmented button",
        "material2": "該当なし（Toggle button（MaterialButtonToggleGroup）が相当）",
        "compose": "SingleChoiceSegmentedButtonRow / MultiChoiceSegmentedButtonRow + SegmentedButton",
        "hig": "Segmented control",
        "swiftUi": "Picker + .pickerStyle(.segmented)",
        "web": "該当なし（role=\"radiogroup\" で実装）",
        "flutter": "SegmentedButton / CupertinoSlidingSegmentedControl"
      },
      "summary": "複数の選択肢を横一列につなげ、1つ（または複数）を選ぶ切替ボタン。",
      "description": "2〜5個の選択肢を同じ幅で横に並べ、選択中の区画を強調するコントロール。iOS ではハイライトが滑らかにスライドする「Sliding Segmented Control」が標準。",
      "whenToUse": "表示モードの切替（リスト／グリッド）、期間の切替（日／週／月）など、少数の排他的な選択。",
      "tags": [
        "button",
        "segmented",
        "toggle",
        "切替",
        "タブ"
      ],
      "related": [
        "toggle_buttons",
        "tab_bar",
        "chips"
      ],
      "needsDevice": false,
      "flutterApi": "SegmentedButton / CupertinoSlidingSegmentedControl",
      "prompt": {
        "ja": "「日 / 週 / 月」を切り替える Segmented Button を作って。iOS 風に、選択のハイライトが滑らかにスライドする Sliding Segmented Control で。",
        "en": "Create a Segmented Control to switch between \"Day / Week / Month\". Use the iOS-style sliding segmented control where the highlight slides smoothly."
      }
    },
    {
      "id": "toggle_buttons",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/toggle_buttons/",
      "nameEn": "Toggle Button Group",
      "nameJa": "トグルボタン群",
      "aliases": [
        "Toggle Buttons",
        "Button Group",
        "Icon Toggle Group"
      ],
      "platformNames": {
        "material3": "Toggle button / Button group（connected）",
        "material2": "Toggle button",
        "compose": "IconToggleButton / ButtonGroup",
        "hig": "該当なし（Segmented control で代替。macOS は Toggle 型ボタン）",
        "swiftUi": "Toggle + .toggleStyle(.button)",
        "web": "<button aria-pressed>（Toggle button）",
        "flutter": "ToggleButtons"
      },
      "summary": "複数の ON/OFF ボタンを連結したもの。書式（太字・斜体）の切替が典型。",
      "description": "アイコンボタンを横につなげ、それぞれを独立して ON/OFF できる。Material 3 では Segmented Button（multi-select）で代替される。",
      "whenToUse": "テキストエディタの太字／斜体／下線、整列（左／中央／右）など、複数同時に成立する設定。",
      "tags": [
        "button",
        "toggle",
        "group",
        "書式"
      ],
      "related": [
        "segmented_button",
        "chips"
      ],
      "needsDevice": false,
      "flutterApi": "ToggleButtons",
      "prompt": {
        "ja": "太字・斜体・下線を個別に ON/OFF できる Toggle Button Group（複数選択可）を作って。",
        "en": "Create a Toggle Button Group for bold / italic / underline where each can be toggled independently."
      }
    },
    {
      "id": "chips",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/chips/",
      "nameEn": "Chip",
      "nameJa": "チップ",
      "aliases": [
        "Filter Chip",
        "Choice Chip",
        "Input Chip",
        "Assist Chip",
        "Tag",
        "Pill"
      ],
      "platformNames": {
        "material3": "Chips（Assist / Filter / Input / Suggestion）",
        "material2": "Chips（Action / Choice / Filter / Input）",
        "compose": "AssistChip / FilterChip / InputChip / SuggestionChip",
        "hig": "該当なし（Token field（macOS）が近い。iOS は自作）",
        "swiftUi": "該当なし（Button / Label + Capsule で自作）",
        "web": "該当なし（Chip / Tag。role=\"button\" か checkbox で実装）",
        "flutter": "FilterChip / ChoiceChip / InputChip / ActionChip"
      },
      "summary": "小さな角丸の「粒」。フィルタ・選択・入力済みタグなど、種類ごとに名前がある。",
      "description": "短いラベルを持つコンパクトな要素。Material 3 では用途で4種類に分かれる：Assist（操作の起点）、Filter（絞り込み ON/OFF）、Input（入力済みの値、×で削除）、Suggestion（候補）。1つだけ選ぶ Choice Chip は Filter Chip の単一選択版。",
      "whenToUse": "検索結果の絞り込み（Filter）、複数タグの入力（Input）、カテゴリ選択（Choice）。",
      "tags": [
        "chip",
        "tag",
        "pill",
        "filter",
        "タグ",
        "絞り込み"
      ],
      "related": [
        "segmented_button",
        "search_bar",
        "toggle_buttons"
      ],
      "needsDevice": false,
      "flutterApi": "FilterChip / ChoiceChip / InputChip / ActionChip",
      "prompt": {
        "ja": "検索画面の上に、横スクロールする Filter Chip の列を作って。「すべて／未読／スター付き／添付あり」で、複数 ON にできるように。",
        "en": "Above the search results, add a horizontally scrolling row of Filter Chips: \"All / Unread / Starred / Attachments\", allowing multiple selection."
      }
    },
    {
      "id": "cupertino_button",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/cupertino_button/",
      "nameEn": "Cupertino Button",
      "nameJa": "iOS 風ボタン",
      "aliases": [
        "iOS Button",
        "Plain Button (iOS)",
        "System Button"
      ],
      "platformNames": {
        "material3": "該当なし（iOS 固有）",
        "material2": "該当なし（iOS 固有）",
        "compose": "該当なし（iOS 固有）",
        "hig": "Button（UIKit の style: plain / gray / tinted / filled）",
        "swiftUi": "Button + .buttonStyle(.plain / .bordered / .borderedProminent)",
        "web": "該当なし（iOS 固有）",
        "flutter": "CupertinoButton / CupertinoButton.filled / CupertinoButton.tinted"
      },
      "summary": "iOS 標準の見た目のボタン。押すと半透明に沈むのが特徴。",
      "description": "iOS の HIG に沿ったボタン。Material のリップルではなく、押下中に不透明度が下がる（opacity 0.4）反応をする。plain（文字のみ）と filled（塗りつぶし）がある。",
      "whenToUse": "iOS らしさを保ちたい画面。Material のリップルが浮いて見えるとき。",
      "tags": [
        "button",
        "ios",
        "cupertino",
        "iOS風"
      ],
      "related": [
        "text_button",
        "filled_button",
        "press_scale"
      ],
      "needsDevice": false,
      "flutterApi": "CupertinoButton / CupertinoButton.filled / CupertinoButton.tinted",
      "prompt": {
        "ja": "iOS 標準風の CupertinoButton.filled を作って。押している間は不透明度が下がる iOS らしい反応で、リップルは出さないで。",
        "en": "Create an iOS-style CupertinoButton.filled. It should dim (opacity) while pressed, without a Material ripple."
      }
    },
    {
      "id": "loading_button",
      "kind": "component",
      "category": "buttons",
      "url": "https://uizukan.dev/entry/loading_button/",
      "nameEn": "Loading Button",
      "nameJa": "ローディング状態付きボタン",
      "aliases": [
        "Async Button",
        "Progress Button",
        "Submit Button with Spinner"
      ],
      "platformNames": {
        "material3": "該当なし（Button + Loading indicator（M3 Expressive）の組み合わせ）",
        "material2": "該当なし（Button + Circular progress indicator）",
        "compose": "該当なし（Button + CircularProgressIndicator / LoadingIndicator）",
        "hig": "該当なし（Button + Activity indicator）",
        "swiftUi": "該当なし（Button + ProgressView）",
        "web": "該当なし（<button aria-busy=\"true\"> + spinner）",
        "flutter": "FilledButton + CircularProgressIndicator"
      },
      "summary": "押すと中身がスピナーに変わり、処理中は再タップできないボタン。",
      "description": "ボタン内のラベルが処理中は小さな CircularProgressIndicator に置き換わり、完了後は元に戻る（またはチェックマークになる）。二重送信を防ぎ、「待ち」を伝える定番パターン。",
      "whenToUse": "ログイン・購入・送信など、サーバー通信を伴うすべての主要ボタン。",
      "tags": [
        "button",
        "loading",
        "spinner",
        "async",
        "送信",
        "二重送信防止"
      ],
      "related": [
        "filled_button",
        "circular_progress",
        "crossfade"
      ],
      "needsDevice": false,
      "flutterApi": "FilledButton + CircularProgressIndicator",
      "prompt": {
        "ja": "「ログイン」ボタンを、押すとラベルが小さなスピナーに変わり、処理中は無効化される Loading Button にして。完了したら 0.8 秒だけチェックマークを見せてから元に戻して。",
        "en": "Make the \"Log in\" button a Loading Button: on tap the label becomes a small spinner and the button is disabled while busy. On success show a checkmark for 0.8s, then restore."
      }
    },
    {
      "id": "text_field_outlined",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/text_field_outlined/",
      "nameEn": "Outlined Text Field",
      "nameJa": "アウトライン付きテキストフィールド",
      "aliases": [
        "Outlined Input",
        "Text Input",
        "Bordered Text Field"
      ],
      "platformNames": {
        "material3": "Outlined text field",
        "material2": "Outlined text field",
        "compose": "OutlinedTextField",
        "hig": "Text fields",
        "swiftUi": "TextField + .textFieldStyle(.roundedBorder)",
        "web": "<input type=\"text\">",
        "flutter": "TextField / TextFormField + OutlineInputBorder"
      },
      "summary": "枠線で囲まれ、ラベルが枠の上に浮き上がる文字入力欄。",
      "description": "枠線（outline）で囲まれた入力欄。フォーカスすると枠が primary 色になり、ラベルが枠線の切れ目に小さく浮き上がる（floating label）。ヒント・エラー文・文字数カウンタを下に出せる。",
      "whenToUse": "フォーム全般。背景が白っぽく Filled だと目立たないとき。",
      "tags": [
        "input",
        "text field",
        "form",
        "入力",
        "フォーム"
      ],
      "related": [
        "text_field_filled",
        "password_field",
        "shake"
      ],
      "needsDevice": false,
      "flutterApi": "TextField / TextFormField + OutlineInputBorder",
      "prompt": {
        "ja": "メールアドレス用の Outlined Text Field を作って。ラベル「メールアドレス」がフォーカスで枠の上に浮き上がり、不正な形式なら枠が赤くなって下にエラー文が出るように。",
        "en": "Create an Outlined Text Field for email. The \"Email\" label should float onto the border on focus; when the format is invalid, turn the border red and show an error message below."
      }
    },
    {
      "id": "text_field_filled",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/text_field_filled/",
      "nameEn": "Filled Text Field",
      "nameJa": "塗りつぶしテキストフィールド",
      "aliases": [
        "Filled Input",
        "Underline Text Field"
      ],
      "platformNames": {
        "material3": "Filled text field",
        "material2": "Filled text field",
        "compose": "TextField（既定が Filled）",
        "hig": "Text fields",
        "swiftUi": "TextField（.plain + 背景で表現）",
        "web": "<input type=\"text\">",
        "flutter": "TextField + InputDecoration(filled: true)"
      },
      "summary": "背景を薄く塗り、下線だけで区切った入力欄。",
      "description": "薄い背景色（surfaceContainerHighest）と下線で構成される入力欄。上部の角だけ丸い。Material らしさが強い。",
      "whenToUse": "入力欄が多く枠線だらけになるフォーム。検索や1行入力の軽い場面。",
      "tags": [
        "input",
        "text field",
        "filled",
        "入力"
      ],
      "related": [
        "text_field_outlined",
        "search_bar"
      ],
      "needsDevice": false,
      "flutterApi": "TextField + InputDecoration(filled: true)",
      "prompt": {
        "ja": "背景を薄く塗って下線だけで区切る Filled Text Field を作って。上の角だけ丸くして。",
        "en": "Create a Filled Text Field: light filled background, bottom underline only, top corners rounded."
      }
    },
    {
      "id": "password_field",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/password_field/",
      "nameEn": "Password Field with Visibility Toggle",
      "nameJa": "表示切替付きパスワード欄",
      "aliases": [
        "Obscured Text Field",
        "Secure Text Field",
        "Show/Hide Password"
      ],
      "platformNames": {
        "material3": "該当なし（Text field の trailing icon で表現）",
        "material2": "該当なし（Text field の trailing icon で表現）",
        "compose": "TextField + PasswordVisualTransformation",
        "hig": "Text fields（Secure text field）",
        "swiftUi": "SecureField（表示切替は TextField と入れ替え）",
        "web": "<input type=\"password\">",
        "flutter": "TextField(obscureText:) + suffixIcon"
      },
      "summary": "入力を●で隠し、目のアイコンで表示／非表示を切り替えるパスワード欄。",
      "description": "obscureText で文字を隠した入力欄。末尾（suffix）の目アイコンで一時的に平文表示できる。",
      "whenToUse": "ログイン・登録・パスワード変更。",
      "tags": [
        "input",
        "password",
        "secure",
        "obscure",
        "パスワード",
        "目のアイコン"
      ],
      "related": [
        "text_field_outlined",
        "icon_button"
      ],
      "needsDevice": false,
      "flutterApi": "TextField(obscureText:) + suffixIcon",
      "prompt": {
        "ja": "パスワード入力欄を作って。●で隠し、右端の目のアイコン（visibility / visibility_off）で表示・非表示を切り替えられるように。",
        "en": "Create a password field that masks input with dots and has an eye icon (visibility / visibility_off) at the trailing edge to toggle visibility."
      }
    },
    {
      "id": "search_bar",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/search_bar/",
      "nameEn": "Search Bar",
      "nameJa": "検索バー",
      "aliases": [
        "Search Field",
        "Search Box",
        "Search Input"
      ],
      "platformNames": {
        "material3": "Search（Search bar / Search view）",
        "material2": "該当なし（Text field で実装）",
        "compose": "SearchBar / DockedSearchBar",
        "hig": "Search fields",
        "swiftUi": ".searchable(text:)",
        "web": "<input type=\"search\"> / <search>",
        "flutter": "SearchBar / SearchAnchor / CupertinoSearchTextField"
      },
      "summary": "虫眼鏡アイコン付きの角丸の入力欄。タップで検索画面に展開することもある。",
      "description": "丸みの強い（pill 型）入力欄に検索アイコンを添えたもの。Material 3 では SearchBar と、タップで全画面の候補一覧に広がる SearchAnchor（Search view）がセット。iOS では入力中に「キャンセル」が右に現れる。",
      "whenToUse": "一覧画面の先頭、App Bar の中。",
      "tags": [
        "input",
        "search",
        "検索",
        "虫眼鏡"
      ],
      "related": [
        "chips",
        "autocomplete",
        "text_field_filled"
      ],
      "needsDevice": false,
      "flutterApi": "SearchBar / SearchAnchor / CupertinoSearchTextField",
      "prompt": {
        "ja": "一覧画面の上に Material 3 の Search Bar（pill 型・虫眼鏡アイコン付き）を置いて。タップすると候補一覧が全画面で開く SearchAnchor にして。",
        "en": "Put a Material 3 Search Bar (pill-shaped with a search icon) above the list. Tapping it should open a full-screen suggestions view using SearchAnchor."
      }
    },
    {
      "id": "checkbox",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/checkbox/",
      "nameEn": "Checkbox",
      "nameJa": "チェックボックス",
      "aliases": [
        "Check Box",
        "Tick Box",
        "Checkbox List Tile"
      ],
      "platformNames": {
        "material3": "Checkbox",
        "material2": "Checkbox（Selection controls）",
        "compose": "Checkbox / TriStateCheckbox",
        "hig": "該当なし（iOS 標準には無い。iOS は Toggle、macOS は Checkbox）",
        "swiftUi": "Toggle + .toggleStyle(.checkbox)（macOS）",
        "web": "<input type=\"checkbox\">",
        "flutter": "Checkbox / CheckboxListTile"
      },
      "summary": "複数選択できる四角いチェック。行全体をタップできる CheckboxListTile もある。",
      "description": "四角の中にチェックマークが入る ON/OFF。tristate で「一部選択（−）」も表せる。ラベル付き行にするなら CheckboxListTile。",
      "whenToUse": "複数項目の同時選択（利用規約への同意、設定の複数 ON など）。単一の ON/OFF なら Switch の方が自然。",
      "tags": [
        "input",
        "checkbox",
        "check",
        "チェック",
        "同意"
      ],
      "related": [
        "radio_button",
        "switch_toggle",
        "list_tile"
      ],
      "needsDevice": false,
      "flutterApi": "Checkbox / CheckboxListTile",
      "prompt": {
        "ja": "「利用規約に同意する」を CheckboxListTile で作って。行全体をタップしてチェックできて、チェックが入るまで「登録」ボタンは無効にして。",
        "en": "Create an \"I agree to the Terms\" CheckboxListTile. The whole row should be tappable, and the \"Sign up\" button stays disabled until it is checked."
      }
    },
    {
      "id": "radio_button",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/radio_button/",
      "nameEn": "Radio Button",
      "nameJa": "ラジオボタン",
      "aliases": [
        "Radio Group",
        "Option Button",
        "Radio List Tile"
      ],
      "platformNames": {
        "material3": "Radio button",
        "material2": "Radio button（Selection controls）",
        "compose": "RadioButton",
        "hig": "該当なし（iOS 標準には無い。チェックマーク付き List か Picker で代替。macOS は Radio button）",
        "swiftUi": "Picker + .pickerStyle(.radioGroup)（macOS）/ .inline",
        "web": "<input type=\"radio\">",
        "flutter": "Radio / RadioListTile"
      },
      "summary": "複数の候補から1つだけ選ぶ丸いボタン。",
      "description": "同じ groupValue を共有する丸い選択肢。1つを選ぶと他は自動で外れる。",
      "whenToUse": "2〜5個の排他的選択（配送方法、支払い方法）。候補が多ければ Dropdown、2択なら Segmented Button も検討。",
      "tags": [
        "input",
        "radio",
        "単一選択",
        "排他"
      ],
      "related": [
        "checkbox",
        "segmented_button",
        "dropdown_menu"
      ],
      "needsDevice": false,
      "flutterApi": "Radio / RadioListTile",
      "prompt": {
        "ja": "支払い方法（クレジットカード／コンビニ／銀行振込）を RadioListTile で1つだけ選べるようにして。",
        "en": "Let the user choose one payment method (Credit card / Convenience store / Bank transfer) using RadioListTiles."
      }
    },
    {
      "id": "switch_toggle",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/switch_toggle/",
      "nameEn": "Toggle Switch",
      "nameJa": "トグルスイッチ",
      "aliases": [
        "Switch",
        "Toggle",
        "On/Off Switch"
      ],
      "platformNames": {
        "material3": "Switch",
        "material2": "Switch（Selection controls）",
        "compose": "Switch",
        "hig": "Toggles（Switch）",
        "swiftUi": "Toggle（.switch）",
        "web": "<input type=\"checkbox\" role=\"switch\">",
        "flutter": "Switch / Switch.adaptive / CupertinoSwitch"
      },
      "summary": "左右にスライドして ON/OFF を切り替える。設定画面の定番。",
      "description": "つまみ（thumb）が左右に動いて ON/OFF を示す。切り替えた瞬間に効果が反映されるのが原則（保存ボタン不要）。",
      "whenToUse": "設定の即時 ON/OFF（通知・ダークモード）。フォームの送信を伴う選択には Checkbox。",
      "tags": [
        "input",
        "switch",
        "toggle",
        "スイッチ",
        "設定"
      ],
      "related": [
        "checkbox",
        "list_tile",
        "haptic_on_toggle"
      ],
      "needsDevice": false,
      "flutterApi": "Switch / Switch.adaptive / CupertinoSwitch",
      "prompt": {
        "ja": "設定画面の「プッシュ通知」行を SwitchListTile にして。iOS では iOS 風、Android では Material 風になる Switch.adaptive で。",
        "en": "Make the \"Push notifications\" row a SwitchListTile using Switch.adaptive, so it looks native on both iOS and Android."
      }
    },
    {
      "id": "slider",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/slider/",
      "nameEn": "Slider",
      "nameJa": "スライダー",
      "aliases": [
        "Seek Bar",
        "Range Input",
        "Discrete Slider"
      ],
      "platformNames": {
        "material3": "Slider",
        "material2": "Slider（Continuous / Discrete）",
        "compose": "Slider",
        "hig": "Sliders",
        "swiftUi": "Slider",
        "web": "<input type=\"range\">",
        "flutter": "Slider / CupertinoSlider"
      },
      "summary": "つまみを横に動かして値を選ぶ。目盛り付きの離散型もある。",
      "description": "トラック上のつまみを動かして連続値を選ぶ。divisions を指定すると目盛りに吸着する離散型になり、label で現在値を吹き出し表示できる。",
      "whenToUse": "音量・明るさ・価格帯など「だいたい」でよい値。正確な数値が必要なら数値入力と併用。",
      "tags": [
        "input",
        "slider",
        "range",
        "音量",
        "つまみ"
      ],
      "related": [
        "range_slider",
        "stepper_input"
      ],
      "needsDevice": false,
      "flutterApi": "Slider / CupertinoSlider",
      "prompt": {
        "ja": "0〜100 を 5 刻みで選べる離散型 Slider を作って。ドラッグ中はつまみの上に現在値を吹き出し表示して。",
        "en": "Create a discrete Slider from 0 to 100 in steps of 5. While dragging, show the current value in a label bubble above the thumb."
      }
    },
    {
      "id": "range_slider",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/range_slider/",
      "nameEn": "Range Slider",
      "nameJa": "範囲スライダー",
      "aliases": [
        "Dual Slider",
        "Two-thumb Slider",
        "Min-Max Slider"
      ],
      "platformNames": {
        "material3": "Range slider",
        "material2": "Range slider",
        "compose": "RangeSlider",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": "該当なし（Slider を 2 本、または自作）",
        "web": "該当なし（Slider (Multi-Thumb)（WAI-ARIA パターン））",
        "flutter": "RangeSlider"
      },
      "summary": "つまみが2つあり、下限と上限を同時に選ぶスライダー。",
      "description": "2つのつまみで区間を選ぶ。価格帯・年齢層のフィルタでよく使われる。",
      "whenToUse": "検索フィルタの「価格：¥1,000〜¥5,000」のような範囲指定。",
      "tags": [
        "input",
        "slider",
        "range",
        "価格帯",
        "範囲"
      ],
      "related": [
        "slider",
        "modal_bottom_sheet",
        "chips"
      ],
      "needsDevice": false,
      "flutterApi": "RangeSlider",
      "prompt": {
        "ja": "価格帯を選ぶ Range Slider（つまみ2つ）を作って。0〜10,000 円で、上に「¥1,000 〜 ¥5,000」のように現在の範囲を表示して。",
        "en": "Create a two-thumb Range Slider for a price range from 0 to 10,000 yen, showing the selected range above as \"¥1,000 – ¥5,000\"."
      }
    },
    {
      "id": "dropdown_menu",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/dropdown_menu/",
      "nameEn": "Dropdown Menu",
      "nameJa": "ドロップダウン（プルダウン）",
      "aliases": [
        "Select",
        "Pulldown",
        "Combo Box",
        "Dropdown Button",
        "Exposed Dropdown"
      ],
      "platformNames": {
        "material3": "Menus（Exposed dropdown menu）",
        "material2": "Exposed dropdown menu",
        "compose": "ExposedDropdownMenuBox + DropdownMenu",
        "hig": "Pop-up buttons",
        "swiftUi": "Picker + .pickerStyle(.menu) / Menu",
        "web": "<select> / Combobox（WAI-ARIA パターン）",
        "flutter": "DropdownMenu / DropdownButtonFormField"
      },
      "summary": "タップすると候補リストが下に開き、1つ選ぶ入力欄。",
      "description": "入力欄の見た目で、タップするとメニューが展開する。Material 3 の DropdownMenu は文字入力で候補を絞ることもできる。",
      "whenToUse": "候補が 5〜15 個程度の単一選択（都道府県、カテゴリ）。候補が少なければ Radio/Segmented、多ければ検索付きの別画面。",
      "tags": [
        "input",
        "dropdown",
        "select",
        "プルダウン",
        "選択"
      ],
      "related": [
        "radio_button",
        "autocomplete",
        "cupertino_picker",
        "popup_menu"
      ],
      "needsDevice": false,
      "flutterApi": "DropdownMenu / DropdownButtonFormField",
      "prompt": {
        "ja": "カテゴリを選ぶ Material 3 の Dropdown Menu を作って。入力欄の見た目で、タップで候補が下に開くように。",
        "en": "Create a Material 3 Dropdown Menu for choosing a category. It should look like a text field and open a list of options below when tapped."
      }
    },
    {
      "id": "date_picker",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/date_picker/",
      "nameEn": "Date Picker",
      "nameJa": "日付ピッカー（カレンダー選択）",
      "aliases": [
        "Calendar Picker",
        "Date Dialog",
        "Date Input"
      ],
      "platformNames": {
        "material3": "Date pickers（Docked / Modal / Modal input）",
        "material2": "Date pickers",
        "compose": "DatePicker / DatePickerDialog",
        "hig": "Pickers（Date picker）",
        "swiftUi": "DatePicker",
        "web": "<input type=\"date\">",
        "flutter": "showDatePicker / CupertinoDatePicker"
      },
      "summary": "カレンダーから日付を選ぶダイアログ。iOS ではドラム式もある。",
      "description": "showDatePicker で開く月カレンダー式のダイアログ。iOS ではドラム（wheel）で回して選ぶ CupertinoDatePicker がある。",
      "whenToUse": "予定・締切・誕生日の入力。過去／未来の制限は firstDate / lastDate で。",
      "tags": [
        "input",
        "date",
        "calendar",
        "日付",
        "カレンダー"
      ],
      "related": [
        "time_picker",
        "cupertino_picker",
        "alert_dialog"
      ],
      "needsDevice": false,
      "flutterApi": "showDatePicker / CupertinoDatePicker",
      "prompt": {
        "ja": "「締切日」欄をタップすると Material の Date Picker（カレンダー）が開き、選んだ日付が欄に入るようにして。今日より前は選べないように。",
        "en": "When the \"Due date\" field is tapped, open a Material Date Picker (calendar). Fill the field with the chosen date and disallow dates before today."
      }
    },
    {
      "id": "time_picker",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/time_picker/",
      "nameEn": "Time Picker",
      "nameJa": "時刻ピッカー",
      "aliases": [
        "Clock Picker",
        "Time Dialog"
      ],
      "platformNames": {
        "material3": "Time pickers（Dial / Input）",
        "material2": "Time pickers",
        "compose": "TimePicker / TimeInput",
        "hig": "Pickers（Time picker）",
        "swiftUi": "DatePicker(displayedComponents: .hourAndMinute)",
        "web": "<input type=\"time\">",
        "flutter": "showTimePicker / CupertinoDatePicker(mode: .time)"
      },
      "summary": "時計の文字盤や数値入力で時刻を選ぶダイアログ。",
      "description": "Material は文字盤（dial）をなぞって選ぶ方式。iOS は時・分のドラムを回す方式。",
      "whenToUse": "アラーム・リマインダー・予約時刻。",
      "tags": [
        "input",
        "time",
        "clock",
        "時刻",
        "アラーム"
      ],
      "related": [
        "date_picker",
        "cupertino_picker"
      ],
      "needsDevice": false,
      "flutterApi": "showTimePicker / CupertinoDatePicker(mode: .time)",
      "prompt": {
        "ja": "リマインダーの時刻を選ぶ Time Picker を作って。iOS では時・分のドラムを回す CupertinoDatePicker を Bottom Sheet で出して。",
        "en": "Create a Time Picker for a reminder. On iOS, present a CupertinoDatePicker in time mode inside a bottom sheet with hour/minute wheels."
      }
    },
    {
      "id": "cupertino_picker",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/cupertino_picker/",
      "nameEn": "Wheel Picker",
      "nameJa": "ドラム式ピッカー（ホイールピッカー）",
      "aliases": [
        "Cupertino Picker",
        "Drum Roll Picker",
        "Spinner Picker",
        "Scroll Wheel"
      ],
      "platformNames": {
        "material3": "該当なし（iOS 固有）",
        "material2": "該当なし（iOS 固有）",
        "compose": "該当なし（自作の wheel）",
        "hig": "Pickers（wheel）",
        "swiftUi": "Picker + .pickerStyle(.wheel)",
        "web": "該当なし（iOS 固有）",
        "flutter": "CupertinoPicker"
      },
      "summary": "iOS でおなじみの、ドラムを回して選ぶピッカー。",
      "description": "縦に並んだ候補が円筒状に回転し、中央の行が選択される。行が切り替わるたびに「カチッ」という触覚（selection click）が鳴るのが iOS 流。",
      "whenToUse": "候補が 10〜100 程度で、iOS らしい操作感にしたいとき（都道府県、回数、年齢）。",
      "tags": [
        "input",
        "picker",
        "wheel",
        "drum",
        "ドラム",
        "iOS"
      ],
      "related": [
        "dropdown_menu",
        "date_picker",
        "haptic_selection"
      ],
      "needsDevice": true,
      "flutterApi": "CupertinoPicker",
      "prompt": {
        "ja": "iOS 風のドラム式ピッカー（CupertinoPicker）で 1〜60 分を選べるようにして。行が変わるたびに軽いカチッという触覚を鳴らして。",
        "en": "Let the user choose 1–60 minutes with an iOS-style wheel picker (CupertinoPicker). Play a light selection-click haptic each time the highlighted row changes."
      }
    },
    {
      "id": "stepper_input",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/stepper_input/",
      "nameEn": "Quantity Stepper",
      "nameJa": "数量ステッパー（＋−ボタン）",
      "aliases": [
        "Stepper",
        "Number Stepper",
        "Plus-Minus Input",
        "Counter Input"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "該当なし（IconButton ×2 + Text で自作）",
        "hig": "Steppers",
        "swiftUi": "Stepper",
        "web": "<input type=\"number\">（Spinbutton）",
        "flutter": "自作（IconButton ×2 + Text）"
      },
      "summary": "「−」「＋」ボタンで数値を1つずつ増減する入力。",
      "description": "左右のボタンで値を増減させる。EC の数量選択・タイマーの分数などで定番。長押しで連続増減させる実装もある。",
      "whenToUse": "小さな整数（1〜10 程度）の選択。範囲が広いなら Slider や数値入力。",
      "tags": [
        "input",
        "stepper",
        "quantity",
        "数量",
        "カウンター",
        "プラスマイナス"
      ],
      "related": [
        "slider",
        "animated_counter",
        "haptic_selection"
      ],
      "needsDevice": false,
      "flutterApi": "自作（IconButton ×2 + Text）",
      "prompt": {
        "ja": "商品数量を選ぶ Quantity Stepper（− 数字 ＋）を作って。1未満にならず、上限は在庫数。値が変わるたびに軽い触覚を鳴らして。",
        "en": "Create a Quantity Stepper (− number +) for a product. Never go below 1; cap at stock count; play a light haptic on each change."
      }
    },
    {
      "id": "otp_field",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/otp_field/",
      "nameEn": "OTP / PIN Code Field",
      "nameJa": "認証コード入力（マス目入力）",
      "aliases": [
        "One-Time Code Input",
        "Verification Code Field",
        "PIN Input",
        "Pinput"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "該当なし（BasicTextField + 分割描画で自作）",
        "hig": "Digit entry views",
        "swiftUi": "該当なし（TextField + .textContentType(.oneTimeCode)）",
        "web": "<input inputmode=\"numeric\" autocomplete=\"one-time-code\">",
        "flutter": "自作（TextField + Row of boxes）/ pinput"
      },
      "summary": "6桁の数字を1桁ずつマス目に入れる認証コード欄。",
      "description": "SMS 認証などで使う、桁ごとに区切られた入力欄。実体は1つの隠し TextField で、見た目だけマス目に分ける実装が多い。",
      "whenToUse": "SMS / メール認証コード、アプリロックの PIN。",
      "tags": [
        "input",
        "otp",
        "pin",
        "code",
        "認証コード",
        "SMS"
      ],
      "related": [
        "text_field_outlined",
        "shake",
        "haptic_notification"
      ],
      "needsDevice": false,
      "flutterApi": "自作（TextField + Row of boxes）/ pinput",
      "prompt": {
        "ja": "SMS 認証用の 6 桁 OTP 入力欄を作って。1桁ずつマス目に表示され、入力中のマスが強調され、6桁揃ったら自動で送信して。間違っていたらマス全体が左右に揺れて赤くなるように。",
        "en": "Create a 6-digit OTP field for SMS verification: each digit in its own box, the active box highlighted, auto-submit when all 6 are entered. On a wrong code, shake the row and turn the boxes red."
      }
    },
    {
      "id": "autocomplete",
      "kind": "component",
      "category": "inputs",
      "url": "https://uizukan.dev/entry/autocomplete/",
      "nameEn": "Autocomplete",
      "nameJa": "オートコンプリート（入力候補）",
      "aliases": [
        "Typeahead",
        "Suggest Input",
        "Combobox with Suggestions"
      ],
      "platformNames": {
        "material3": "該当なし（Search の suggestions で表現）",
        "material2": "該当なし（Exposed dropdown menu で近似）",
        "compose": "該当なし（TextField + DropdownMenu で自作）",
        "hig": "該当なし（Search fields の suggestions）",
        "swiftUi": ".searchable + .searchSuggestions",
        "web": "<input list> + <datalist> / Combobox（WAI-ARIA パターン）",
        "flutter": "Autocomplete / RawAutocomplete"
      },
      "summary": "入力中の文字に合わせて候補が下に出る入力欄。",
      "description": "入力文字列で候補を絞り込み、リストから選べる。検索の補助、住所・タグ入力で使う。Debounce（入力停止後に検索）と組み合わせることが多い。",
      "whenToUse": "候補が多く、自由入力も許したい場面（タグ、駅名、ユーザー名）。",
      "tags": [
        "input",
        "autocomplete",
        "typeahead",
        "候補",
        "サジェスト"
      ],
      "related": [
        "search_bar",
        "dropdown_menu",
        "chips"
      ],
      "needsDevice": false,
      "flutterApi": "Autocomplete / RawAutocomplete",
      "prompt": {
        "ja": "駅名を入力すると候補が下に出る Autocomplete 入力欄を作って。候補は入力の前方一致で絞り込み、タップで確定して。",
        "en": "Create an Autocomplete field for station names: suggestions appear below as the user types, filtered by prefix match, and tapping one fills the field."
      }
    },
    {
      "id": "app_bar",
      "kind": "component",
      "category": "navigation",
      "url": "https://uizukan.dev/entry/app_bar/",
      "nameEn": "Top App Bar",
      "nameJa": "アプリバー（画面上部のバー）",
      "aliases": [
        "App Bar",
        "Navigation Bar (iOS)",
        "Header Bar",
        "Toolbar",
        "Title Bar"
      ],
      "platformNames": {
        "material3": "Top app bar（Small / Center-aligned / Medium / Large）",
        "material2": "Top app bar（Regular / Contextual action bar）",
        "compose": "TopAppBar / CenterAlignedTopAppBar",
        "hig": "Navigation bars",
        "swiftUi": "NavigationStack + .navigationTitle / .toolbar",
        "web": "<header> + <nav>",
        "flutter": "AppBar / SliverAppBar / CupertinoNavigationBar"
      },
      "summary": "画面上部の、タイトル・戻る・アクションが並ぶバー。",
      "description": "画面上端に固定され、左に戻るボタン（またはメニュー）、中央〜左にタイトル、右にアクション（検索・共有など）を持つ。Material 3 では高さ 64dp が標準。スクロールで色が変わる（surfaceTint）。",
      "whenToUse": "ほぼ全ての画面。モーダル画面では左を「閉じる（×）」にする。",
      "tags": [
        "navigation",
        "app bar",
        "header",
        "toolbar",
        "タイトル",
        "上部"
      ],
      "related": [
        "large_title_app_bar",
        "icon_button",
        "collapsing_toolbar",
        "tab_bar"
      ],
      "needsDevice": false,
      "flutterApi": "AppBar / SliverAppBar / CupertinoNavigationBar",
      "prompt": {
        "ja": "左に戻る矢印、中央にタイトル、右に検索とその他（⋮）のアイコンがある Top App Bar を作って。",
        "en": "Create a Top App Bar with a back arrow on the left, a title in the center, and search + overflow (⋮) icons on the right."
      }
    },
    {
      "id": "large_title_app_bar",
      "kind": "component",
      "category": "navigation",
      "url": "https://uizukan.dev/entry/large_title_app_bar/",
      "nameEn": "Large Title App Bar",
      "nameJa": "大見出しアプリバー（ラージタイトル）",
      "aliases": [
        "Large Title",
        "Medium/Large Top App Bar",
        "Collapsing Title"
      ],
      "platformNames": {
        "material3": "Top app bar（Large）",
        "material2": "Top app bar（Prominent）",
        "compose": "LargeTopAppBar / MediumTopAppBar",
        "hig": "Navigation bars（Large title）",
        "swiftUi": ".navigationBarTitleDisplayMode(.large)",
        "web": "該当なし（一般名なし）",
        "flutter": "SliverAppBar.large / CupertinoSliverNavigationBar"
      },
      "summary": "大きなタイトルが、スクロールすると小さくなって上部に収まるバー。",
      "description": "iOS の「設定」アプリのように、先頭では大きな見出しを表示し、スクロールすると通常サイズのタイトルに縮む。CustomScrollView + Sliver で作る。",
      "whenToUse": "タブのルート画面（ホーム・設定・ライブラリ）。詳細画面では通常の App Bar。",
      "tags": [
        "navigation",
        "large title",
        "sliver",
        "ラージタイトル",
        "iOS",
        "縮む"
      ],
      "related": [
        "app_bar",
        "collapsing_toolbar",
        "sticky_header"
      ],
      "needsDevice": false,
      "flutterApi": "SliverAppBar.large / CupertinoSliverNavigationBar",
      "prompt": {
        "ja": "iOS の設定アプリのような Large Title のアプリバーを作って。最初は大きな見出し、スクロールすると小さいタイトルに縮んで固定されるように。",
        "en": "Create a Large Title app bar like the iOS Settings app: big heading at the top that shrinks into a compact title and pins as you scroll."
      }
    },
    {
      "id": "bottom_navigation_bar",
      "kind": "component",
      "category": "navigation",
      "url": "https://uizukan.dev/entry/bottom_navigation_bar/",
      "nameEn": "Bottom Navigation Bar",
      "nameJa": "ボトムナビゲーション（下タブ）",
      "aliases": [
        "Navigation Bar (M3)",
        "Tab Bar (iOS)",
        "Bottom Tabs",
        "Bottom Nav"
      ],
      "platformNames": {
        "material3": "Navigation bar",
        "material2": "Bottom navigation",
        "compose": "NavigationBar + NavigationBarItem",
        "hig": "Tab bars",
        "swiftUi": "TabView",
        "web": "<nav>（Bottom navigation）",
        "flutter": "NavigationBar / BottomNavigationBar / CupertinoTabBar"
      },
      "summary": "画面下部に 3〜5 個並ぶ、アプリの主要セクションを切り替えるタブ。",
      "description": "画面最下部に固定され、アイコン＋ラベルで主要セクションを切り替える。Material 3 では選択中のアイコンに pill 型のインジケータが付く。iOS では Tab Bar と呼ぶ。",
      "whenToUse": "対等な 3〜5 個のトップレベル画面（ホーム／検索／通知／マイページ）。",
      "tags": [
        "navigation",
        "bottom",
        "tab",
        "タブ",
        "下部",
        "ナビゲーション"
      ],
      "related": [
        "navigation_rail",
        "tab_bar",
        "badge",
        "scroll_to_hide_bar"
      ],
      "needsDevice": false,
      "flutterApi": "NavigationBar / BottomNavigationBar / CupertinoTabBar",
      "prompt": {
        "ja": "ホーム／検索／通知／マイページの 4 タブの Bottom Navigation Bar を作って。Material 3 の NavigationBar で、通知タブに未読数のバッジを出して。",
        "en": "Create a 4-tab Bottom Navigation Bar (Home / Search / Notifications / Profile) using Material 3 NavigationBar, with an unread-count badge on the Notifications tab."
      }
    },
    {
      "id": "navigation_rail",
      "kind": "component",
      "category": "navigation",
      "url": "https://uizukan.dev/entry/navigation_rail/",
      "nameEn": "Navigation Rail",
      "nameJa": "ナビゲーションレール（縦タブ）",
      "aliases": [
        "Side Rail",
        "Vertical Tab Bar",
        "Sidebar (compact)"
      ],
      "platformNames": {
        "material3": "Navigation rail",
        "material2": "Navigation rail",
        "compose": "NavigationRail + NavigationRailItem",
        "hig": "Sidebars（近い）",
        "swiftUi": "NavigationSplitView（sidebar）",
        "web": "該当なし（Vertical navigation）",
        "flutter": "NavigationRail"
      },
      "summary": "タブレットや Web で、画面左に縦に並ぶタブ。",
      "description": "横幅が広い画面向けに、Bottom Navigation の代わりとして左端に縦に並べるタブ。幅 80dp 程度。",
      "whenToUse": "幅 600dp 以上（タブレット・PC・Web）。幅で Bottom Navigation と切り替える。",
      "tags": [
        "navigation",
        "rail",
        "tablet",
        "web",
        "レスポンシブ",
        "縦"
      ],
      "related": [
        "bottom_navigation_bar",
        "navigation_drawer"
      ],
      "needsDevice": false,
      "flutterApi": "NavigationRail",
      "prompt": {
        "ja": "画面幅が 600dp 以上なら左に Navigation Rail、未満なら下に Navigation Bar を出すレスポンシブなナビゲーションにして。",
        "en": "Make navigation responsive: show a Navigation Rail on the left when width ≥ 600dp, otherwise a bottom Navigation Bar."
      }
    },
    {
      "id": "navigation_drawer",
      "kind": "component",
      "category": "navigation",
      "url": "https://uizukan.dev/entry/navigation_drawer/",
      "nameEn": "Navigation Drawer",
      "nameJa": "ナビゲーションドロワー（ハンバーガーメニュー）",
      "aliases": [
        "Side Drawer",
        "Hamburger Menu",
        "Side Menu",
        "Sidebar"
      ],
      "platformNames": {
        "material3": "Navigation drawer（Standard / Modal）",
        "material2": "Navigation drawer",
        "compose": "ModalNavigationDrawer / PermanentNavigationDrawer / DismissibleNavigationDrawer",
        "hig": "Sidebars",
        "swiftUi": "NavigationSplitView",
        "web": "該当なし（Drawer / Off-canvas menu。<nav> + role=\"dialog\"）",
        "flutter": "NavigationDrawer / Drawer"
      },
      "summary": "左端から横にスライドして出てくるメニューパネル。",
      "description": "≡（ハンバーガー）アイコンや左端スワイプで開く、画面の左からスライドインするメニュー。項目が多いアプリで使う。",
      "whenToUse": "トップレベルの項目が 6 個以上あるとき。5 個以下なら Bottom Navigation の方が発見されやすい。",
      "tags": [
        "navigation",
        "drawer",
        "hamburger",
        "sidebar",
        "メニュー",
        "横から"
      ],
      "related": [
        "bottom_navigation_bar",
        "navigation_rail",
        "list_tile"
      ],
      "needsDevice": false,
      "flutterApi": "NavigationDrawer / Drawer",
      "prompt": {
        "ja": "App Bar 左の ≡ で開く Navigation Drawer を作って。上にユーザー情報、下にメニュー項目（アイコン付き）を並べて。",
        "en": "Create a Navigation Drawer opened by the ≡ icon in the App Bar, with user info at the top and icon menu items below."
      }
    },
    {
      "id": "tab_bar",
      "kind": "component",
      "category": "navigation",
      "url": "https://uizukan.dev/entry/tab_bar/",
      "nameEn": "Tabs",
      "nameJa": "タブ（上部タブ）",
      "aliases": [
        "Tab Bar",
        "Top Tabs",
        "Scrollable Tabs",
        "Tab Layout"
      ],
      "platformNames": {
        "material3": "Tabs（Primary / Secondary）",
        "material2": "Tabs（Fixed / Scrollable）",
        "compose": "PrimaryTabRow / SecondaryTabRow / ScrollableTabRow + Tab",
        "hig": "該当なし（Segmented control で代替。iOS の Tab bar は画面下の別物）",
        "swiftUi": "該当なし（Picker(.segmented) か TabView(.page)）",
        "web": "Tabs（WAI-ARIA パターン。role=\"tablist\"）",
        "flutter": "TabBar + TabBarView + DefaultTabController"
      },
      "summary": "App Bar の下に並び、横スワイプでも切り替えられるタブ。",
      "description": "選択中のタブに下線インジケータが付き、内容を横スワイプで切り替えられる。タブが多いときは横スクロール（isScrollable）。",
      "whenToUse": "同じ画面内で内容のカテゴリを切り替える（プロフィールの「投稿／いいね」など）。アプリ全体の切替は Bottom Navigation。",
      "tags": [
        "navigation",
        "tabs",
        "tab bar",
        "タブ",
        "スワイプ"
      ],
      "related": [
        "segmented_button",
        "bottom_navigation_bar",
        "page_view_swipe"
      ],
      "needsDevice": false,
      "flutterApi": "TabBar + TabBarView + DefaultTabController",
      "prompt": {
        "ja": "App Bar の下に「投稿／いいね／保存済み」の Tabs を作って。下線インジケータ付きで、内容は横スワイプでも切り替えられるように。",
        "en": "Add \"Posts / Likes / Saved\" Tabs under the App Bar with an underline indicator; content should also switch by horizontal swipe."
      }
    },
    {
      "id": "bottom_app_bar",
      "kind": "component",
      "category": "navigation",
      "url": "https://uizukan.dev/entry/bottom_app_bar/",
      "nameEn": "Bottom App Bar",
      "nameJa": "ボトムアプリバー（下部ツールバー）",
      "aliases": [
        "Bottom Toolbar",
        "Toolbar (iOS)",
        "Action Bar"
      ],
      "platformNames": {
        "material3": "Bottom app bar",
        "material2": "Bottom app bar",
        "compose": "BottomAppBar",
        "hig": "Toolbars（bottom）",
        "swiftUi": ".toolbar { ToolbarItemGroup(placement: .bottomBar) }",
        "web": "Toolbar（WAI-ARIA パターン）/ <footer>",
        "flutter": "BottomAppBar"
      },
      "summary": "画面下部に操作アイコンを並べるバー。FAB を埋め込むこともある。",
      "description": "タブではなく「この画面での操作」（削除・共有・返信など）を下部にまとめるバー。Material では FAB を右端に埋め込める。",
      "whenToUse": "メール詳細・写真閲覧など、画面固有のアクションが複数あるとき。",
      "tags": [
        "navigation",
        "bottom",
        "toolbar",
        "ツールバー",
        "下部"
      ],
      "related": [
        "fab",
        "bottom_navigation_bar",
        "bottom_action_bar"
      ],
      "needsDevice": false,
      "flutterApi": "BottomAppBar",
      "prompt": {
        "ja": "メール詳細画面の下部に、アーカイブ／削除／返信のアイコンと右端に FAB を持つ Bottom App Bar を作って。",
        "en": "Add a Bottom App Bar to the email detail screen with archive / delete / reply icons and a FAB at the right end."
      }
    },
    {
      "id": "breadcrumb",
      "kind": "component",
      "category": "navigation",
      "url": "https://uizukan.dev/entry/breadcrumb/",
      "nameEn": "Breadcrumb",
      "nameJa": "パンくずリスト",
      "aliases": [
        "Breadcrumbs",
        "Path Navigation"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "該当なし（Row + TextButton で自作）",
        "hig": "Path controls（macOS のみ）",
        "swiftUi": "該当なし（HStack + Button で自作）",
        "web": "Breadcrumb（WAI-ARIA パターン。<nav aria-label=\"breadcrumb\">）",
        "flutter": "自作（Row + TextButton + Icon(chevron_right)）"
      },
      "summary": "「ホーム › カテゴリ › 商品」のように現在地までの階層を示す。",
      "description": "階層構造の現在位置を「›」区切りで示し、各階層へ戻れるリンク列。主に Web・デスクトップ向け。",
      "whenToUse": "Web 版の階層が深い画面。モバイルでは戻るボタンで十分なことが多い。",
      "tags": [
        "navigation",
        "breadcrumb",
        "web",
        "パンくず",
        "階層"
      ],
      "related": [
        "app_bar",
        "text_button"
      ],
      "needsDevice": false,
      "flutterApi": "自作（Row + TextButton + Icon(chevron_right)）",
      "prompt": {
        "ja": "Web 版の商品ページ上部に「ホーム › メンズ › シューズ › 商品名」の Breadcrumb を作って。最後以外はリンクにして。",
        "en": "Add a Breadcrumb \"Home › Men › Shoes › Product\" at the top of the web product page; all but the last are links."
      }
    },
    {
      "id": "page_indicator",
      "kind": "component",
      "category": "navigation",
      "url": "https://uizukan.dev/entry/page_indicator/",
      "nameEn": "Page Indicator",
      "nameJa": "ページインジケータ（ドット）",
      "aliases": [
        "Dots Indicator",
        "Page Control",
        "Carousel Dots"
      ],
      "platformNames": {
        "material3": "該当なし（Carousel の indicator として言及のみ）",
        "material2": "該当なし（M2 に無い）",
        "compose": "該当なし（HorizontalPager + 自作の点）",
        "hig": "Page controls",
        "swiftUi": "TabView(.page) の indicator / .indexViewStyle(.page)",
        "web": "該当なし（Pagination dots）",
        "flutter": "自作（Row of AnimatedContainer）/ smooth_page_indicator"
      },
      "summary": "オンボーディングやカルーセルで、現在何ページ目かを示す点の列。",
      "description": "小さな点を横に並べ、現在ページの点だけ色や幅を変える。PageView の controller と連動させる。",
      "whenToUse": "オンボーディング、画像カルーセル。ページ数が 10 を超えるなら数値表示。",
      "tags": [
        "navigation",
        "indicator",
        "dots",
        "ドット",
        "ページ",
        "カルーセル"
      ],
      "related": [
        "carousel",
        "page_view_swipe",
        "snap_scrolling"
      ],
      "needsDevice": false,
      "flutterApi": "自作（Row of AnimatedContainer）/ smooth_page_indicator",
      "prompt": {
        "ja": "オンボーディング 3 ページの下に Page Indicator（ドット）を置いて。現在ページのドットは横に伸びて primary 色になるアニメーション付きで。",
        "en": "Add a Page Indicator (dots) under the 3-page onboarding. The active dot stretches horizontally and turns primary, animated."
      }
    },
    {
      "id": "card",
      "kind": "component",
      "category": "surfaces",
      "url": "https://uizukan.dev/entry/card/",
      "nameEn": "Card",
      "nameJa": "カード",
      "aliases": [
        "Elevated Card",
        "Filled Card",
        "Outlined Card",
        "Tile"
      ],
      "platformNames": {
        "material3": "Cards（Elevated / Filled / Outlined）",
        "material2": "Card（Elevated / Outlined）",
        "compose": "Card / ElevatedCard / OutlinedCard",
        "hig": "該当なし（Lockups や grouped list で表現）",
        "swiftUi": "GroupBox（近い）/ 自作",
        "web": "該当なし（Card。<article>）",
        "flutter": "Card / Card.filled / Card.outlined"
      },
      "summary": "関連する情報をひとまとまりにした角丸の面。影付き・塗り・枠線の 3 種。",
      "description": "画像・見出し・本文・アクションを角丸 12dp の面にまとめる。Material 3 では Elevated（影）／Filled（塗り）／Outlined（枠線）の 3 種類。",
      "whenToUse": "フィードの投稿、商品、記事など「タップで詳細へ行く独立した塊」。単なる区切りには不要。",
      "tags": [
        "surface",
        "card",
        "カード",
        "角丸",
        "影"
      ],
      "related": [
        "list_tile",
        "elevated_button",
        "hero_transition"
      ],
      "needsDevice": false,
      "flutterApi": "Card / Card.filled / Card.outlined",
      "prompt": {
        "ja": "上に画像、下に見出しと 2 行の説明、右下にテキストボタンがある Material 3 の Elevated Card を作って。タップで詳細に遷移するように。",
        "en": "Create a Material 3 Elevated Card with an image on top, a headline and 2-line description below, and a text button at the bottom-right. Tapping the card navigates to the detail screen."
      }
    },
    {
      "id": "list_tile",
      "kind": "component",
      "category": "surfaces",
      "url": "https://uizukan.dev/entry/list_tile/",
      "nameEn": "List Item",
      "nameJa": "リスト項目（セル）",
      "aliases": [
        "List Tile",
        "Cell",
        "Row",
        "Table View Cell",
        "Settings Row"
      ],
      "platformNames": {
        "material3": "Lists（List item：One-line / Two-line / Three-line）",
        "material2": "Lists（List item）",
        "compose": "ListItem",
        "hig": "Lists and tables（Row）",
        "swiftUi": "List + row（Label / LabeledContent）",
        "web": "<li> / Listbox（WAI-ARIA パターン）",
        "flutter": "ListTile / CupertinoListTile"
      },
      "summary": "左にアイコン、中央にタイトルと補足、右に矢印やスイッチ、の 1 行。",
      "description": "leading（アイコン・アバター）／title／subtitle／trailing（›・スイッチ・値）で構成される横一列。設定画面はこれの積み重ね。",
      "whenToUse": "設定・メニュー・連絡先など、縦に並ぶ同型の項目。",
      "tags": [
        "surface",
        "list",
        "tile",
        "cell",
        "リスト",
        "行",
        "設定"
      ],
      "related": [
        "switch_toggle",
        "expansion_tile",
        "divider",
        "swipe_actions"
      ],
      "needsDevice": false,
      "flutterApi": "ListTile / CupertinoListTile",
      "prompt": {
        "ja": "設定画面の行を ListTile で作って。左にアイコン、タイトルとサブタイトル、右に「›」の矢印。タップで詳細画面へ。",
        "en": "Create settings rows with ListTile: leading icon, title and subtitle, trailing \"›\" chevron. Tapping opens the detail screen."
      }
    },
    {
      "id": "expansion_tile",
      "kind": "component",
      "category": "surfaces",
      "url": "https://uizukan.dev/entry/expansion_tile/",
      "nameEn": "Accordion",
      "nameJa": "アコーディオン（展開パネル）",
      "aliases": [
        "Expansion Tile",
        "Expansion Panel",
        "Disclosure",
        "Collapsible"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（Material 1 の Expansion panels。M2 では外れた）",
        "compose": "該当なし（AnimatedVisibility で自作）",
        "hig": "Disclosure controls",
        "swiftUi": "DisclosureGroup",
        "web": "<details> + <summary> / Accordion（WAI-ARIA パターン）",
        "flutter": "ExpansionTile / ExpansionPanelList"
      },
      "summary": "タップすると下に内容が伸びて開き、もう一度で閉じる行。",
      "description": "見出し行の右に「⌄」があり、タップで内容が展開する。FAQ・詳細設定・注文明細の内訳で定番。",
      "whenToUse": "FAQ、長い説明の折りたたみ、階層のある設定。",
      "tags": [
        "surface",
        "accordion",
        "expand",
        "collapse",
        "FAQ",
        "折りたたみ",
        "展開"
      ],
      "related": [
        "list_tile",
        "expand_collapse",
        "card"
      ],
      "needsDevice": false,
      "flutterApi": "ExpansionTile / ExpansionPanelList",
      "prompt": {
        "ja": "FAQ を Accordion（ExpansionTile）で作って。質問をタップすると回答が下にアニメーションで展開し、右の矢印が回転するように。",
        "en": "Build the FAQ as an Accordion (ExpansionTile): tapping a question animates the answer open below and rotates the chevron."
      }
    },
    {
      "id": "modal_bottom_sheet",
      "kind": "component",
      "category": "surfaces",
      "url": "https://uizukan.dev/entry/modal_bottom_sheet/",
      "nameEn": "Bottom Sheet",
      "nameJa": "ボトムシート（ハーフモーダル）",
      "aliases": [
        "Modal Bottom Sheet",
        "Half Modal",
        "Sheet",
        "Drawer (bottom)",
        "Half Sheet"
      ],
      "platformNames": {
        "material3": "Bottom sheets（Standard / Modal）",
        "material2": "Sheets: bottom（Standard / Modal）",
        "compose": "ModalBottomSheet / BottomSheetScaffold",
        "hig": "Sheets",
        "swiftUi": ".sheet + .presentationDetents([.medium, .large])",
        "web": "<dialog>（Bottom sheet）",
        "flutter": "showModalBottomSheet / DraggableScrollableSheet"
      },
      "summary": "画面下からせり上がる面。ドラッグで高さ調整や閉じることができる。",
      "description": "画面下部から表示されるパネル。上端に「取っ手（drag handle）」が付き、下にドラッグして閉じる。Material の Modal Bottom Sheet、iOS の half sheet（detents）が該当。",
      "whenToUse": "共有メニュー、フィルタ設定、簡単な入力など「今の画面を離れずに済ませたい」操作。",
      "tags": [
        "surface",
        "sheet",
        "modal",
        "bottom",
        "ボトムシート",
        "ハーフモーダル",
        "下から",
        "下から出るやつ",
        "下から出る"
      ],
      "related": [
        "action_sheet",
        "alert_dialog",
        "drag_to_dismiss_sheet",
        "slide_up_modal"
      ],
      "needsDevice": false,
      "flutterApi": "showModalBottomSheet / DraggableScrollableSheet",
      "prompt": {
        "ja": "フィルタボタンを押すと、下から Modal Bottom Sheet がせり上がって出るようにして。上に取っ手を付け、下にドラッグで閉じられるように。",
        "en": "When the filter button is pressed, slide up a Modal Bottom Sheet from the bottom with a drag handle; dragging down dismisses it."
      }
    },
    {
      "id": "alert_dialog",
      "kind": "component",
      "category": "surfaces",
      "url": "https://uizukan.dev/entry/alert_dialog/",
      "nameEn": "Alert Dialog",
      "nameJa": "アラートダイアログ（確認ダイアログ）",
      "aliases": [
        "Dialog",
        "Alert",
        "Confirmation Dialog",
        "Modal Dialog",
        "Popup"
      ],
      "platformNames": {
        "material3": "Dialogs（Basic dialog）",
        "material2": "Dialogs（Alert / Simple / Confirmation）",
        "compose": "AlertDialog",
        "hig": "Alerts",
        "swiftUi": ".alert()",
        "web": "<dialog> / Alert and Message Dialogs（WAI-ARIA パターン）",
        "flutter": "AlertDialog / CupertinoAlertDialog"
      },
      "summary": "画面中央に出て、判断を求める小さな窓。",
      "description": "背景を暗くして中央に表示し、タイトル・本文・1〜2 個のボタンで判断を求める。ユーザーの操作を止めるので多用しない。",
      "whenToUse": "取り消せない操作（削除・ログアウト）の確認、重要なエラー。軽い通知には Snackbar。",
      "tags": [
        "surface",
        "dialog",
        "alert",
        "confirm",
        "ダイアログ",
        "確認",
        "ポップアップ"
      ],
      "related": [
        "action_sheet",
        "modal_bottom_sheet",
        "snackbar",
        "full_screen_dialog"
      ],
      "needsDevice": false,
      "flutterApi": "AlertDialog / CupertinoAlertDialog",
      "prompt": {
        "ja": "削除ボタンを押したら「本当に削除しますか？」の Alert Dialog を出して。「キャンセル」と赤い「削除」の 2 ボタンで、iOS では iOS 風のアラートにして。",
        "en": "When delete is pressed, show an Alert Dialog \"Delete this item?\" with \"Cancel\" and a red \"Delete\" button. Use the iOS-style alert on iOS."
      }
    },
    {
      "id": "action_sheet",
      "kind": "component",
      "category": "surfaces",
      "url": "https://uizukan.dev/entry/action_sheet/",
      "nameEn": "Action Sheet",
      "nameJa": "アクションシート",
      "aliases": [
        "iOS Action Sheet",
        "Options Sheet",
        "Bottom Action Menu"
      ],
      "platformNames": {
        "material3": "該当なし（Bottom sheet の list で代替）",
        "material2": "該当なし（Modal bottom sheet で代替）",
        "compose": "該当なし（ModalBottomSheet で代替）",
        "hig": "Action sheets",
        "swiftUi": ".confirmationDialog()",
        "web": "該当なし（Action sheet。<dialog> で自作）",
        "flutter": "showCupertinoModalPopup + CupertinoActionSheet"
      },
      "summary": "iOS で下から出る、縦に並んだ選択肢のリスト。赤い破壊的操作とキャンセルが付く。",
      "description": "「写真を撮る／ライブラリから選ぶ／キャンセル」のように、少数の選択肢を下から提示する iOS 標準の部品。破壊的操作は赤字。",
      "whenToUse": "1 つの操作に対する 2〜5 個の選択肢（画像の取得元、共有先、削除確認）。",
      "tags": [
        "surface",
        "action sheet",
        "ios",
        "アクションシート",
        "選択肢",
        "下から"
      ],
      "related": [
        "modal_bottom_sheet",
        "alert_dialog",
        "popup_menu"
      ],
      "needsDevice": false,
      "flutterApi": "showCupertinoModalPopup + CupertinoActionSheet",
      "prompt": {
        "ja": "プロフィール画像をタップしたら「写真を撮る／ライブラリから選ぶ／削除（赤）／キャンセル」の iOS 風 Action Sheet を出して。",
        "en": "When the profile picture is tapped, present an iOS-style Action Sheet: \"Take Photo / Choose from Library / Delete (red) / Cancel\"."
      }
    },
    {
      "id": "popup_menu",
      "kind": "component",
      "category": "surfaces",
      "url": "https://uizukan.dev/entry/popup_menu/",
      "nameEn": "Menu (Popup / Overflow)",
      "nameJa": "ポップアップメニュー（⋮ メニュー）",
      "aliases": [
        "Overflow Menu",
        "Kebab Menu",
        "Dropdown Menu (action)",
        "Context Menu",
        "More Menu"
      ],
      "platformNames": {
        "material3": "Menus（Dropdown menu）",
        "material2": "Menus（Overflow / Popup menu）",
        "compose": "DropdownMenu + DropdownMenuItem",
        "hig": "Menus（Pull-down buttons）",
        "swiftUi": "Menu",
        "web": "Menu Button（WAI-ARIA パターン。<button aria-haspopup=\"menu\">）",
        "flutter": "PopupMenuButton / MenuAnchor"
      },
      "summary": "⋮ や ⋯ を押すと、その場に浮かぶ小さなメニュー。",
      "description": "ボタンのそばに浮かぶ選択肢の一覧。App Bar 右端の「⋮（ケバブ）」から出るものを Overflow Menu と呼ぶ。",
      "whenToUse": "画面に出しきれない補助操作（編集・複製・報告・削除）。",
      "tags": [
        "surface",
        "menu",
        "popup",
        "overflow",
        "kebab",
        "メニュー",
        "三点"
      ],
      "related": [
        "app_bar",
        "context_menu",
        "action_sheet",
        "dropdown_menu"
      ],
      "needsDevice": false,
      "flutterApi": "PopupMenuButton / MenuAnchor",
      "prompt": {
        "ja": "カード右上の ⋮ を押すと「編集／複製／削除（赤）」の Popup Menu が出るようにして。",
        "en": "Tapping the ⋮ at the top-right of the card should open a Popup Menu with \"Edit / Duplicate / Delete (red)\"."
      }
    },
    {
      "id": "tooltip",
      "kind": "component",
      "category": "surfaces",
      "url": "https://uizukan.dev/entry/tooltip/",
      "nameEn": "Tooltip",
      "nameJa": "ツールチップ",
      "aliases": [
        "Hint Bubble",
        "Hover Label",
        "Rich Tooltip"
      ],
      "platformNames": {
        "material3": "Tooltips（Plain / Rich）",
        "material2": "Tooltips",
        "compose": "TooltipBox + PlainTooltip / RichTooltip",
        "hig": "該当なし（iOS 標準には無い。macOS の help tag）",
        "swiftUi": ".help(_:)（macOS）",
        "web": "title 属性 / Tooltip（WAI-ARIA パターン）",
        "flutter": "Tooltip"
      },
      "summary": "アイコンに長押し・ホバーすると出る小さな説明ラベル。",
      "description": "アイコンボタンの意味を補足する黒い小さな吹き出し。モバイルでは長押し、Web ではホバーで表示。スクリーンリーダーにも読まれる。",
      "whenToUse": "アイコンのみのボタン全て（アクセシビリティ上も推奨）。",
      "tags": [
        "surface",
        "tooltip",
        "hover",
        "ツールチップ",
        "長押し",
        "説明"
      ],
      "related": [
        "icon_button",
        "long_press"
      ],
      "needsDevice": false,
      "flutterApi": "Tooltip",
      "prompt": {
        "ja": "App Bar のアイコンボタン全てに Tooltip を付けて。Web ではホバー、モバイルでは長押しで表示されるように。",
        "en": "Add a Tooltip to every icon button in the App Bar; show on hover on web and on long-press on mobile."
      }
    },
    {
      "id": "divider",
      "kind": "component",
      "category": "surfaces",
      "url": "https://uizukan.dev/entry/divider/",
      "nameEn": "Divider",
      "nameJa": "区切り線",
      "aliases": [
        "Separator",
        "Rule",
        "Inset Divider"
      ],
      "platformNames": {
        "material3": "Divider（Full width / Inset）",
        "material2": "Divider",
        "compose": "HorizontalDivider / VerticalDivider",
        "hig": "該当なし（List の separator）",
        "swiftUi": "Divider",
        "web": "<hr>",
        "flutter": "Divider / VerticalDivider / ListView.separated"
      },
      "summary": "リストやセクションを区切る細い線。左を空けた inset 型もある。",
      "description": "1dp の薄い線。iOS の設定では左端をアイコン分空ける inset separator が標準。",
      "whenToUse": "リスト項目の間、セクションの境目。カードの中では余白で区切る方が上品。",
      "tags": [
        "surface",
        "divider",
        "separator",
        "区切り",
        "線"
      ],
      "related": [
        "list_tile",
        "sticky_header"
      ],
      "needsDevice": false,
      "flutterApi": "Divider / VerticalDivider / ListView.separated",
      "prompt": {
        "ja": "設定リストの各行の間に、左端を 56dp 空けた inset Divider を入れて。",
        "en": "Insert inset Dividers (56dp left indent) between the settings rows."
      }
    },
    {
      "id": "full_screen_dialog",
      "kind": "component",
      "category": "surfaces",
      "url": "https://uizukan.dev/entry/full_screen_dialog/",
      "nameEn": "Full-screen Dialog",
      "nameJa": "全画面ダイアログ（モーダル画面）",
      "aliases": [
        "Modal Screen",
        "Full-screen Modal",
        "Sheet (large)",
        "Compose Screen"
      ],
      "platformNames": {
        "material3": "Dialogs（Full-screen dialog）",
        "material2": "Dialogs（Full-screen dialog）",
        "compose": "該当なし（Dialog(usePlatformDefaultWidth = false) で自作）",
        "hig": "Sheets（Full-screen modal）",
        "swiftUi": ".fullScreenCover()",
        "web": "<dialog>（全画面）",
        "flutter": "MaterialPageRoute(fullscreenDialog: true)"
      },
      "summary": "下からせり上がって画面全体を覆う、作成・編集用の画面。左上が × で右上が「保存」。",
      "description": "通常の push（右から）ではなく下から出てくる画面。App Bar の左が「×（閉じる）」、右が「保存／完了」になるのが作法。",
      "whenToUse": "新規作成・編集・複数項目の入力など「一連の作業を終えてから戻る」画面。",
      "tags": [
        "surface",
        "dialog",
        "modal",
        "full screen",
        "モーダル",
        "作成",
        "編集"
      ],
      "related": [
        "alert_dialog",
        "modal_bottom_sheet",
        "slide_up_modal",
        "app_bar"
      ],
      "needsDevice": false,
      "flutterApi": "MaterialPageRoute(fullscreenDialog: true)",
      "prompt": {
        "ja": "「新規投稿」を Full-screen Dialog として開いて。下からせり上がるアニメーションで、左上に ×、右上に「投稿」ボタンを置いて。",
        "en": "Open \"New post\" as a Full-screen Dialog: it slides up from the bottom, with an × at the top-left and a \"Post\" button at the top-right."
      }
    },
    {
      "id": "bottom_action_bar",
      "kind": "component",
      "category": "surfaces",
      "url": "https://uizukan.dev/entry/bottom_action_bar/",
      "nameEn": "Sticky Bottom Action Bar",
      "nameJa": "下部固定 CTA バー",
      "aliases": [
        "Sticky Footer",
        "Bottom CTA",
        "Persistent Footer",
        "Checkout Bar"
      ],
      "platformNames": {
        "material3": "Docked toolbar（M3 Expressive）",
        "material2": "該当なし（Bottom app bar で代替）",
        "compose": "該当なし（Scaffold(bottomBar:) で自作）",
        "hig": "Toolbars",
        "swiftUi": ".toolbar(placement: .bottomBar) / .safeAreaInset(edge: .bottom)",
        "web": "該当なし（Sticky footer / Action bar）",
        "flutter": "Scaffold.bottomNavigationBar / persistentFooterButtons"
      },
      "summary": "商品ページなどで、スクロールしても下に固定される「カートに入れる」バー。",
      "description": "本文はスクロールするが、価格と主要ボタンは画面下部に常に見えるバー。上に薄い影や線を付けて本文と区別する。",
      "whenToUse": "商品詳細、購入フロー、フォームの「次へ」など、主要操作を常に押せるようにしたい画面。",
      "tags": [
        "surface",
        "sticky",
        "footer",
        "cta",
        "下部固定",
        "購入"
      ],
      "related": [
        "filled_button",
        "bottom_app_bar",
        "stepper_input"
      ],
      "needsDevice": false,
      "flutterApi": "Scaffold.bottomNavigationBar / persistentFooterButtons",
      "prompt": {
        "ja": "商品ページの下部に、左に価格、右に「カートに入れる」の Filled Button を置いた Sticky Bottom Action Bar を固定して。SafeArea を考慮して。",
        "en": "Pin a Sticky Bottom Action Bar to the product page: price on the left, a Filled \"Add to cart\" button on the right, respecting SafeArea."
      }
    },
    {
      "id": "snackbar",
      "kind": "component",
      "category": "feedback",
      "url": "https://uizukan.dev/entry/snackbar/",
      "nameEn": "Snackbar",
      "nameJa": "スナックバー（トースト）",
      "aliases": [
        "Toast",
        "Bottom Notification",
        "Transient Message"
      ],
      "platformNames": {
        "material3": "Snackbar",
        "material2": "Snackbar",
        "compose": "Snackbar / SnackbarHost",
        "hig": "該当なし（iOS 標準には無い。自作の toast）",
        "swiftUi": "該当なし（overlay で自作）",
        "web": "該当なし（Toast / Snackbar。role=\"status\"）",
        "flutter": "ScaffoldMessenger.showSnackBar / SnackBar"
      },
      "summary": "画面下に数秒だけ出て自動で消える短いメッセージ。「元に戻す」を付けられる。",
      "description": "操作の結果（保存しました・削除しました）を画面下部に短時間表示する。Material の Snackbar は 1 つのアクション（元に戻す）を持てる。Toast は Android OS の簡易版で、アクションを持てない。",
      "whenToUse": "操作完了の軽い通知、取り消し可能な削除。判断が必要なら Dialog。",
      "tags": [
        "feedback",
        "snackbar",
        "toast",
        "通知",
        "元に戻す",
        "一時"
      ],
      "related": [
        "banner",
        "alert_dialog",
        "snackbar_undo"
      ],
      "needsDevice": false,
      "flutterApi": "ScaffoldMessenger.showSnackBar / SnackBar",
      "prompt": {
        "ja": "削除したら画面下に「削除しました」の Snackbar を 4 秒表示して。右に「元に戻す」アクションを付けて。フローティング（浮いた）スタイルで。",
        "en": "After deleting, show a floating Snackbar \"Deleted\" for 4 seconds at the bottom with an \"Undo\" action on the right."
      }
    },
    {
      "id": "banner",
      "kind": "component",
      "category": "feedback",
      "url": "https://uizukan.dev/entry/banner/",
      "nameEn": "Banner",
      "nameJa": "バナー（インライン通知）",
      "aliases": [
        "Material Banner",
        "Inline Alert",
        "Notice Bar",
        "Callout"
      ],
      "platformNames": {
        "material3": "該当なし（M3 の部品一覧から外れた。Snackbar / Dialog を推奨）",
        "material2": "Banner",
        "compose": "該当なし（自作）",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": "該当なし（自作）",
        "web": "該当なし（Alert bar。role=\"alert\"）",
        "flutter": "MaterialBanner"
      },
      "summary": "画面上部に留まり、ユーザーが閉じるまで消えない通知。",
      "description": "Snackbar と違い自動では消えず、対処を促す（オフライン・未認証・アップデート）。1〜2 個のアクションを持つ。",
      "whenToUse": "ネットワーク切断、メール未確認、課金の期限切れなど「対応が必要な継続状態」。",
      "tags": [
        "feedback",
        "banner",
        "notice",
        "alert",
        "オフライン",
        "警告"
      ],
      "related": [
        "snackbar",
        "alert_dialog",
        "empty_state"
      ],
      "needsDevice": false,
      "flutterApi": "MaterialBanner",
      "prompt": {
        "ja": "オフラインになったら画面上部に「インターネットに接続されていません」の Banner を出して。閉じるまで消えず、「再試行」ボタン付きで。",
        "en": "When offline, show a Banner at the top: \"No internet connection\", persistent until dismissed, with a \"Retry\" button."
      }
    },
    {
      "id": "circular_progress",
      "kind": "component",
      "category": "feedback",
      "url": "https://uizukan.dev/entry/circular_progress/",
      "nameEn": "Circular Progress Indicator",
      "nameJa": "円形プログレス（スピナー）",
      "aliases": [
        "Spinner",
        "Activity Indicator",
        "Loading Spinner",
        "Loader"
      ],
      "platformNames": {
        "material3": "Circular progress indicator",
        "material2": "Circular progress indicator",
        "compose": "CircularProgressIndicator",
        "hig": "Progress indicators（Activity indicator）",
        "swiftUi": "ProgressView（.circular）",
        "web": "該当なし（Spinner。role=\"progressbar\"）",
        "flutter": "CircularProgressIndicator / CupertinoActivityIndicator"
      },
      "summary": "くるくる回る読み込み中の表示。iOS では放射状のグレーが標準。",
      "description": "終わりが分からない処理は回り続ける indeterminate、進捗が分かるなら弧が伸びる determinate を使う。",
      "whenToUse": "1〜10 秒程度の待ち。それ以上はスケルトンや進捗バー＋説明。",
      "tags": [
        "feedback",
        "progress",
        "spinner",
        "loading",
        "ローディング",
        "読み込み",
        "くるくる",
        "ぐるぐる"
      ],
      "related": [
        "linear_progress",
        "skeleton",
        "loading_button"
      ],
      "needsDevice": false,
      "flutterApi": "CircularProgressIndicator / CupertinoActivityIndicator",
      "prompt": {
        "ja": "データ読み込み中は画面中央にスピナーを出して。iOS では CupertinoActivityIndicator、Android では CircularProgressIndicator になる adaptive にして。",
        "en": "While loading, show a spinner centered on screen. Use CircularProgressIndicator.adaptive so it is native on iOS and Android."
      }
    },
    {
      "id": "linear_progress",
      "kind": "component",
      "category": "feedback",
      "url": "https://uizukan.dev/entry/linear_progress/",
      "nameEn": "Linear Progress Indicator",
      "nameJa": "進捗バー（プログレスバー）",
      "aliases": [
        "Progress Bar",
        "Loading Bar",
        "Determinate Progress"
      ],
      "platformNames": {
        "material3": "Linear progress indicator",
        "material2": "Linear progress indicator",
        "compose": "LinearProgressIndicator",
        "hig": "Progress indicators（Progress bar）",
        "swiftUi": "ProgressView(value:)（.linear）",
        "web": "<progress>",
        "flutter": "LinearProgressIndicator"
      },
      "summary": "横に伸びるバーで進捗（％）を示す。",
      "description": "アップロード・ダウンロード・学習の達成率などを横棒で表す。値が分からなければ左右に流れる indeterminate。",
      "whenToUse": "進捗が数値で分かる処理、ステップ式フォームの進み具合。",
      "tags": [
        "feedback",
        "progress",
        "bar",
        "進捗",
        "アップロード",
        "達成率"
      ],
      "related": [
        "circular_progress",
        "stepper_progress",
        "animated_counter"
      ],
      "needsDevice": false,
      "flutterApi": "LinearProgressIndicator",
      "prompt": {
        "ja": "アップロードの進捗を Linear Progress Indicator で表示して。値が変わるとバーが滑らかに伸びるアニメーション付きで、右に「45%」を出して。",
        "en": "Show upload progress with a Linear Progress Indicator that animates smoothly when the value changes, with \"45%\" text on the right."
      }
    },
    {
      "id": "skeleton",
      "kind": "component",
      "category": "feedback",
      "url": "https://uizukan.dev/entry/skeleton/",
      "nameEn": "Skeleton Screen",
      "nameJa": "スケルトンスクリーン",
      "aliases": [
        "Skeleton Loader",
        "Shimmer Placeholder",
        "Content Placeholder",
        "Ghost Element"
      ],
      "platformNames": {
        "material3": "該当なし（Motion の Skeleton loaders として言及のみ）",
        "material2": "該当なし（M2 に無い）",
        "compose": "該当なし（Brush + Modifier.background で自作）",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": ".redacted(reason: .placeholder)",
        "web": "該当なし（Skeleton screen）",
        "flutter": "自作 / skeletonizer / shimmer パッケージ"
      },
      "summary": "読み込み中に、これから出る内容の形をグレーの箱で先に見せる。",
      "description": "テキストや画像の位置に灰色の四角を置く。止まった箱だけでもスケルトンだが、光が流れるシマー（Shimmer）と組み合わせることが多い。スピナーより「もうすぐ出る」感が強く、体感が速い。",
      "whenToUse": "フィード・一覧・詳細画面の初回読み込み。短時間（300ms 未満）なら不要。",
      "tags": [
        "feedback",
        "skeleton",
        "shimmer",
        "placeholder",
        "ローディング",
        "スケルトン"
      ],
      "related": [
        "shimmer",
        "circular_progress",
        "crossfade"
      ],
      "needsDevice": false,
      "flutterApi": "自作 / skeletonizer / shimmer パッケージ",
      "prompt": {
        "ja": "フィードの読み込み中は、カードと同じ形のグレーの Skeleton を 3 枚出して。左から右に光が流れる shimmer アニメーション付きで。",
        "en": "While the feed loads, show 3 gray Skeleton cards shaped like the real cards, with a left-to-right shimmer animation."
      }
    },
    {
      "id": "badge",
      "kind": "component",
      "category": "feedback",
      "url": "https://uizukan.dev/entry/badge/",
      "nameEn": "Badge",
      "nameJa": "バッジ（未読数・赤い点）",
      "aliases": [
        "Notification Badge",
        "Dot Badge",
        "Count Badge",
        "Red Dot"
      ],
      "platformNames": {
        "material3": "Badge",
        "material2": "Badge",
        "compose": "Badge / BadgedBox",
        "hig": "該当なし（Tab bar とアプリアイコンの badge として存在。独立部品名は無い）",
        "swiftUi": ".badge(_:)",
        "web": "該当なし（Badge。role=\"status\"）",
        "flutter": "Badge / Badge.count"
      },
      "summary": "アイコンの右上に付く赤い点や未読数。",
      "description": "アイコンやタブの右上に重ねる小さな円。数字なしの点（dot）と、数字入り（label）がある。99 を超えたら「99+」。",
      "whenToUse": "未読・新着・カート内の点数など、注意を引きたい件数。",
      "tags": [
        "feedback",
        "badge",
        "dot",
        "未読",
        "赤い点",
        "件数"
      ],
      "related": [
        "bottom_navigation_bar",
        "icon_button",
        "avatar"
      ],
      "needsDevice": false,
      "flutterApi": "Badge / Badge.count",
      "prompt": {
        "ja": "カートアイコンの右上に、商品点数の Badge を出して。0 のときは非表示、99 を超えたら「99+」で。",
        "en": "Add a count Badge at the top-right of the cart icon: hidden when 0, \"99+\" above 99."
      }
    },
    {
      "id": "empty_state",
      "kind": "component",
      "category": "feedback",
      "url": "https://uizukan.dev/entry/empty_state/",
      "nameEn": "Empty State",
      "nameJa": "空状態（エンプティステート）",
      "aliases": [
        "Zero State",
        "Blank Slate",
        "No Data View",
        "Empty View"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "該当なし（Column + Icon + Text + Button）",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": "ContentUnavailableView",
        "web": "該当なし（Empty state）",
        "flutter": "自作（Column + Icon + Text + FilledButton）"
      },
      "summary": "一覧に何もないとき、イラスト＋説明＋最初の行動を促す表示。",
      "description": "データがゼロの画面で、ただ真っ白にせず「なぜ空か」「次に何をすればよいか」を示す。イラスト・見出し・説明・CTA で構成。",
      "whenToUse": "初回利用、検索結果ゼロ、エラーで取得できなかった時（それぞれ文言を変える）。",
      "tags": [
        "feedback",
        "empty",
        "zero",
        "空",
        "データなし",
        "初回"
      ],
      "related": [
        "filled_button",
        "banner",
        "circular_progress"
      ],
      "needsDevice": false,
      "flutterApi": "自作（Column + Icon + Text + FilledButton）",
      "prompt": {
        "ja": "メモが 0 件のときに Empty State を出して。中央に大きなアイコン、「メモがありません」、説明文、「最初のメモを作る」ボタンで。",
        "en": "Show an Empty State when there are no notes: a large centered icon, \"No notes yet\", a short description, and a \"Create your first note\" button."
      }
    },
    {
      "id": "avatar",
      "kind": "component",
      "category": "display",
      "url": "https://uizukan.dev/entry/avatar/",
      "nameEn": "Avatar",
      "nameJa": "アバター（丸いプロフィール画像）",
      "aliases": [
        "Profile Picture",
        "User Icon",
        "Circle Avatar",
        "Avatar Group"
      ],
      "platformNames": {
        "material3": "該当なし（List item の leading avatar として登場。独立部品ではない）",
        "material2": "該当なし（List item の avatar）",
        "compose": "該当なし（Image + Modifier.clip(CircleShape)）",
        "hig": "該当なし（Image view を円形に）",
        "swiftUi": "Image + .clipShape(Circle())",
        "web": "<img>（Avatar。alt 必須）",
        "flutter": "CircleAvatar"
      },
      "summary": "丸く切り抜いたユーザー画像。画像がなければイニシャル。",
      "description": "円形のユーザー画像。画像未設定時はイニシャルや人型アイコンを背景色付きで表示する。右下にオンライン状態の点を重ねることもある。",
      "whenToUse": "ユーザーを表すあらゆる場所（コメント、チャット、メンバー一覧）。",
      "tags": [
        "display",
        "avatar",
        "profile",
        "アイコン",
        "プロフィール画像",
        "丸"
      ],
      "related": [
        "badge",
        "list_tile",
        "chat_bubble"
      ],
      "needsDevice": false,
      "flutterApi": "CircleAvatar",
      "prompt": {
        "ja": "直径 40dp の Avatar を作って。画像があれば表示、なければ名前のイニシャルを primaryContainer 背景で。右下にオンラインの緑の点を重ねて。",
        "en": "Create a 40dp Avatar: show the image if available, otherwise the name's initials on a primaryContainer background, with a green online dot at the bottom-right."
      }
    },
    {
      "id": "carousel",
      "kind": "component",
      "category": "display",
      "url": "https://uizukan.dev/entry/carousel/",
      "nameEn": "Carousel",
      "nameJa": "カルーセル（横スワイプの画像送り）",
      "aliases": [
        "Image Slider",
        "Slideshow",
        "Horizontal Pager",
        "Swiper"
      ],
      "platformNames": {
        "material3": "Carousel（Multi-browse / Uncontained / Hero / Full-screen）",
        "material2": "該当なし（Image list が近い）",
        "compose": "HorizontalMultiBrowseCarousel / HorizontalUncontainedCarousel",
        "hig": "該当なし（Scroll view のページング + Page control）",
        "swiftUi": "TabView + .tabViewStyle(.page) / ScrollView + .scrollTargetBehavior(.paging)",
        "web": "Carousel（WAI-ARIA パターン）",
        "flutter": "PageView / CarouselView"
      },
      "summary": "横にスワイプして画像やカードを 1 枚ずつ送る表示。",
      "description": "横スクロールでカードを送る。1 枚ずつ吸着（snap）するタイプと、端が少し見える peek タイプがある。下にドットを付けることが多い。",
      "whenToUse": "商品画像、キャンペーンバナー、おすすめの横並び。",
      "tags": [
        "display",
        "carousel",
        "slider",
        "swipe",
        "カルーセル",
        "横スワイプ"
      ],
      "related": [
        "page_indicator",
        "snap_scrolling",
        "page_view_swipe"
      ],
      "needsDevice": false,
      "flutterApi": "PageView / CarouselView",
      "prompt": {
        "ja": "商品画像の Carousel を作って。横スワイプで 1 枚ずつ吸着し、次の画像の端が少し見える peek 表示、下にドットの Page Indicator。",
        "en": "Create a product image Carousel: horizontal swipe snapping one image at a time, with the next image peeking at the edge and dot indicators below."
      }
    },
    {
      "id": "grid",
      "kind": "component",
      "category": "display",
      "url": "https://uizukan.dev/entry/grid/",
      "nameEn": "Grid",
      "nameJa": "グリッド（格子状の一覧）",
      "aliases": [
        "Photo Grid",
        "Grid View",
        "Collection View",
        "Tile Grid"
      ],
      "platformNames": {
        "material3": "該当なし（Layout の Grid。部品ではない）",
        "material2": "Image list（旧称 Grid list）",
        "compose": "LazyVerticalGrid",
        "hig": "Collections",
        "swiftUi": "LazyVGrid / Grid",
        "web": "display: grid（CSS Grid）/ Grid（WAI-ARIA パターン）",
        "flutter": "GridView / SliverGrid"
      },
      "summary": "写真や商品を 2〜3 列の格子に並べた一覧。",
      "description": "同じ大きさのセルを格子状に並べる。列数は画面幅で変える（レスポンシブ）。高さがバラバラなら staggered grid。",
      "whenToUse": "写真・商品・アルバムなど、画像が主役の一覧。文字が主役ならリスト。",
      "tags": [
        "display",
        "grid",
        "photo",
        "格子",
        "ギャラリー",
        "一覧"
      ],
      "related": [
        "card",
        "list_tile",
        "infinite_scroll",
        "pinch_zoom"
      ],
      "needsDevice": false,
      "flutterApi": "GridView / SliverGrid",
      "prompt": {
        "ja": "写真の Grid を作って。スマホでは 3 列、タブレットでは 5 列、正方形セル、隙間 2dp。タップで拡大表示に遷移。",
        "en": "Create a photo Grid: 3 columns on phones, 5 on tablets, square cells with 2dp gaps. Tapping opens a full-screen viewer."
      }
    },
    {
      "id": "sticky_header",
      "kind": "component",
      "category": "display",
      "url": "https://uizukan.dev/entry/sticky_header/",
      "nameEn": "Sticky Section Header",
      "nameJa": "固定セクションヘッダー",
      "aliases": [
        "Pinned Header",
        "Section Header",
        "Group Header",
        "Sticky Header"
      ],
      "platformNames": {
        "material3": "該当なし（List の section header。固定は規定なし）",
        "material2": "Subheader（Lists）",
        "compose": "LazyColumn stickyHeader",
        "hig": "Lists and tables（section header）",
        "swiftUi": "Section(header:) / LazyVStack(pinnedViews: [.sectionHeaders])",
        "web": "position: sticky",
        "flutter": "SliverPersistentHeader(pinned: true) / sticky_headers パッケージ"
      },
      "summary": "連絡先の「あ」「か」のように、スクロールしても上に張り付く見出し。",
      "description": "リストのグループ見出しが、そのグループが画面内にある間、上端に固定される。次の見出しが来ると押し上げられる。",
      "whenToUse": "日付ごと・頭文字ごとにグループ化された長いリスト。",
      "tags": [
        "display",
        "sticky",
        "header",
        "pinned",
        "固定",
        "見出し",
        "セクション"
      ],
      "related": [
        "list_tile",
        "large_title_app_bar",
        "divider"
      ],
      "needsDevice": false,
      "flutterApi": "SliverPersistentHeader(pinned: true) / sticky_headers パッケージ",
      "prompt": {
        "ja": "取引履歴を日付ごとにグループ化して、日付の見出しがスクロールで上に張り付く Sticky Section Header にして。",
        "en": "Group the transaction history by date and make each date heading a Sticky Section Header that pins to the top while scrolling."
      }
    },
    {
      "id": "rating_bar",
      "kind": "component",
      "category": "display",
      "url": "https://uizukan.dev/entry/rating_bar/",
      "nameEn": "Rating Bar",
      "nameJa": "星評価",
      "aliases": [
        "Star Rating",
        "Rating Stars",
        "Review Stars"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "該当なし（View 系の android.widget.RatingBar。Compose は自作）",
        "hig": "Rating indicators",
        "swiftUi": "該当なし（Image(systemName: \"star\") の並びで自作）",
        "web": "該当なし（role=\"radiogroup\" で実装）",
        "flutter": "自作（Row of Icon）/ flutter_rating_bar"
      },
      "summary": "★★★★☆ で評価を表示・入力する。",
      "description": "5 つの星で評価を示す。表示専用（半分の星あり）と、タップやドラッグで入力できるものがある。",
      "whenToUse": "レビューの表示・投稿、アプリ内の満足度アンケート。",
      "tags": [
        "display",
        "rating",
        "star",
        "星",
        "評価",
        "レビュー"
      ],
      "related": [
        "haptic_selection",
        "like_burst"
      ],
      "needsDevice": false,
      "flutterApi": "自作（Row of Icon）/ flutter_rating_bar",
      "prompt": {
        "ja": "レビュー投稿用の Rating Bar を作って。星 5 つをタップまたは横ドラッグで選べて、選ぶたびに軽い触覚を鳴らして。",
        "en": "Create a Rating Bar for posting reviews: 5 stars selectable by tap or horizontal drag, with a light haptic on each change."
      }
    },
    {
      "id": "stepper_progress",
      "kind": "component",
      "category": "display",
      "url": "https://uizukan.dev/entry/stepper_progress/",
      "nameEn": "Progress Stepper",
      "nameJa": "ステップ表示（手順の進捗）",
      "aliases": [
        "Stepper",
        "Step Indicator",
        "Wizard Steps",
        "Progress Steps"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（Material 1 の Steppers。M2 では外れた）",
        "compose": "該当なし（自作）",
        "hig": "該当なし（Progress indicators で代替）",
        "swiftUi": "該当なし（自作）",
        "web": "該当なし（Progress steps。<ol> + aria-current=\"step\"）",
        "flutter": "Stepper / 自作"
      },
      "summary": "「配送先 → 支払い → 確認」のように、複数ステップの現在地を示す。",
      "description": "番号付きの丸を線でつなぎ、完了済み・現在・未着手を色分けする。購入フローや登録手順で使う。",
      "whenToUse": "3〜5 ステップの手続き。2 ステップなら不要、6 以上なら分割を検討。",
      "tags": [
        "display",
        "stepper",
        "steps",
        "wizard",
        "手順",
        "ステップ",
        "購入フロー"
      ],
      "related": [
        "linear_progress",
        "filled_button",
        "page_view_swipe"
      ],
      "needsDevice": false,
      "flutterApi": "Stepper / 自作",
      "prompt": {
        "ja": "購入フローの上部に「配送先／支払い／確認」の横並び Progress Stepper を作って。完了は✓、現在は primary の丸、未着手はグレー。",
        "en": "Add a horizontal Progress Stepper \"Shipping / Payment / Review\" at the top of checkout: completed = ✓, current = primary circle, upcoming = gray."
      }
    },
    {
      "id": "chat_bubble",
      "kind": "component",
      "category": "display",
      "url": "https://uizukan.dev/entry/chat_bubble/",
      "nameEn": "Chat Bubble",
      "nameJa": "チャットの吹き出し",
      "aliases": [
        "Message Bubble",
        "Speech Bubble",
        "Chat Message"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "該当なし（Box + RoundedCornerShape で自作）",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": "該当なし（Text + .background(RoundedRectangle) で自作）",
        "web": "該当なし（Chat bubble / Message bubble）",
        "flutter": "自作（Align + Container）"
      },
      "summary": "自分は右の青、相手は左のグレー、の吹き出し。",
      "description": "送信者で左右と色を変える角丸の吹き出し。連続メッセージは角を詰め、下に時刻や既読を小さく表示する。",
      "whenToUse": "チャット・コメント・AI との対話画面。",
      "tags": [
        "display",
        "chat",
        "bubble",
        "message",
        "チャット",
        "吹き出し",
        "メッセージ"
      ],
      "related": [
        "avatar",
        "text_field_filled",
        "staggered_list"
      ],
      "needsDevice": false,
      "flutterApi": "自作（Align + Container）",
      "prompt": {
        "ja": "チャット画面の Chat Bubble を作って。自分の発言は右寄せ primary 色・白文字、相手は左寄せ surfaceContainerHighest。角丸 18dp で、送信者側の下の角だけ小さく。",
        "en": "Create Chat Bubbles: my messages right-aligned in primary with white text, theirs left-aligned in surfaceContainerHighest. 18dp radius, with a smaller radius on the sender-side bottom corner."
      }
    },
    {
      "id": "stat_tile",
      "kind": "component",
      "category": "display",
      "url": "https://uizukan.dev/entry/stat_tile/",
      "nameEn": "Stat Tile",
      "nameJa": "数値タイル（KPI カード）",
      "aliases": [
        "KPI Card",
        "Metric Card",
        "Stat Card",
        "Summary Tile"
      ],
      "platformNames": {
        "material3": "該当なし（Card で組む）",
        "material2": "該当なし（Card で組む）",
        "compose": "該当なし（Card + Column）",
        "hig": "該当なし（Lockups / Widget が近い）",
        "swiftUi": "該当なし（GroupBox / VStack で自作）",
        "web": "該当なし（Stat card / KPI card）",
        "flutter": "自作（Card + Column）"
      },
      "summary": "「今月の支出 ¥42,300」のように、大きな数字と小さなラベルのカード。",
      "description": "ダッシュボードの先頭で使う、数値を主役にした小さなカード。前期比の矢印や色で増減を示す。",
      "whenToUse": "ホーム画面のサマリー、家計簿・健康・学習アプリの実績表示。",
      "tags": [
        "display",
        "stat",
        "kpi",
        "metric",
        "数値",
        "ダッシュボード",
        "サマリー"
      ],
      "related": [
        "card",
        "animated_counter",
        "linear_progress"
      ],
      "needsDevice": false,
      "flutterApi": "自作（Card + Column）",
      "prompt": {
        "ja": "ホームの上部に Stat Tile を 2 つ横に並べて。「今月の支出」「残り予算」で、大きな数字の下に小さなラベル、右上に前月比の緑／赤の矢印。",
        "en": "Place two Stat Tiles side by side at the top of Home: \"Spent this month\" and \"Remaining budget\", a large number with a small label below and a green/red month-over-month arrow at the top-right."
      }
    },
    {
      "id": "donut_chart",
      "kind": "component",
      "category": "display",
      "url": "https://uizukan.dev/entry/donut_chart/",
      "nameEn": "Donut Chart",
      "nameJa": "ドーナツグラフ",
      "aliases": [
        "Doughnut Chart",
        "Ring Chart",
        "Pie Chart",
        "Sector Chart"
      ],
      "platformNames": {
        "material3": "該当なし（Data visualization の指針のみで部品は無い）",
        "material2": "該当なし（Data visualization の指針のみ）",
        "compose": "該当なし（Canvas.drawArc で自作）",
        "hig": "Charts（Swift Charts の扇形）",
        "swiftUi": "Chart + SectorMark(angle:innerRadius:)",
        "web": "該当なし（SVG の円弧や Chart.js の doughnut で自作）",
        "flutter": "自作（CustomPainter + Canvas.drawArc）"
      },
      "summary": "全体に対する内訳を、輪の長さで見せるグラフ。真ん中に合計を置ける。",
      "description": "円グラフの真ん中をくり抜いた形。区分ごとに色を変えた弧を時計の 12 時から順に並べ、弧の長さで割合を示す。空いた真ん中に合計や使用率を大きく書けるのが円グラフとの違い。",
      "whenToUse": "ストレージの使用量、支出の内訳、時間の使い方など「全体のうち何がどれだけか」を 2〜6 区分で見せるとき。区分が多い・値が近いときは棒グラフのほうが読みやすい。色だけで区別させず凡例（Chart Legend）を必ず添える。",
      "tags": [
        "display",
        "chart",
        "donut",
        "pie",
        "グラフ",
        "円グラフ",
        "ドーナツ",
        "内訳",
        "割合",
        "ぐるっと",
        "輪っか"
      ],
      "related": [
        "chart_legend",
        "stat_tile",
        "circular_progress",
        "animated_counter"
      ],
      "needsDevice": false,
      "flutterApi": "自作（CustomPainter + Canvas.drawArc）",
      "prompt": {
        "ja": "ストレージ使用量を Donut Chart で見せて。写真・アプリ・書類・その他の 4 色の弧を 12 時から順に並べ、真ん中に「43.5 / 64 GB」。表示時に弧が伸びるアニメーション付きで。",
        "en": "Show storage usage as a Donut Chart: four colored arcs (Photos, Apps, Documents, Other) starting at 12 o'clock, with \"43.5 / 64 GB\" in the center, and animate the arcs growing in on appear."
      }
    },
    {
      "id": "chart_legend",
      "kind": "component",
      "category": "display",
      "url": "https://uizukan.dev/entry/chart_legend/",
      "nameEn": "Chart Legend",
      "nameJa": "凡例（グラフの色と名前・値の一覧）",
      "aliases": [
        "Legend",
        "Chart Key",
        "Data Legend"
      ],
      "platformNames": {
        "material3": "該当なし（Data visualization の指針のみで部品は無い）",
        "material2": "該当なし（Data visualization の指針のみ）",
        "compose": "該当なし（Row + Box で自作）",
        "hig": "Charts の Legend",
        "swiftUi": ".chartLegend(position:alignment:)（Swift Charts）",
        "web": "該当なし（ul / dl で自作。Chart.js は legend オプション）",
        "flutter": "自作（Row + Container + Text）"
      },
      "summary": "グラフの色が何を表すかを、色の印・名前・値で並べた一覧。",
      "description": "グラフの横や下に置く、色の小さな印と区分名と値の行。色を見分けにくい人にも、名前と数字で内訳が伝わる。値は右に揃え、区分の並びはグラフの順と同じにする。",
      "whenToUse": "Donut Chart・円グラフ・積み上げ棒グラフなど、色で区分を分けたグラフには必ず添える。区分が 1 つだけなら不要。",
      "tags": [
        "display",
        "chart",
        "legend",
        "グラフ",
        "凡例",
        "内訳",
        "色の説明",
        "一覧"
      ],
      "related": [
        "donut_chart",
        "stat_tile",
        "list_tile"
      ],
      "needsDevice": false,
      "flutterApi": "自作（Row + Container + Text）",
      "prompt": {
        "ja": "Donut Chart の右に Chart Legend を付けて。各行は色の小さな四角・区分名・値（右揃え）で、並びはグラフと同じ順に。",
        "en": "Add a Chart Legend to the right of the Donut Chart: each row has a small color square, the category name and the value right-aligned, in the same order as the chart."
      }
    },
    {
      "id": "tap",
      "kind": "action",
      "category": "gestures",
      "url": "https://uizukan.dev/entry/tap/",
      "nameEn": "Tap",
      "nameJa": "タップ",
      "aliases": [
        "Click",
        "Press",
        "Single Tap"
      ],
      "platformNames": {
        "material3": "Gestures（Tap）",
        "material2": "Gestures（Tap）",
        "compose": "Modifier.clickable / detectTapGestures(onTap:)",
        "hig": "Tap",
        "swiftUi": ".onTapGesture / TapGesture",
        "web": "click / pointerup イベント",
        "flutter": "GestureDetector(onTap:) / InkWell"
      },
      "summary": "指で一度触れて離す、最も基本の操作。",
      "description": "触れて離した瞬間に発火する。押した瞬間（onTapDown）と離した瞬間（onTapUp）を分けて取れば、押している間の見た目変化が作れる。",
      "whenToUse": "ほぼ全ての操作。ボタン部品は内部で処理済みなので、自作の面に付けるときに使う。",
      "tags": [
        "gesture",
        "tap",
        "click",
        "タップ",
        "クリック"
      ],
      "related": [
        "double_tap",
        "long_press",
        "ripple",
        "press_scale"
      ],
      "needsDevice": false,
      "flutterApi": "GestureDetector(onTap:) / InkWell",
      "prompt": {
        "ja": "このカード全体をタップできるようにして。押している間は少し暗くなり、離したら詳細画面に遷移。",
        "en": "Make the whole card tappable: dim slightly while pressed, and navigate to the detail screen on release."
      }
    },
    {
      "id": "double_tap",
      "kind": "action",
      "category": "gestures",
      "url": "https://uizukan.dev/entry/double_tap/",
      "nameEn": "Double Tap",
      "nameJa": "ダブルタップ",
      "aliases": [
        "Double Click",
        "Two Taps"
      ],
      "platformNames": {
        "material3": "該当なし（Gestures に個別名は無い）",
        "material2": "Gestures（two quick taps＝zoom）",
        "compose": "Modifier.combinedClickable(onDoubleClick:) / detectTapGestures(onDoubleTap:)",
        "hig": "Double tap",
        "swiftUi": ".onTapGesture(count: 2)",
        "web": "dblclick イベント",
        "flutter": "GestureDetector(onDoubleTap:)"
      },
      "summary": "素早く 2 回タップ。Instagram の「いいね」、地図のズームが典型。",
      "description": "短い間隔で 2 回タップしたときに発火する。単タップと共存させると、単タップの反応が少し遅れる（2 回目を待つため）。",
      "whenToUse": "画像への「いいね」、地図や写真のズームイン。重要操作には向かない（発見されにくい）。",
      "tags": [
        "gesture",
        "double tap",
        "いいね",
        "ダブルタップ",
        "ズーム"
      ],
      "related": [
        "tap",
        "like_burst",
        "pinch_zoom"
      ],
      "needsDevice": false,
      "flutterApi": "GestureDetector(onDoubleTap:)",
      "prompt": {
        "ja": "投稿画像をダブルタップしたら「いいね」が付いて、画像の中央に大きなハートが一瞬ポンと出て消えるようにして。",
        "en": "Double-tapping the post image should like it and pop a large heart in the center of the image that fades out."
      }
    },
    {
      "id": "long_press",
      "kind": "action",
      "category": "gestures",
      "url": "https://uizukan.dev/entry/long_press/",
      "nameEn": "Long Press",
      "nameJa": "長押し",
      "aliases": [
        "Press and Hold",
        "Touch and Hold",
        "Long Tap"
      ],
      "platformNames": {
        "material3": "Gestures（Long press）",
        "material2": "Gestures（Long press）",
        "compose": "Modifier.combinedClickable(onLongClick:) / detectTapGestures(onLongPress:)",
        "hig": "Touch and hold",
        "swiftUi": ".onLongPressGesture / LongPressGesture",
        "web": "contextmenu イベント（標準の長押しイベントは無い。pointerdown + タイマー）",
        "flutter": "GestureDetector(onLongPress:) / InkWell(onLongPress:)"
      },
      "summary": "約 0.5 秒押し続けると発火する。隠れたメニューや選択モードの入口。",
      "description": "一定時間（Flutter 既定 500ms）押し続けると発火する。発火の瞬間に触覚を鳴らすと「認識された」ことが伝わる。",
      "whenToUse": "コンテキストメニュー、複数選択モードへの切替、並べ替え開始、ツールチップ表示。",
      "tags": [
        "gesture",
        "long press",
        "長押し",
        "ホールド"
      ],
      "related": [
        "long_press_haptic_navigate",
        "context_menu",
        "drag_reorder",
        "tooltip"
      ],
      "needsDevice": false,
      "flutterApi": "GestureDetector(onLongPress:) / InkWell(onLongPress:)",
      "prompt": {
        "ja": "リストの行を長押ししたら、軽く振動してから複数選択モードに入るようにして。",
        "en": "Long-pressing a list row should trigger a light haptic and enter multi-select mode."
      }
    },
    {
      "id": "long_press_haptic_navigate",
      "kind": "action",
      "category": "gestures",
      "url": "https://uizukan.dev/entry/long_press_haptic_navigate/",
      "nameEn": "Long Press → Haptic → Navigate",
      "nameJa": "長押し → 振動 → 画面遷移",
      "aliases": [
        "Hold to Confirm",
        "Press-and-hold Action",
        "Haptic Long Press"
      ],
      "platformNames": {
        "material3": "該当なし（Long press + Haptics + Transition の組み合わせ）",
        "material2": "該当なし（組み合わせ）",
        "compose": "combinedClickable(onLongClick) + performHapticFeedback(LongPress) + NavController.navigate",
        "hig": "Touch and hold + Impact haptic + push",
        "swiftUi": ".onLongPressGesture + .sensoryFeedback(.impact) + NavigationLink",
        "web": "該当なし（pointer + navigator.vibrate() + History API）",
        "flutter": "GestureDetector(onLongPress:) + HapticFeedback.mediumImpact() + Navigator.push"
      },
      "summary": "ボタンを長押しすると端末が短く震え、その勢いで次の画面へ遷移する複合アクション。",
      "description": "「長押し」「触覚フィードバック（Impact）」「画面遷移」の 3 つを組み合わせたパターン。誤タップで遷移したくない操作や、隠しショートカット的な入口に使う。Claude に伝えるときは 3 要素を分けて言うと確実。",
      "whenToUse": "重要だが誤操作を避けたい遷移（削除確認画面、管理モード）、上級者向けショートカット。",
      "tags": [
        "gesture",
        "long press",
        "haptic",
        "navigate",
        "長押し",
        "振動",
        "遷移",
        "ブルッ"
      ],
      "related": [
        "long_press",
        "haptic_impact",
        "push_slide",
        "press_scale"
      ],
      "needsDevice": true,
      "flutterApi": "GestureDetector(onLongPress:) + HapticFeedback.mediumImpact() + Navigator.push",
      "prompt": {
        "ja": "このボタンを長押し（約 0.5 秒）したら、HapticFeedback.mediumImpact() で端末を短く振動させてから、次の画面に push 遷移して。通常のタップでは何も起きないように。押している間はボタンを少し縮めて「溜め」を見せて。",
        "en": "When this button is long-pressed (~0.5s), fire HapticFeedback.mediumImpact() and then push the next screen. A normal tap should do nothing. While pressed, scale the button down slightly to show the \"charge\"."
      }
    },
    {
      "id": "swipe_to_dismiss",
      "kind": "action",
      "category": "gestures",
      "url": "https://uizukan.dev/entry/swipe_to_dismiss/",
      "nameEn": "Swipe to Dismiss",
      "nameJa": "スワイプで削除",
      "aliases": [
        "Swipe to Delete",
        "Dismissible",
        "Swipe Away"
      ],
      "platformNames": {
        "material3": "該当なし（Gestures では Swipe の一般記述のみ）",
        "material2": "Gestures（Swipe to dismiss）",
        "compose": "SwipeToDismissBox",
        "hig": "Swipe（dismiss）",
        "swiftUi": ".swipeActions / .onDelete",
        "web": "該当なし（Pointer Events で自作）",
        "flutter": "Dismissible"
      },
      "summary": "行を横にスワイプし切ると、その行が消える（削除される）。",
      "description": "行を端までドラッグすると画面外へ飛んで消える。背面に赤い背景とゴミ箱アイコンを出して「削除される」ことを予告する。",
      "whenToUse": "メール・通知・タスクなど、削除やアーカイブが頻繁なリスト。",
      "tags": [
        "gesture",
        "swipe",
        "dismiss",
        "delete",
        "スワイプ",
        "削除"
      ],
      "related": [
        "swipe_actions",
        "snackbar_undo",
        "list_tile"
      ],
      "needsDevice": false,
      "flutterApi": "Dismissible",
      "prompt": {
        "ja": "タスクの行を左にスワイプすると削除できるようにして。スワイプ中は背面に赤い背景とゴミ箱アイコン、削除後は Snackbar で「元に戻す」。",
        "en": "Let users swipe a task row left to delete it. Show a red background with a trash icon behind while swiping, then a Snackbar with \"Undo\"."
      }
    },
    {
      "id": "swipe_actions",
      "kind": "action",
      "category": "gestures",
      "url": "https://uizukan.dev/entry/swipe_actions/",
      "nameEn": "Swipe Actions",
      "nameJa": "スワイプで操作ボタンを出す",
      "aliases": [
        "Swipe to Reveal",
        "Leading/Trailing Swipe Actions",
        "Slidable",
        "Swipe Menu"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "SwipeToDismissBox（背景に action）",
        "hig": "Swipe（reveal actions）",
        "swiftUi": ".swipeActions(edge:)",
        "web": "該当なし（Pointer Events で自作）",
        "flutter": "flutter_slidable（Slidable + ActionPane）"
      },
      "summary": "行を少し横にずらすと、裏から「アーカイブ」「削除」などのボタンが現れる。",
      "description": "行をスワイプすると隠れていたボタン群がスライドして出る。iOS メールの標準挙動。端まで引き切ると先頭のアクションが即実行される（full swipe）。",
      "whenToUse": "行ごとに 2〜3 個の操作がある一覧（メール、タスク、チャット一覧）。",
      "tags": [
        "gesture",
        "swipe",
        "actions",
        "slidable",
        "スワイプ",
        "アーカイブ"
      ],
      "related": [
        "swipe_to_dismiss",
        "list_tile",
        "popup_menu"
      ],
      "needsDevice": false,
      "flutterApi": "flutter_slidable（Slidable + ActionPane）",
      "prompt": {
        "ja": "メール一覧の行を左にスワイプすると「アーカイブ」「削除」のボタンが出る Swipe Actions にして。端まで引き切ったら削除が即実行されるように。",
        "en": "Add Swipe Actions to the mail list: swiping a row left reveals \"Archive\" and \"Delete\" buttons; a full swipe immediately deletes."
      }
    },
    {
      "id": "drag_reorder",
      "kind": "action",
      "category": "gestures",
      "url": "https://uizukan.dev/entry/drag_reorder/",
      "nameEn": "Drag to Reorder",
      "nameJa": "ドラッグで並べ替え",
      "aliases": [
        "Drag and Drop Reorder",
        "Reorderable List",
        "Sortable"
      ],
      "platformNames": {
        "material3": "Gestures（Drag）",
        "material2": "Gestures（Long press and drag to reorder）",
        "compose": "該当なし（LazyColumn + Modifier.draggable で自作 / reorderable ライブラリ）",
        "hig": "Drag（Move a UI element）",
        "swiftUi": ".onMove（EditMode）",
        "web": "HTML Drag and Drop API（draggable）",
        "flutter": "ReorderableListView / ReorderableDragStartListener"
      },
      "summary": "長押しして持ち上げ、上下に動かして順番を変える。",
      "description": "行を長押しすると浮き上がり（elevation）、ドラッグで他の行が避けて隙間を作る。離すと新しい位置に収まる。右端の ≡ ハンドルで掴む方式もある。",
      "whenToUse": "お気に入り順、プレイリスト、タスクの優先順位など、ユーザーが順序を決めるリスト。",
      "tags": [
        "gesture",
        "drag",
        "reorder",
        "drag and drop",
        "並べ替え",
        "ドラッグ",
        "ハンドル"
      ],
      "related": [
        "long_press",
        "list_tile",
        "haptic_impact"
      ],
      "needsDevice": false,
      "flutterApi": "ReorderableListView / ReorderableDragStartListener",
      "prompt": {
        "ja": "タスク一覧を Drag to Reorder できるようにして。右端の ≡ ハンドルを掴んで動かす方式で、持ち上げた行は影付きで浮き、離すと順番が保存されるように。",
        "en": "Make the task list reorderable by dragging the ≡ handle at the right edge. The lifted row floats with a shadow, and the new order is saved on drop."
      }
    },
    {
      "id": "pinch_zoom",
      "kind": "action",
      "category": "gestures",
      "url": "https://uizukan.dev/entry/pinch_zoom/",
      "nameEn": "Pinch In / Pinch Out",
      "nameJa": "ピンチイン／ピンチアウト",
      "aliases": [
        "Pinch to Zoom",
        "ピンチイン",
        "ピンチアウト",
        "Zoom In / Zoom Out",
        "Pinch Zoom",
        "Scale Gesture",
        "Pan and Zoom"
      ],
      "platformNames": {
        "material3": "Gestures（Pinch）",
        "material2": "Gestures（Pinch to zoom）",
        "compose": "Modifier.transformable / detectTransformGestures",
        "hig": "Zoom（pinch）",
        "swiftUi": "MagnifyGesture",
        "web": "Pointer Events / touch-action: pinch-zoom",
        "flutter": "InteractiveViewer"
      },
      "summary": "2 本指を広げて拡大（ピンチアウト）、つまんで縮小（ピンチイン）。ドラッグで移動。",
      "description": "画像や地図を 2 本指で拡大縮小し、1 本指でパンする。ダブルタップで段階ズームを併用することが多い。",
      "whenToUse": "写真ビューア、地図、図面、レシート画像。",
      "tags": [
        "gesture",
        "pinch",
        "zoom",
        "scale",
        "ピンチ",
        "ピンチイン",
        "ピンチアウト",
        "拡大",
        "縮小",
        "写真"
      ],
      "related": [
        "double_tap",
        "grid",
        "hero_transition"
      ],
      "needsDevice": false,
      "flutterApi": "InteractiveViewer",
      "prompt": {
        "ja": "写真の拡大表示画面で、ピンチアウトで拡大・ピンチインで縮小（Pinch to Zoom。1 本指で移動）できるようにして。最大 4 倍、ダブルタップで 2 倍⇄等倍。",
        "en": "In the photo viewer, support Pinch to Zoom (two-finger scale, one-finger pan), max 4x, and double-tap to toggle between 2x and 1x."
      }
    },
    {
      "id": "context_menu",
      "kind": "action",
      "category": "gestures",
      "url": "https://uizukan.dev/entry/context_menu/",
      "nameEn": "Context Menu (Long-press Preview)",
      "nameJa": "コンテキストメニュー（長押しプレビュー）",
      "aliases": [
        "Peek and Pop",
        "Haptic Touch Menu",
        "3D Touch Menu",
        "Long-press Menu"
      ],
      "platformNames": {
        "material3": "Menus（Context menu）",
        "material2": "Menus（Context menu）",
        "compose": "DropdownMenu を長押しで開く（View 系は ContextMenu）",
        "hig": "Context menus",
        "swiftUi": ".contextMenu",
        "web": "contextmenu イベント / Menu（WAI-ARIA パターン）",
        "flutter": "CupertinoContextMenu"
      },
      "summary": "長押しすると対象が浮き上がって拡大され、その下にメニューが出る iOS の挙動。",
      "description": "長押しで背景がぼけ、対象が Hero のように拡大表示され、「共有・コピー・削除」などのメニューが下に並ぶ。触覚も同時に鳴る。",
      "whenToUse": "リンク・画像・カードに対する補助操作を、画面を汚さずに提供したいとき。",
      "tags": [
        "gesture",
        "context menu",
        "peek",
        "long press",
        "コンテキストメニュー",
        "プレビュー",
        "iOS"
      ],
      "related": [
        "long_press",
        "popup_menu",
        "haptic_impact"
      ],
      "needsDevice": true,
      "flutterApi": "CupertinoContextMenu",
      "prompt": {
        "ja": "画像を長押しすると iOS 風の Context Menu が出るようにして。画像が浮き上がって拡大され、下に「共有／保存／削除」のメニュー。",
        "en": "Long-pressing an image should open an iOS-style Context Menu: the image lifts and enlarges with a blurred background and \"Share / Save / Delete\" actions below."
      }
    },
    {
      "id": "tap_outside_dismiss_keyboard",
      "kind": "action",
      "category": "gestures",
      "url": "https://uizukan.dev/entry/tap_outside_dismiss_keyboard/",
      "nameEn": "Tap Outside to Dismiss Keyboard",
      "nameJa": "外側タップでキーボードを閉じる",
      "aliases": [
        "Dismiss Keyboard on Tap",
        "Unfocus on Tap",
        "Keyboard Dismiss"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "LocalFocusManager.clearFocus() + Modifier.pointerInput",
        "hig": "該当なし（慣習。Virtual keyboards の dismiss）",
        "swiftUi": ".scrollDismissesKeyboard / UIApplication.sendAction(#selector(resignFirstResponder))",
        "web": "blur() / document の click",
        "flutter": "TextField(onTapOutside:) / GestureDetector + FocusScope"
      },
      "summary": "入力欄以外をタップするとキーボードが引っ込む。",
      "description": "フォーム画面の余白をタップしたときにフォーカスを外し、キーボードを閉じる。Flutter は既定ではしないので明示的に付ける。スクロールで閉じる方式もある。",
      "whenToUse": "ほぼ全てのフォーム画面。",
      "tags": [
        "gesture",
        "keyboard",
        "dismiss",
        "unfocus",
        "キーボード",
        "閉じる"
      ],
      "related": [
        "text_field_outlined",
        "tap"
      ],
      "needsDevice": false,
      "flutterApi": "TextField(onTapOutside:) / GestureDetector + FocusScope",
      "prompt": {
        "ja": "フォーム画面で、入力欄の外をタップしたらキーボードが閉じるようにして。スクロールを始めたときも閉じて。",
        "en": "On the form screen, dismiss the keyboard when tapping outside a text field, and also when the user starts scrolling."
      }
    },
    {
      "id": "pull_to_refresh",
      "kind": "action",
      "category": "gestures",
      "url": "https://uizukan.dev/entry/pull_to_refresh/",
      "nameEn": "Pull to Refresh",
      "nameJa": "引っ張って更新",
      "aliases": [
        "Swipe to Refresh",
        "Pull-down Refresh",
        "Refresh Control"
      ],
      "platformNames": {
        "material3": "Pull to refresh（Progress indicators の用法）",
        "material2": "Swipe to refresh（SwipeRefreshLayout）",
        "compose": "PullToRefreshBox",
        "hig": "該当なし（慣習。UIKit の Refresh control）",
        "swiftUi": ".refreshable",
        "web": "該当なし（ブラウザ機能。overscroll-behavior で制御）",
        "flutter": "RefreshIndicator / CupertinoSliverRefreshControl"
      },
      "summary": "一覧の先頭でさらに下へ引っ張ると、くるくるが出て再読み込みされる。",
      "description": "リスト最上部で下方向にドラッグすると更新インジケータが現れ、離すと再取得する。Material は円形のスピナーが降りてくる、iOS は放射状インジケータが引き伸ばされる。",
      "whenToUse": "フィード・受信箱・通知など、新着が発生する一覧。",
      "tags": [
        "gesture",
        "pull",
        "refresh",
        "更新",
        "引っ張る",
        "フィード"
      ],
      "related": [
        "infinite_scroll",
        "circular_progress",
        "overscroll_bounce"
      ],
      "needsDevice": false,
      "flutterApi": "RefreshIndicator / CupertinoSliverRefreshControl",
      "prompt": {
        "ja": "フィードを Pull to Refresh で更新できるようにして。iOS では iOS 風のインジケータ（CupertinoSliverRefreshControl）にして。",
        "en": "Add Pull to Refresh to the feed. On iOS use the native-style CupertinoSliverRefreshControl."
      }
    },
    {
      "id": "drag_to_dismiss_sheet",
      "kind": "action",
      "category": "gestures",
      "url": "https://uizukan.dev/entry/drag_to_dismiss_sheet/",
      "nameEn": "Drag to Dismiss",
      "nameJa": "ドラッグで閉じる",
      "aliases": [
        "Swipe Down to Close",
        "Interactive Dismiss",
        "Pull Down to Dismiss"
      ],
      "platformNames": {
        "material3": "Bottom sheets（drag to dismiss）",
        "material2": "Sheets: bottom（drag to dismiss）",
        "compose": "ModalBottomSheet（既定でドラッグで閉じる）",
        "hig": "Sheets（drag to dismiss）",
        "swiftUi": ".sheet（.interactiveDismissDisabled で制御）",
        "web": "該当なし（Pointer Events で自作）",
        "flutter": "showModalBottomSheet(enableDrag: true) / 自作（GestureDetector + Transform）"
      },
      "summary": "シートや画像ビューアを下に引っ張ると、指に追従して閉じる。",
      "description": "モーダルを指の動きに追従させて閉じる。途中で離すと戻る、一定距離を超えると閉じる。写真ビューアでは背景が徐々に透明になる。",
      "whenToUse": "Bottom Sheet、全画面の画像ビューア、iOS 風の sheet。",
      "tags": [
        "gesture",
        "drag",
        "dismiss",
        "sheet",
        "ドラッグ",
        "閉じる",
        "シート"
      ],
      "related": [
        "modal_bottom_sheet",
        "slide_up_modal",
        "pinch_zoom"
      ],
      "needsDevice": false,
      "flutterApi": "showModalBottomSheet(enableDrag: true) / 自作（GestureDetector + Transform）",
      "prompt": {
        "ja": "全画面の画像ビューアを、下にドラッグすると指に追従して縮みながら閉じられるようにして。背景は距離に応じて透明に。閾値未満で離したら元に戻る。",
        "en": "Let the full-screen image viewer be dismissed by dragging down: the image follows the finger and shrinks, the background fades with distance, and it snaps back if released below the threshold."
      }
    },
    {
      "id": "haptic_selection",
      "kind": "action",
      "category": "haptics",
      "url": "https://uizukan.dev/entry/haptic_selection/",
      "nameEn": "Selection Haptic",
      "nameJa": "選択の触覚（カチッ）",
      "aliases": [
        "Selection Click",
        "Selection Feedback",
        "Tick Haptic"
      ],
      "platformNames": {
        "material3": "該当なし（触覚は Android の指針。M3 部品には規定なし）",
        "material2": "該当なし（M2 に無い）",
        "compose": "HapticFeedbackType.SegmentTick（View 系は HapticFeedbackConstants.CLOCK_TICK）",
        "hig": "Selection",
        "swiftUi": ".sensoryFeedback(.selection)",
        "web": "navigator.vibrate()（種類の区別なし）",
        "flutter": "HapticFeedback.selectionClick()"
      },
      "summary": "ピッカーを回したときの「カチッ」。最も軽い触覚。",
      "description": "選択肢が切り替わるたびに鳴らす、ごく短く軽い振動。ドラム式ピッカー、スライダーの目盛り、セグメント切替で使う。",
      "whenToUse": "連続して何度も鳴る可能性がある切替操作。重い Impact を連打すると不快になる。",
      "tags": [
        "haptic",
        "selection",
        "click",
        "tick",
        "触覚",
        "カチッ",
        "ピッカー"
      ],
      "related": [
        "haptic_impact",
        "cupertino_picker",
        "segmented_button",
        "slider"
      ],
      "needsDevice": true,
      "flutterApi": "HapticFeedback.selectionClick()",
      "prompt": {
        "ja": "セグメントを切り替えるたびに HapticFeedback.selectionClick()（軽い「カチッ」）を鳴らして。",
        "en": "Fire HapticFeedback.selectionClick() (a light tick) every time the segment selection changes."
      }
    },
    {
      "id": "haptic_impact",
      "kind": "action",
      "category": "haptics",
      "url": "https://uizukan.dev/entry/haptic_impact/",
      "nameEn": "Impact Haptic (Light / Medium / Heavy)",
      "nameJa": "衝撃の触覚（軽・中・重の「ブルッ」）",
      "aliases": [
        "Impact Feedback",
        "Light Impact",
        "Medium Impact",
        "Heavy Impact",
        "Bump"
      ],
      "platformNames": {
        "material3": "該当なし（M3 部品には規定なし）",
        "material2": "該当なし（M2 に無い）",
        "compose": "VibrationEffect.EFFECT_TICK / EFFECT_CLICK / EFFECT_HEAVY_CLICK",
        "hig": "Impact（Light / Medium / Heavy / Rigid / Soft）",
        "swiftUi": ".sensoryFeedback(.impact(weight:))",
        "web": "navigator.vibrate()（種類の区別なし）",
        "flutter": "HapticFeedback.lightImpact / mediumImpact / heavyImpact"
      },
      "summary": "「何かが当たった／はまった」感触。強さが 3 段階。",
      "description": "物理的な衝突を模した振動。light は軽いタップの反応、medium はボタン確定やトグル、heavy はドラッグのドロップや重要な確定に使う。「ブルッ」と言いたいときは大抵これの medium。",
      "whenToUse": "light：軽い ON/OFF・いいね／medium：長押し認識・確定・ドラッグ開始／heavy：ドロップ・大きな状態変化。",
      "tags": [
        "haptic",
        "impact",
        "light",
        "medium",
        "heavy",
        "触覚",
        "ブルッ",
        "振動"
      ],
      "related": [
        "haptic_selection",
        "haptic_notification",
        "long_press_haptic_navigate",
        "drag_reorder"
      ],
      "needsDevice": true,
      "flutterApi": "HapticFeedback.lightImpact / mediumImpact / heavyImpact",
      "prompt": {
        "ja": "ボタンを確定したときに HapticFeedback.mediumImpact() で端末を短く「ブルッ」と振動させて。軽い操作は lightImpact、ドロップ時は heavyImpact を使い分けて。",
        "en": "On confirm, call HapticFeedback.mediumImpact() for a short bump. Use lightImpact for minor toggles and heavyImpact for drops / major state changes."
      }
    },
    {
      "id": "haptic_notification",
      "kind": "action",
      "category": "haptics",
      "url": "https://uizukan.dev/entry/haptic_notification/",
      "nameEn": "Notification Haptic (Success / Warning / Error)",
      "nameJa": "結果通知の触覚（成功・警告・エラー）",
      "aliases": [
        "Success Haptic",
        "Error Haptic",
        "Notification Feedback",
        "Double Buzz"
      ],
      "platformNames": {
        "material3": "該当なし（M3 部品には規定なし）",
        "material2": "該当なし（M2 に無い）",
        "compose": "HapticFeedbackType.Confirm / Reject（View 系は HapticFeedbackConstants.CONFIRM / REJECT）",
        "hig": "Notification（Success / Warning / Error）",
        "swiftUi": ".sensoryFeedback(.success / .warning / .error)",
        "web": "navigator.vibrate()（種類の区別なし）",
        "flutter": "HapticFeedback（組み合わせ）/ haptic_feedback パッケージ"
      },
      "summary": "成功は「トントン」、エラーは「ブブブッ」。結果を振動で伝える。",
      "description": "iOS が用意している 3 種のパターン振動。成功は軽い 2 連、警告は中 2 連、エラーは強い 3 連。Flutter 標準にはないので、impact を複数回組み合わせて模倣するか、プラグイン（haptic_feedback など）を使う。",
      "whenToUse": "決済完了、送信成功、認証コード誤り、フォームの送信失敗。",
      "tags": [
        "haptic",
        "notification",
        "success",
        "error",
        "warning",
        "触覚",
        "成功",
        "エラー"
      ],
      "related": [
        "haptic_impact",
        "shake",
        "otp_field",
        "confetti"
      ],
      "needsDevice": true,
      "flutterApi": "HapticFeedback（組み合わせ）/ haptic_feedback パッケージ",
      "prompt": {
        "ja": "決済が成功したら iOS の Success 通知触覚（軽い 2 連の振動）、失敗したら Error 触覚（強い 3 連の振動）を鳴らして。Flutter 標準にないので HapticFeedback の impact を組み合わせて模倣して。",
        "en": "On successful payment play the iOS Success notification haptic (two light bumps); on failure play the Error haptic (three heavy bumps). Flutter has no built-in, so emulate them by sequencing HapticFeedback impacts."
      }
    },
    {
      "id": "haptic_on_toggle",
      "kind": "action",
      "category": "haptics",
      "url": "https://uizukan.dev/entry/haptic_on_toggle/",
      "nameEn": "Haptic on Toggle",
      "nameJa": "スイッチ切替時の触覚",
      "aliases": [
        "Switch Haptic",
        "Toggle Feedback"
      ],
      "platformNames": {
        "material3": "該当なし（M3 部品には規定なし）",
        "material2": "該当なし（M2 に無い）",
        "compose": "HapticFeedbackType.ToggleOn / ToggleOff",
        "hig": "該当なし（Toggle の慣習。Impact / Selection の組み合わせ）",
        "swiftUi": "Toggle（既定で触覚あり）",
        "web": "該当なし（navigator.vibrate() で自作）",
        "flutter": "Switch.onChanged + HapticFeedback.lightImpact()"
      },
      "summary": "スイッチを切り替えた瞬間に軽く「コトッ」と鳴る。",
      "description": "iOS 標準のスイッチは自動で鳴るが、Material の Switch は鳴らないので onChanged で明示する。ON と OFF で強さを変える実装もある。",
      "whenToUse": "設定画面のスイッチ全般。",
      "tags": [
        "haptic",
        "toggle",
        "switch",
        "触覚",
        "スイッチ"
      ],
      "related": [
        "switch_toggle",
        "haptic_impact"
      ],
      "needsDevice": true,
      "flutterApi": "Switch.onChanged + HapticFeedback.lightImpact()",
      "prompt": {
        "ja": "Material の Switch でも iOS のように切替時に軽い触覚が鳴るようにして。",
        "en": "Make the Material Switch fire a light haptic on toggle, like iOS does natively."
      }
    },
    {
      "id": "push_slide",
      "kind": "action",
      "category": "transitions",
      "url": "https://uizukan.dev/entry/push_slide/",
      "nameEn": "Push Transition",
      "nameJa": "プッシュ遷移（右からスライド）",
      "aliases": [
        "Slide Transition",
        "Push Navigation",
        "Horizontal Push",
        "Drill-down"
      ],
      "platformNames": {
        "material3": "Shared axis（X）/ Forward and backward",
        "material2": "Shared axis",
        "compose": "NavHost enterTransition = slideInHorizontally",
        "hig": "該当なし（Navigation bars の push。個別名は無い）",
        "swiftUi": "NavigationStack + NavigationLink",
        "web": "View Transitions API（cross-document）",
        "flutter": "CupertinoPageRoute / go_router + CupertinoPage"
      },
      "summary": "新しい画面が右から滑り込み、前の画面は少し左にずれて暗くなる。",
      "description": "階層を「深く進む」遷移。iOS では前の画面が 1/3 だけ左に動き、左端スワイプで戻れる。戻るときは逆再生。",
      "whenToUse": "一覧 → 詳細のように、階層を下る遷移。作成・編集は Full-screen Dialog（下から）。",
      "tags": [
        "transition",
        "push",
        "slide",
        "遷移",
        "右から",
        "ナビゲーション"
      ],
      "related": [
        "slide_up_modal",
        "hero_transition",
        "fade_through",
        "long_press_haptic_navigate"
      ],
      "needsDevice": false,
      "flutterApi": "CupertinoPageRoute / go_router + CupertinoPage",
      "prompt": {
        "ja": "一覧から詳細への遷移を、iOS 風に右からスライドする Push 遷移にして。左端からのスワイプで戻れるように。Android でも同じ動きで統一して。",
        "en": "Make list → detail an iOS-style Push transition sliding in from the right, with edge-swipe back. Use the same motion on Android for consistency."
      }
    },
    {
      "id": "slide_up_modal",
      "kind": "action",
      "category": "transitions",
      "url": "https://uizukan.dev/entry/slide_up_modal/",
      "nameEn": "Slide Up (Modal Presentation)",
      "nameJa": "下からせり上がる遷移（モーダル）",
      "aliases": [
        "Present Modally",
        "Bottom Slide",
        "Cover Vertical",
        "Sheet Presentation"
      ],
      "platformNames": {
        "material3": "Dialogs（Full-screen dialog の遷移）",
        "material2": "Dialogs（Full-screen dialog の遷移）",
        "compose": "NavHost enterTransition = slideInVertically",
        "hig": "Sheets（modal presentation）",
        "swiftUi": ".sheet / .fullScreenCover",
        "web": "<dialog> + CSS transition",
        "flutter": "MaterialPageRoute(fullscreenDialog: true) / CupertinoPageRoute(fullscreenDialog: true)"
      },
      "summary": "画面が下から上に出てくる。作成・編集など「別の作業」に入る合図。",
      "description": "横方向の push が「階層を進む」なのに対し、縦方向の slide up は「一時的な別作業」を意味する。iOS の pageSheet では背後の画面が少し縮んで奥に下がる。",
      "whenToUse": "新規作成、フィルタ、ログイン、設定変更などの一時タスク。",
      "tags": [
        "transition",
        "modal",
        "slide up",
        "下から",
        "モーダル",
        "シート"
      ],
      "related": [
        "full_screen_dialog",
        "modal_bottom_sheet",
        "push_slide",
        "drag_to_dismiss_sheet"
      ],
      "needsDevice": false,
      "flutterApi": "MaterialPageRoute(fullscreenDialog: true) / CupertinoPageRoute(fullscreenDialog: true)",
      "prompt": {
        "ja": "「新規作成」画面を下からせり上がるモーダルとして表示して。iOS では背後の画面が少し縮む pageSheet 風にして。",
        "en": "Present the \"Create\" screen as a modal sliding up from the bottom. On iOS mimic the pageSheet where the screen behind shrinks slightly."
      }
    },
    {
      "id": "fade_through",
      "kind": "action",
      "category": "transitions",
      "url": "https://uizukan.dev/entry/fade_through/",
      "nameEn": "Fade Through",
      "nameJa": "フェードスルー（タブ切替の遷移）",
      "aliases": [
        "Cross Fade",
        "Fade Transition",
        "Top-level Transition"
      ],
      "platformNames": {
        "material3": "Fade through / Top level",
        "material2": "Fade through",
        "compose": "AnimatedContent(fadeIn + scaleIn) / NavHost fadeIn",
        "hig": "該当なし（Cross-dissolve）",
        "swiftUi": ".transition(.opacity)",
        "web": "View Transitions API（既定の cross-fade）",
        "flutter": "animations: PageTransitionSwitcher + FadeThroughTransition"
      },
      "summary": "前の画面がフェードアウトし、次の画面が少し拡大しながらフェードイン。",
      "description": "階層関係のない画面同士（タブ切替など）の遷移。方向性を持たせないのが特徴。Material の animations パッケージに FadeThroughTransition がある。",
      "whenToUse": "Bottom Navigation のタブ切替、ステップ間の内容差し替え。",
      "tags": [
        "transition",
        "fade",
        "tab",
        "フェード",
        "タブ切替"
      ],
      "related": [
        "bottom_navigation_bar",
        "crossfade",
        "push_slide"
      ],
      "needsDevice": false,
      "flutterApi": "animations: PageTransitionSwitcher + FadeThroughTransition",
      "prompt": {
        "ja": "Bottom Navigation のタブを切り替えるときに、Material の Fade Through（前がフェードアウト、次が少し拡大しつつフェードイン）を使って。",
        "en": "When switching bottom navigation tabs, use Material Fade Through: the old page fades out and the new page fades in while scaling up slightly."
      }
    },
    {
      "id": "hero_transition",
      "kind": "action",
      "category": "transitions",
      "url": "https://uizukan.dev/entry/hero_transition/",
      "nameEn": "Hero Transition (Shared Element)",
      "nameJa": "ヒーロー遷移（共有要素アニメーション）",
      "aliases": [
        "Shared Element Transition",
        "Container Transform",
        "Zoom Transition",
        "matchedGeometryEffect"
      ],
      "platformNames": {
        "material3": "Container transform",
        "material2": "Container transform",
        "compose": "SharedTransitionLayout + Modifier.sharedElement",
        "hig": "該当なし（Zoom transition＝iOS 18）",
        "swiftUi": ".matchedGeometryEffect / .navigationTransition(.zoom)（iOS 18）",
        "web": "View Transitions API（view-transition-name）",
        "flutter": "Hero(tag:)"
      },
      "summary": "一覧のサムネイルが、そのまま詳細画面の大きな画像に「飛んで」拡大する。",
      "description": "2 つの画面に同じ tag を持つ要素があると、遷移中にその要素が位置・サイズを補間しながら移動する。画像・カードで使うと連続性が生まれる。",
      "whenToUse": "一覧 → 詳細で、画像やカードがそのまま主役になる遷移。",
      "tags": [
        "transition",
        "hero",
        "shared element",
        "ヒーロー",
        "共有要素",
        "拡大"
      ],
      "related": [
        "card",
        "grid",
        "push_slide",
        "pinch_zoom"
      ],
      "needsDevice": false,
      "flutterApi": "Hero(tag:)",
      "prompt": {
        "ja": "一覧のサムネイル画像をタップすると、その画像が詳細画面の上部に拡大しながら飛んでいく Hero（Shared Element）遷移にして。",
        "en": "When a thumbnail in the list is tapped, use a Hero (Shared Element) transition so the image flies and expands into the header of the detail screen."
      }
    },
    {
      "id": "page_view_swipe",
      "kind": "action",
      "category": "transitions",
      "url": "https://uizukan.dev/entry/page_view_swipe/",
      "nameEn": "Swipe Between Pages",
      "nameJa": "横スワイプでページ送り",
      "aliases": [
        "Paging",
        "Horizontal Paging",
        "Swipe Navigation",
        "Pager"
      ],
      "platformNames": {
        "material3": "Lateral（Tabs の swipe）",
        "material2": "Lateral navigation",
        "compose": "HorizontalPager",
        "hig": "Page controls（swipe between pages）",
        "swiftUi": "TabView + .tabViewStyle(.page)",
        "web": "CSS scroll-snap（Carousel）",
        "flutter": "PageView + PageController"
      },
      "summary": "指で横にスワイプすると、ページが 1 枚ずつ切り替わる。",
      "description": "ページ単位で吸着（snap）する横スクロール。オンボーディング、タブ内容、写真ビューアの基本。ドットや Tab と連動させる。",
      "whenToUse": "オンボーディング、ストーリー形式のコンテンツ、Tab の内容切替。",
      "tags": [
        "transition",
        "swipe",
        "page",
        "paging",
        "スワイプ",
        "ページ送り",
        "オンボーディング"
      ],
      "related": [
        "page_indicator",
        "carousel",
        "tab_bar",
        "snap_scrolling"
      ],
      "needsDevice": false,
      "flutterApi": "PageView + PageController",
      "prompt": {
        "ja": "オンボーディングを 3 ページの横スワイプ（PageView）にして。最後のページだけ「はじめる」ボタン、それ以外は「次へ」でプログラム的にページ送り。",
        "en": "Build onboarding as 3 horizontally swipeable pages (PageView). Show \"Get started\" only on the last page; otherwise a \"Next\" button that advances programmatically."
      }
    },
    {
      "id": "ripple",
      "kind": "action",
      "category": "motion",
      "url": "https://uizukan.dev/entry/ripple/",
      "nameEn": "Ripple (Ink Splash)",
      "nameJa": "リップル（波紋）",
      "aliases": [
        "Ink Splash",
        "Ink Ripple",
        "Touch Ripple",
        "Material Ripple"
      ],
      "platformNames": {
        "material3": "State layer（ripple は Android の実装名）",
        "material2": "Ripple（Touch feedback）",
        "compose": "Modifier.clickable の indication（ripple()）",
        "hig": "該当なし（Highlight のみ）",
        "swiftUi": "該当なし（ButtonStyle の isPressed で表現）",
        "web": "該当なし（CSS で自作）",
        "flutter": "InkWell / Ink"
      },
      "summary": "タップした位置から円形の波紋が広がる Material 特有の反応。",
      "description": "押した点を中心に半透明の円が広がり、面全体を薄く覆う。Material Design の「触れた」フィードバック。Ink 系 widget は Material の上でしか描けない点に注意。",
      "whenToUse": "Material 風アプリのタップ可能な面すべて。iOS 風にしたいなら使わない。",
      "tags": [
        "motion",
        "ripple",
        "ink",
        "splash",
        "リップル",
        "波紋",
        "タップ反応"
      ],
      "related": [
        "tap",
        "press_scale",
        "elevated_button",
        "cupertino_button"
      ],
      "needsDevice": false,
      "flutterApi": "InkWell / Ink",
      "prompt": {
        "ja": "このカードをタップしたとき、押した位置から Material のリップル（波紋）が広がるようにして。角丸の中にクリップして。",
        "en": "When this card is tapped, show a Material ripple expanding from the touch point, clipped to the rounded corners."
      }
    },
    {
      "id": "press_scale",
      "kind": "action",
      "category": "motion",
      "url": "https://uizukan.dev/entry/press_scale/",
      "nameEn": "Press Scale (Spring Bounce)",
      "nameJa": "押すと縮んで弾むボタン",
      "aliases": [
        "Tap Scale",
        "Squash and Stretch",
        "Bouncy Button",
        "Spring Animation",
        "Scale on Press"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "Modifier.scale + animateFloatAsState（InteractionSource）",
        "hig": "該当なし（慣習。Button の pressed 状態）",
        "swiftUi": ".scaleEffect + .animation / ButtonStyle（configuration.isPressed）",
        "web": "CSS :active + transform: scale()",
        "flutter": "AnimatedScale + GestureDetector(onTapDown / Up / Cancel)"
      },
      "summary": "押している間 0.95 倍に縮み、離すとバネのように弾んで戻る。",
      "description": "Material のリップルとは別系統の、iOS 寄りのタップ反応。押下中に縮み、離すと overshoot して戻る（easeOutBack）。「気持ちいい」ボタンの定番。",
      "whenToUse": "カード・大きなボタン・ゲーム風 UI。小さなアイコンには過剰。",
      "tags": [
        "motion",
        "scale",
        "spring",
        "bounce",
        "縮む",
        "弾む",
        "バネ",
        "タップ反応"
      ],
      "related": [
        "ripple",
        "tap",
        "like_burst",
        "cupertino_button"
      ],
      "needsDevice": false,
      "flutterApi": "AnimatedScale + GestureDetector(onTapDown / Up / Cancel)",
      "prompt": {
        "ja": "このボタンを、押している間は 0.95 倍に縮み、離すと少しオーバーシュートして弾んで戻る Press Scale アニメーションにして。リップルは無しで。",
        "en": "Give this button a Press Scale animation: shrink to 0.95 while pressed and spring back with a slight overshoot on release. No ripple."
      }
    },
    {
      "id": "shake",
      "kind": "action",
      "category": "motion",
      "url": "https://uizukan.dev/entry/shake/",
      "nameEn": "Shake (Error Wiggle)",
      "nameJa": "シェイク（エラー時の左右振動）",
      "aliases": [
        "Wiggle",
        "Error Shake",
        "Wrong Password Shake",
        "Horizontal Shake"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "Animatable + keyframes",
        "hig": "該当なし（慣習。パスコード誤入力の揺れ）",
        "swiftUi": ".keyframeAnimator / .offset + withAnimation",
        "web": "CSS @keyframes",
        "flutter": "AnimationController + Transform.translate（sin 波）"
      },
      "summary": "入力が間違っていると、欄が左右に小刻みに揺れて「ダメ」を伝える。",
      "description": "macOS のログイン画面で有名な、否定を表す左右の揺れ。±8dp 程度を 3〜4 往復、400ms 前後。エラー触覚と組み合わせると効果的。",
      "whenToUse": "パスワード・PIN の誤り、必須項目未入力での送信、無効な操作。",
      "tags": [
        "motion",
        "shake",
        "wiggle",
        "error",
        "シェイク",
        "揺れる",
        "エラー"
      ],
      "related": [
        "haptic_notification",
        "otp_field",
        "password_field"
      ],
      "needsDevice": false,
      "flutterApi": "AnimationController + Transform.translate（sin 波）",
      "prompt": {
        "ja": "パスワードが間違っていたら、入力欄が左右に小刻みに揺れる Shake アニメーション（±8dp、約 400ms）をして、同時にエラー触覚を鳴らして。",
        "en": "If the password is wrong, play a horizontal Shake animation on the field (±8dp, ~400ms) and fire the error haptic at the same time."
      }
    },
    {
      "id": "expand_collapse",
      "kind": "action",
      "category": "motion",
      "url": "https://uizukan.dev/entry/expand_collapse/",
      "nameEn": "Expand / Collapse",
      "nameJa": "展開・折りたたみアニメーション",
      "aliases": [
        "Animated Size",
        "Reveal",
        "Disclosure Animation",
        "Accordion Animation"
      ],
      "platformNames": {
        "material3": "該当なし（Motion に個別名は無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "AnimatedVisibility / Modifier.animateContentSize",
        "hig": "Disclosure controls",
        "swiftUi": "DisclosureGroup / withAnimation",
        "web": "<details> / CSS grid-template-rows の transition",
        "flutter": "AnimatedSize / AnimatedCrossFade"
      },
      "summary": "「もっと見る」で下に伸びて内容が現れ、もう一度で縮む。",
      "description": "サイズの変化を補間して、内容が滑らかに現れる／消える動き。矢印アイコンの回転を添えると状態が伝わる。",
      "whenToUse": "「もっと見る」、詳細設定の開閉、FAQ、フィルタパネル。",
      "tags": [
        "motion",
        "expand",
        "collapse",
        "reveal",
        "展開",
        "折りたたみ",
        "もっと見る"
      ],
      "related": [
        "expansion_tile",
        "crossfade"
      ],
      "needsDevice": false,
      "flutterApi": "AnimatedSize / AnimatedCrossFade",
      "prompt": {
        "ja": "説明文を 3 行で省略し、「もっと見る」をタップすると全文が下に滑らかに伸びて表示される Expand / Collapse にして。矢印も 180° 回転させて。",
        "en": "Truncate the description to 3 lines; tapping \"Read more\" smoothly expands to the full text. Rotate the chevron 180° as well."
      }
    },
    {
      "id": "crossfade",
      "kind": "action",
      "category": "motion",
      "url": "https://uizukan.dev/entry/crossfade/",
      "nameEn": "Cross-fade Switch",
      "nameJa": "クロスフェード切替",
      "aliases": [
        "Animated Switcher",
        "Fade Swap",
        "Content Transition"
      ],
      "platformNames": {
        "material3": "Fade（transition pattern）",
        "material2": "Fade（Motion system）",
        "compose": "Crossfade / AnimatedContent",
        "hig": "該当なし（Cross-dissolve）",
        "swiftUi": ".transition(.opacity)",
        "web": "CSS transition: opacity / View Transitions API",
        "flutter": "AnimatedSwitcher"
      },
      "summary": "ローディング → 内容、アイコン A → B のように、中身が溶けるように入れ替わる。",
      "description": "古い child がフェードアウトしつつ新しい child がフェードインする。key を変えることで「別物になった」と Flutter に伝える。",
      "whenToUse": "スケルトン→本文、ボタン内のラベル⇄スピナー、アイコンの状態変化。",
      "tags": [
        "motion",
        "fade",
        "switch",
        "crossfade",
        "クロスフェード",
        "切替"
      ],
      "related": [
        "skeleton",
        "loading_button",
        "fade_through",
        "expand_collapse"
      ],
      "needsDevice": false,
      "flutterApi": "AnimatedSwitcher",
      "prompt": {
        "ja": "読み込み中はスピナー、完了したら内容、を AnimatedSwitcher でクロスフェード（200ms）させて。パッと切り替わらないように。",
        "en": "Cross-fade (200ms) between the spinner while loading and the content when done using AnimatedSwitcher, instead of an abrupt swap."
      }
    },
    {
      "id": "animated_counter",
      "kind": "action",
      "category": "motion",
      "url": "https://uizukan.dev/entry/animated_counter/",
      "nameEn": "Animated Counter",
      "nameJa": "数字のカウントアップ",
      "aliases": [
        "Count Up",
        "Rolling Number",
        "Odometer",
        "Number Ticker"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "AnimatedContent + animateIntAsState",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": ".contentTransition(.numericText())",
        "web": "該当なし（requestAnimationFrame で自作）",
        "flutter": "TweenAnimationBuilder<int>"
      },
      "summary": "0 → 1,234 のように数字が増えていく、または桁がロールする。",
      "description": "数値を補間して表示する。単純なカウントアップと、各桁が縦にスロットのように回る「ローリング」がある。達成感・強調に使う。",
      "whenToUse": "合計金額、獲得ポイント、歩数、フォロワー数など、数字が主役の場面。",
      "tags": [
        "motion",
        "counter",
        "number",
        "count up",
        "カウントアップ",
        "数字",
        "ロール"
      ],
      "related": [
        "stat_tile",
        "confetti",
        "linear_progress"
      ],
      "needsDevice": false,
      "flutterApi": "TweenAnimationBuilder<int>",
      "prompt": {
        "ja": "獲得ポイントを表示するとき、0 から実際の値まで 800ms かけてカウントアップさせて（easeOut）。3 桁区切りで。",
        "en": "When showing earned points, count up from 0 to the actual value over 800ms with easeOut, formatted with thousands separators."
      }
    },
    {
      "id": "shimmer",
      "kind": "action",
      "category": "motion",
      "url": "https://uizukan.dev/entry/shimmer/",
      "nameEn": "Shimmer",
      "nameJa": "シマー（光が流れるローディング）",
      "aliases": [
        "Shimmer Effect",
        "Skeleton Animation",
        "Loading Glow",
        "Sweep Highlight"
      ],
      "platformNames": {
        "material3": "該当なし（Skeleton loaders として言及のみ）",
        "material2": "該当なし（M2 に無い）",
        "compose": "該当なし（Brush.linearGradient + rememberInfiniteTransition で自作）",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": "該当なし（.redacted + 自作のグラデーション）",
        "web": "CSS @keyframes（background-position）",
        "flutter": "ShaderMask + AnimationController / shimmer パッケージ"
      },
      "summary": "グレーの箱の上を、白い光が左から右へ繰り返し流れる。",
      "description": "スケルトンにかける斜めのグラデーションのループ。「読み込み中」を静止画より強く伝える。1.2〜1.5 秒周期。",
      "whenToUse": "Skeleton Screen の上。ボタンの上を流して「押して」と誘導する演出にも使う。",
      "tags": [
        "motion",
        "shimmer",
        "loading",
        "skeleton",
        "シマー",
        "光",
        "ローディング"
      ],
      "related": [
        "skeleton",
        "crossfade"
      ],
      "needsDevice": false,
      "flutterApi": "ShaderMask + AnimationController / shimmer パッケージ",
      "prompt": {
        "ja": "Skeleton の上に、左から右へ白い光が 1.5 秒周期で流れる Shimmer をかけて。",
        "en": "Overlay a Shimmer on the skeleton: a white highlight sweeping left to right on a 1.5s loop."
      }
    },
    {
      "id": "confetti",
      "kind": "action",
      "category": "motion",
      "url": "https://uizukan.dev/entry/confetti/",
      "nameEn": "Confetti (Celebration)",
      "nameJa": "紙吹雪（達成演出）",
      "aliases": [
        "Celebration Effect",
        "Particle Burst",
        "Success Animation",
        "Party Popper"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "該当なし（Canvas で自作）",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": "該当なし（Canvas / SpriteKit で自作）",
        "web": "該当なし（canvas-confetti 等）",
        "flutter": "confetti: ConfettiWidget + ConfettiController"
      },
      "summary": "目標達成や購入完了で、画面に紙吹雪が舞う。",
      "description": "色とりどりの紙片が噴き出して落ちる演出。Success 触覚・チェックマークのアニメーションと組み合わせる。1〜2 秒で終わらせる。",
      "whenToUse": "初回タスク完了、連続記録の達成、決済完了、レベルアップ。多用すると価値が下がる。",
      "tags": [
        "motion",
        "confetti",
        "celebration",
        "success",
        "紙吹雪",
        "達成",
        "お祝い"
      ],
      "related": [
        "haptic_notification",
        "animated_counter",
        "like_burst"
      ],
      "needsDevice": false,
      "flutterApi": "confetti: ConfettiWidget + ConfettiController",
      "prompt": {
        "ja": "目標を達成したら、画面上部中央から紙吹雪が 2 秒噴き出す Confetti 演出を出して。同時に Success 触覚を鳴らして。",
        "en": "When the goal is reached, burst Confetti from the top-center of the screen for 2 seconds and fire the success haptic."
      }
    },
    {
      "id": "like_burst",
      "kind": "action",
      "category": "motion",
      "url": "https://uizukan.dev/entry/like_burst/",
      "nameEn": "Like Burst (Heart Pop)",
      "nameJa": "いいねのポップ（ハートが弾ける）",
      "aliases": [
        "Heart Animation",
        "Like Animation",
        "Favorite Pop",
        "Twitter Heart"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "該当なし（Animatable + scale で自作）",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": ".symbolEffect(.bounce)（iOS 17）",
        "web": "CSS @keyframes",
        "flutter": "AnimatedScale + IconButton"
      },
      "summary": "ハートをタップすると、拡大→縮小しながら赤くなり、周りに小さな粒が飛ぶ。",
      "description": "Twitter / Instagram の「いいね」。scale 0→1.3→1.0 のバネ動作、色の変化、周囲の粒子（任意）を 400ms 程度で。",
      "whenToUse": "いいね・お気に入り・ブックマークなど、感情を伴う ON 操作。",
      "tags": [
        "motion",
        "like",
        "heart",
        "pop",
        "いいね",
        "ハート",
        "弾ける"
      ],
      "related": [
        "icon_button",
        "double_tap",
        "press_scale",
        "confetti"
      ],
      "needsDevice": false,
      "flutterApi": "AnimatedScale + IconButton",
      "prompt": {
        "ja": "いいねボタンをタップしたら、ハートが 1.3 倍に弾んでから戻りつつ赤くなる Like Burst アニメーションにして。軽い触覚付きで。",
        "en": "On tapping the like button, play a Like Burst: the heart springs to 1.3x then settles while turning red, with a light haptic."
      }
    },
    {
      "id": "snackbar_undo",
      "kind": "action",
      "category": "motion",
      "url": "https://uizukan.dev/entry/snackbar_undo/",
      "nameEn": "Undo Pattern",
      "nameJa": "「元に戻す」パターン",
      "aliases": [
        "Undo Snackbar",
        "Optimistic Delete",
        "Soft Delete with Undo"
      ],
      "platformNames": {
        "material3": "Snackbar（action: Undo）",
        "material2": "Snackbar（Undo action）",
        "compose": "SnackbarHostState.showSnackbar(actionLabel = \"Undo\")",
        "hig": "該当なし（Shake to undo / Undo ボタン）",
        "swiftUi": "該当なし（自作の toast + Undo）",
        "web": "該当なし（Toast with Undo。role=\"status\"）",
        "flutter": "ScaffoldMessenger + SnackBarAction + Timer"
      },
      "summary": "削除をすぐ画面に反映しつつ、数秒間だけ「元に戻す」で取り消せる。",
      "description": "確認ダイアログを出す代わりに、先に消して（楽観的更新）Snackbar で取り消しを提供する。数秒後に本当に削除する。",
      "whenToUse": "取り消しが容易な削除・アーカイブ。決済のような不可逆操作には使わない。",
      "tags": [
        "motion",
        "undo",
        "snackbar",
        "optimistic",
        "元に戻す",
        "削除",
        "取り消し"
      ],
      "related": [
        "snackbar",
        "swipe_to_dismiss",
        "alert_dialog"
      ],
      "needsDevice": false,
      "flutterApi": "ScaffoldMessenger + SnackBarAction + Timer",
      "prompt": {
        "ja": "削除は確認ダイアログを出さず、即座にリストから消して「削除しました／元に戻す」の Snackbar を 4 秒出す Undo パターンにして。元に戻すで同じ位置に復元。",
        "en": "Use the Undo pattern for delete: remove from the list immediately (no confirm dialog) and show a \"Deleted / Undo\" Snackbar for 4s; Undo restores it at the same index."
      }
    },
    {
      "id": "staggered_list",
      "kind": "action",
      "category": "motion",
      "url": "https://uizukan.dev/entry/staggered_list/",
      "nameEn": "Staggered Entrance",
      "nameJa": "順番に現れるリスト（スタッガー）",
      "aliases": [
        "Staggered Animation",
        "Cascade Animation",
        "List Entrance Animation",
        "Fade-in Slide-up"
      ],
      "platformNames": {
        "material3": "該当なし（Motion に個別名は無い）",
        "material2": "Motion（Stagger）",
        "compose": "AnimatedVisibility + delay",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": ".animation(.delay) / PhaseAnimator",
        "web": "CSS animation-delay",
        "flutter": "flutter_staggered_animations: AnimationLimiter + AnimationConfiguration.staggeredList"
      },
      "summary": "リストの行が、上から順に少しずつ遅れてフェードイン＋スライドインする。",
      "description": "各要素の開始を 50〜80ms ずつずらして、画面が「生きて」見えるようにする。初回表示だけに使い、スクロール中には使わない。",
      "whenToUse": "画面の初回表示、検索結果の表示、ダッシュボードのカード群。",
      "tags": [
        "motion",
        "staggered",
        "entrance",
        "cascade",
        "スタッガー",
        "順番",
        "フェードイン"
      ],
      "related": [
        "crossfade",
        "card",
        "chat_bubble"
      ],
      "needsDevice": false,
      "flutterApi": "flutter_staggered_animations: AnimationLimiter + AnimationConfiguration.staggeredList",
      "prompt": {
        "ja": "画面を開いたとき、リストの各行が上から順に 60ms ずつ遅れて、下から 20dp スライドしながらフェードインする Staggered Entrance にして。",
        "en": "On screen open, animate list rows in with a Staggered Entrance: each row fades in while sliding up 20dp, delayed 60ms after the previous one."
      }
    },
    {
      "id": "collapsing_toolbar",
      "kind": "action",
      "category": "scrolling",
      "url": "https://uizukan.dev/entry/collapsing_toolbar/",
      "nameEn": "Collapsing Toolbar",
      "nameJa": "縮むヘッダー（コラプシングツールバー）",
      "aliases": [
        "Collapsing App Bar",
        "Flexible Space",
        "Expandable Header",
        "Sliver App Bar"
      ],
      "platformNames": {
        "material3": "Top app bar（scroll behavior: exit until collapsed）",
        "material2": "Collapsing toolbar（CollapsingToolbarLayout）",
        "compose": "TopAppBarDefaults.exitUntilCollapsedScrollBehavior + LargeTopAppBar",
        "hig": "Navigation bars（Large title が縮む）",
        "swiftUi": ".navigationBarTitleDisplayMode(.large)（自動）",
        "web": "position: sticky + scroll-driven animations",
        "flutter": "CustomScrollView + SliverAppBar"
      },
      "summary": "大きな画像ヘッダーが、スクロールに合わせて縮んで通常の App Bar になる。",
      "description": "先頭に画像や大きなタイトルを置き、上スクロールで高さが減っていき、最終的に App Bar だけが残って固定される。引っ張ると画像が伸びる stretch も付けられる。",
      "whenToUse": "プロフィール、商品詳細、記事など、ヘッダー画像がある画面。",
      "tags": [
        "scrolling",
        "collapsing",
        "header",
        "sliver",
        "縮む",
        "ヘッダー",
        "パララックス"
      ],
      "related": [
        "large_title_app_bar",
        "parallax_header",
        "app_bar",
        "hero_transition"
      ],
      "needsDevice": false,
      "flutterApi": "CustomScrollView + SliverAppBar",
      "prompt": {
        "ja": "商品詳細の上に高さ 240 の画像ヘッダーを置き、スクロールすると縮んで App Bar に収まる Collapsing Toolbar にして。タイトルは縮んだときだけ表示。下に引っ張ると画像が伸びるように。",
        "en": "Put a 240dp image header above the product detail that collapses into the App Bar on scroll (Collapsing Toolbar). Show the title only when collapsed, and stretch the image on overscroll."
      }
    },
    {
      "id": "parallax_header",
      "kind": "action",
      "category": "scrolling",
      "url": "https://uizukan.dev/entry/parallax_header/",
      "nameEn": "Parallax Scrolling",
      "nameJa": "パララックス（視差スクロール）",
      "aliases": [
        "Parallax Effect",
        "Parallax Header",
        "Depth Scrolling"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "Modifier.graphicsLayer + scroll offset",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": "GeometryReader / .scrollTransition",
        "web": "background-attachment: fixed / scroll-driven animations",
        "flutter": "Flow + FlowDelegate / Transform.translate"
      },
      "summary": "背景画像が前景より遅く動いて、奥行きがあるように見える。",
      "description": "スクロール量の半分だけ背景をずらすなど、レイヤーごとに移動速度を変えて立体感を出す。ヘッダーやカード内画像で使う。",
      "whenToUse": "ヒーロー画像付きの記事、旅行・不動産などビジュアル重視の一覧。",
      "tags": [
        "scrolling",
        "parallax",
        "視差",
        "奥行き",
        "背景"
      ],
      "related": [
        "collapsing_toolbar",
        "card",
        "carousel"
      ],
      "needsDevice": false,
      "flutterApi": "Flow + FlowDelegate / Transform.translate",
      "prompt": {
        "ja": "リストの各カード内の画像を、スクロールに合わせて少し遅れて動く Parallax 効果にして（画像はカードの高さより大きくして、はみ出しをクリップ）。",
        "en": "Give each card image in the list a Parallax effect: the image moves slightly slower than the scroll (image taller than the card, overflow clipped)."
      }
    },
    {
      "id": "infinite_scroll",
      "kind": "action",
      "category": "scrolling",
      "url": "https://uizukan.dev/entry/infinite_scroll/",
      "nameEn": "Infinite Scroll (Pagination)",
      "nameJa": "無限スクロール（追加読み込み）",
      "aliases": [
        "Load More",
        "Endless Scroll",
        "Lazy Loading",
        "Paging"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "LazyColumn + LazyListState（末尾検知）/ Paging 3",
        "hig": "該当なし（iOS 標準には無い）",
        "swiftUi": "List + .onAppear（末尾で読み込み）",
        "web": "IntersectionObserver / Feed（WAI-ARIA パターン）",
        "flutter": "ListView.builder + ScrollController / infinite_scroll_pagination"
      },
      "summary": "一覧の末尾に近づくと、自動で次のページを読み込んで継ぎ足す。",
      "description": "スクロール位置が末尾から一定距離に入ったら次ページを取得し、末尾にローディング行を出す。重複取得の防止と「これ以上ない」の表示が必要。",
      "whenToUse": "SNS のフィード、検索結果、商品一覧など、件数が多い一覧。",
      "tags": [
        "scrolling",
        "infinite",
        "pagination",
        "load more",
        "無限スクロール",
        "追加読み込み"
      ],
      "related": [
        "pull_to_refresh",
        "skeleton",
        "circular_progress",
        "empty_state"
      ],
      "needsDevice": false,
      "flutterApi": "ListView.builder + ScrollController / infinite_scroll_pagination",
      "prompt": {
        "ja": "フィードを Infinite Scroll にして。末尾の 200px 手前で次ページを取得し、末尾にスピナー行を出す。読み込み中の二重取得を防ぎ、最後まで来たら「以上です」を表示。",
        "en": "Make the feed Infinite Scroll: fetch the next page when within 200px of the end, show a spinner row at the bottom, guard against duplicate fetches, and show \"That's all\" at the end."
      }
    },
    {
      "id": "scroll_to_hide_bar",
      "kind": "action",
      "category": "scrolling",
      "url": "https://uizukan.dev/entry/scroll_to_hide_bar/",
      "nameEn": "Hide on Scroll",
      "nameJa": "スクロールでバーを隠す",
      "aliases": [
        "Scroll-aware Bar",
        "Auto-hide Navigation",
        "Quick Return",
        "Floating App Bar"
      ],
      "platformNames": {
        "material3": "Top app bar（scroll behavior: enter always）",
        "material2": "Top app bar（scroll flags: scroll|enterAlways）",
        "compose": "TopAppBarDefaults.enterAlwaysScrollBehavior",
        "hig": "Navigation bars / Tab bars（hidesBarsOnSwipe）",
        "swiftUi": ".toolbarVisibility を scroll で切替",
        "web": "該当なし（scroll イベントで自作）",
        "flutter": "SliverAppBar(floating: true, snap: true) / userScrollDirection"
      },
      "summary": "下にスクロールすると上のバー（App Bar）と FAB が隠れ、少しでも上に戻すと現れる。下のタブは残す。",
      "description": "スクロール方向を監視し、下方向で隠し上方向で出す。読む場所が広がり、本文に集中できる。SNS のタイムライン・ニュースの記事・ブラウザのアドレスバーでよく見る。下のタブ（Bottom Navigation Bar）は、いつでも切り替えられるよう隠さないのが一般的。",
      "whenToUse": "長い記事、フィード、写真一覧など、読むことが主目的の画面。設定画面や短い画面では隠さない。",
      "tags": [
        "scrolling",
        "hide",
        "app bar",
        "fab",
        "隠す",
        "スクロール連動"
      ],
      "related": [
        "fab",
        "extended_fab",
        "app_bar",
        "bottom_navigation_bar"
      ],
      "needsDevice": false,
      "flutterApi": "SliverAppBar(floating: true, snap: true) / userScrollDirection",
      "prompt": {
        "ja": "フィード画面で、下にスクロールすると上の App Bar と FAB が隠れ、少しでも上にスクロールすると戻ってくる Hide on Scroll にして。App Bar は floating + snap、下のタブ（Bottom Navigation Bar）は隠さず固定のまま。",
        "en": "On the feed, hide the top App Bar and the FAB when scrolling down and bring them back as soon as the user scrolls up (Hide on Scroll). Make the App Bar floating + snap, and keep the Bottom Navigation Bar always visible."
      }
    },
    {
      "id": "overscroll_bounce",
      "kind": "action",
      "category": "scrolling",
      "url": "https://uizukan.dev/entry/overscroll_bounce/",
      "nameEn": "Overscroll Bounce (Rubber Band)",
      "nameJa": "バウンス（端で跳ね返る）",
      "aliases": [
        "Rubber Band Effect",
        "Bouncing Scroll",
        "Elastic Scroll",
        "Overscroll Glow (Android)"
      ],
      "platformNames": {
        "material3": "該当なし（Android は Stretch overscroll）",
        "material2": "該当なし（Edge glow）",
        "compose": "OverscrollEffect（stretch）",
        "hig": "Scroll views（bounce）",
        "swiftUi": "ScrollView（既定で bounce）/ .scrollBounceBehavior",
        "web": "overscroll-behavior",
        "flutter": "ScrollPhysics（BouncingScrollPhysics）"
      },
      "summary": "リストの端を越えて引っ張ると、ゴムのように伸びて跳ね返る iOS の挙動。",
      "description": "iOS はバウンス、Android は端で光る（glow）か伸びる（stretch）。Flutter は platform で自動切替するが、physics を指定して統一もできる。",
      "whenToUse": "iOS らしさを保ちたい一覧。Pull to Refresh（iOS 風）や stretch ヘッダーには必須。",
      "tags": [
        "scrolling",
        "bounce",
        "overscroll",
        "rubber band",
        "バウンス",
        "跳ね返る",
        "iOS"
      ],
      "related": [
        "pull_to_refresh",
        "collapsing_toolbar",
        "snap_scrolling"
      ],
      "needsDevice": false,
      "flutterApi": "ScrollPhysics（BouncingScrollPhysics）",
      "prompt": {
        "ja": "この一覧を Android でも iOS と同じバウンス（Rubber Band）挙動にして。端で光る Android の glow は出さないで。",
        "en": "Make this list bounce at the edges (Rubber Band) on Android too, exactly like iOS, instead of the Android overscroll glow."
      }
    },
    {
      "id": "snap_scrolling",
      "kind": "action",
      "category": "scrolling",
      "url": "https://uizukan.dev/entry/snap_scrolling/",
      "nameEn": "Snap Scrolling",
      "nameJa": "スナップ（要素に吸着するスクロール）",
      "aliases": [
        "Paging Scroll",
        "Snap to Item",
        "Scroll Snapping",
        "Magnetic Scroll"
      ],
      "platformNames": {
        "material3": "Carousel（snap）",
        "material2": "該当なし（M2 に無い）",
        "compose": "LazyRow + rememberSnapFlingBehavior / HorizontalPager",
        "hig": "Scroll views（paging）",
        "swiftUi": ".scrollTargetBehavior(.viewAligned / .paging)",
        "web": "CSS scroll-snap-type",
        "flutter": "PageView(viewportFraction:) / SnapScrollPhysics（自作）"
      },
      "summary": "指を離すと、いちばん近い要素の位置にピタッと止まる。",
      "description": "自由なスクロールではなく、要素の境界で必ず止まる。カルーセル、時間選択、カード送りで使う。PageView は 1 画面ずつ、ListWheelScrollView は行ごとに吸着。",
      "whenToUse": "カルーセル、横並びカード、ドラム式ピッカー、ストーリー UI。",
      "tags": [
        "scrolling",
        "snap",
        "paging",
        "吸着",
        "カルーセル",
        "ピタッ"
      ],
      "related": [
        "carousel",
        "page_view_swipe",
        "cupertino_picker",
        "page_indicator"
      ],
      "needsDevice": false,
      "flutterApi": "PageView(viewportFraction:) / SnapScrollPhysics（自作）",
      "prompt": {
        "ja": "横に並んだカード（幅 280、隙間 16）を、指を離すと最寄りのカードの左端に吸着する Snap Scrolling にして。",
        "en": "Make the horizontal row of cards (width 280, gap 16) snap so that on release it settles on the nearest card's left edge."
      }
    },
    {
      "id": "scroll_to_top",
      "kind": "action",
      "category": "scrolling",
      "url": "https://uizukan.dev/entry/scroll_to_top/",
      "nameEn": "Scroll to Top",
      "nameJa": "先頭へ戻る",
      "aliases": [
        "Back to Top",
        "Tap Status Bar to Scroll",
        "Tap Tab to Scroll Top"
      ],
      "platformNames": {
        "material3": "該当なし（M3 に無い）",
        "material2": "該当なし（M2 に無い）",
        "compose": "LazyListState.animateScrollToItem(0)",
        "hig": "該当なし（慣習。Status bar タップで先頭へ）",
        "swiftUi": "ScrollViewReader + proxy.scrollTo",
        "web": "window.scrollTo({ top: 0, behavior: \"smooth\" })",
        "flutter": "ScrollController.animateTo / PrimaryScrollController"
      },
      "summary": "ステータスバーやタブの再タップ、または「↑」ボタンで一番上に戻る。",
      "description": "iOS はステータスバーのタップで先頭へ戻るのが OS 標準（Flutter は PrimaryScrollController を使えば自動）。選択中タブの再タップで戻すのも定番。長い一覧では「↑」ボタンを出す。",
      "whenToUse": "長いフィード・一覧すべて。",
      "tags": [
        "scrolling",
        "top",
        "back to top",
        "先頭",
        "戻る",
        "ステータスバー"
      ],
      "related": [
        "bottom_navigation_bar",
        "fab",
        "infinite_scroll"
      ],
      "needsDevice": false,
      "flutterApi": "ScrollController.animateTo / PrimaryScrollController",
      "prompt": {
        "ja": "選択中のタブをもう一度タップしたら一覧の先頭へ滑らかにスクロールする Scroll to Top を付けて。iOS のステータスバーのタップでも戻れるように PrimaryScrollController を使って。",
        "en": "Tapping the already-selected tab should smoothly Scroll to Top of the list. Use PrimaryScrollController so tapping the iOS status bar also works."
      }
    }
  ],
  "scenes": [
    {
      "id": "login",
      "nameEn": "Login",
      "nameJa": "ログイン",
      "description": "メール＋パスワードのログイン画面。入力欄・パスワード表示切替・主要 CTA・補助リンク。",
      "entryIds": [
        "app_bar",
        "text_field_outlined",
        "password_field",
        "text_button",
        "loading_button",
        "outlined_button",
        "divider",
        "tap_outside_dismiss_keyboard",
        "shake"
      ]
    },
    {
      "id": "onboarding",
      "nameEn": "Onboarding",
      "nameJa": "オンボーディング",
      "description": "初回起動の 3 ページ紹介。横スワイプ・ドット・スキップ・はじめるボタン。",
      "entryIds": [
        "page_view_swipe",
        "page_indicator",
        "text_button",
        "filled_button",
        "snap_scrolling"
      ]
    },
    {
      "id": "feed",
      "nameEn": "Feed",
      "nameJa": "フィード",
      "description": "SNS のタイムライン。カード・アバター・いいね・引っ張って更新・下タブ・FAB。",
      "entryIds": [
        "app_bar",
        "card",
        "avatar",
        "icon_button",
        "popup_menu",
        "fab",
        "bottom_navigation_bar",
        "badge",
        "pull_to_refresh",
        "like_burst",
        "double_tap",
        "infinite_scroll"
      ]
    },
    {
      "id": "settings",
      "nameEn": "Settings",
      "nameJa": "設定",
      "description": "iOS 風の設定画面。ラージタイトル・リスト行・スイッチ・区切り線・セクション。",
      "entryIds": [
        "large_title_app_bar",
        "list_tile",
        "switch_toggle",
        "divider",
        "sticky_header",
        "expansion_tile",
        "alert_dialog",
        "haptic_on_toggle",
        "donut_chart",
        "chart_legend"
      ]
    },
    {
      "id": "product",
      "nameEn": "Product & Checkout",
      "nameJa": "商品と購入",
      "description": "EC の商品ページと購入。縮む画像ヘッダー・カルーセル・セール価格・星評価・カラー・サイズ・数量・レビュー・関連商品・下部固定 CTA・購入シート（配送先→支払い→確認→完了）。",
      "entryIds": [
        "collapsing_toolbar",
        "carousel",
        "page_indicator",
        "badge",
        "rating_bar",
        "chips",
        "stepper_input",
        "expansion_tile",
        "avatar",
        "card",
        "bottom_action_bar",
        "icon_button",
        "outlined_button",
        "snackbar",
        "filled_button",
        "modal_bottom_sheet",
        "stepper_progress",
        "radio_button",
        "haptic_notification",
        "confetti",
        "hero_transition"
      ]
    },
    {
      "id": "chat",
      "nameEn": "Chat",
      "nameJa": "チャット",
      "description": "メッセージ画面。吹き出し・アバター・入力バー・送信ボタン・長押しメニュー。",
      "entryIds": [
        "app_bar",
        "chat_bubble",
        "avatar",
        "text_field_filled",
        "icon_button",
        "context_menu",
        "staggered_list",
        "haptic_impact"
      ]
    },
    {
      "id": "search",
      "nameEn": "Search & Filter",
      "nameJa": "検索",
      "description": "検索バー・フィルタチップ・結果グリッド・フィルタ用ボトムシート・空状態・お気に入りのハート。チップと価格帯で実際に絞り込める。",
      "entryIds": [
        "search_bar",
        "chips",
        "segmented_button",
        "grid",
        "modal_bottom_sheet",
        "range_slider",
        "empty_state",
        "skeleton",
        "like_burst"
      ]
    },
    {
      "id": "tasks",
      "nameEn": "Tasks",
      "nameJa": "タスク一覧",
      "description": "ToDo アプリ。チェック・スワイプ削除・並べ替え・Undo・達成の紙吹雪。",
      "entryIds": [
        "checkbox",
        "swipe_to_dismiss",
        "swipe_actions",
        "drag_reorder",
        "snackbar_undo",
        "extended_fab",
        "confetti",
        "haptic_notification",
        "long_press_haptic_navigate",
        "animated_counter"
      ]
    },
    {
      "id": "paywall",
      "nameEn": "Paywall",
      "nameJa": "ペイウォール",
      "description": "有料プランの案内。全画面モーダル・プラン選択・特典リスト・購入ボタン・復元リンク。",
      "entryIds": [
        "full_screen_dialog",
        "slide_up_modal",
        "radio_button",
        "card",
        "filled_button",
        "text_button",
        "press_scale",
        "linear_progress"
      ]
    }
  ]
}