Toggle Group
トグルグループ
オンかオフにできるボタンの、ラベルの付いたグループです。一つ、あるいは複数の選択肢を押したままにできます。
実際の例
テキストエディターでは、「太字」と「斜体」を同時にオンにできます。それぞれのボタンが押されているかどうかを伝えます。
主な部分
- 01可視ラベル
- 02Interaction target
- 03Current state
- 04Keyboard behavior
以下の場合に使用します
少数の小さく、元に戻せるモードで、現在の状態を表示する必要がある場合にこれを使用してください。
以下の場合は使用しないでください
選択肢が1つだけ提出できる場合はラジオボタンを使用してください。通常のフォーム選択肢にはチェックボックスを使用してください。
コードで使用する名前
button[aria-pressed] in a labeled group 出荷前に
Give assistive tools the control’s name (accessible name), purpose (role), value, and state. Check keyboard use, visible focus, target size, disabled and busy states, feedback, and recovery.
Outcome：Complete the task with トグルグループ (Toggle Group)。 User context：テキストエディターでは、「太字」と「斜体」を同時にオンにできます。それぞれのボタンが押されているかどうかを伝えます。 Recommended pattern：トグルグループ (Toggle Group)。 Why it fits：少数の小さく、元に戻せるモードで、現在の状態を表示する必要がある場合にこれを使用してください。 Do not use it when：選択肢が1つだけ提出できる場合はラジオボタンを使用してください。通常のフォーム選択肢にはチェックボックスを使用してください。 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 トグルグループ (Toggle Group) is used now. Definition: オンかオフにできるボタンの、ラベルの付いたグループです。一つ、あるいは複数の選択肢を押したままにできます。 Release checks: Give assistive tools the control’s name (accessible name), purpose (role), value, and state. Check keyboard use, visible focus, target size, disabled and busy states, feedback, and recovery. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.