Listbox
リストボックス
リストボックスは選択肢のカスタムリストです。どの選択肢がアクティブか、矢印キーでリストをどう移動するかを管理します。
実際の例
ディスパッチャーは、検索可能な180件の結果から1つのデポを選びます。矢印キーで選択肢を移動し、Enterキーで選択します。フィルタリング後でも、スクリーンリーダーは選択されたデポを通知します。短い固定リストには、組み込みの `<select>` を使用すべきです。
主な部分
- 01リストボックスコンテナ
- 02アクティブオプション
- 03選択状態
以下の場合に使用します
組み込みの `<select>` で検索、リッチな選択、または複数項目の選択ができない場合にのみカスタムリストボックスを作成します。
以下の場合は使用しないでください
オプションの中にボタン、リンク、または他の個別のコントロールを入れないでください。
コードで使用する名前
role=listbox + role=option + aria-selected + roving focus/aria-activedescendant 出荷前に
Give each field a label that code can read. Link hints and errors, and keep entered values. Check autofill, keyboard order, validation timing, submit states, failure recovery, zoom, and languages.
Outcome：Complete the task with リストボックス (Listbox)。 User context：ディスパッチャーは、検索可能な180件の結果から1つのデポを選びます。矢印キーで選択肢を移動し、Enterキーで選択します。フィルタリング後でも、スクリーンリーダーは選択されたデポを通知します。短い固定リストには、組み込みの `<select>` を使用すべきです。 Recommended pattern：リストボックス (Listbox)。 Why it fits：組み込みの `<select>` で検索、リッチな選択、または複数項目の選択ができない場合にのみカスタムリストボックスを作成します。 Do not use it when：オプションの中にボタン、リンク、または他の個別のコントロールを入れないでください。 Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary)：その情報源にとって公式です。他のプラットフォームやチームはその用語を別の方法で使用する場合があります。 Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
このリクエストを確認する
Review how リストボックス (Listbox) is used now. Definition: リストボックスは選択肢のカスタムリストです。どの選択肢がアクティブか、矢印キーでリストをどう移動するかを管理します。 Release checks: Give each field a label that code can read. Link hints and errors, and keep entered values. Check autofill, keyboard order, validation timing, submit states, failure recovery, zoom, and languages. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.