Interface Core A1 · Official standard

Radio Group

A radio group shows several choices but lets a person select exactly one.

Try an example
You might call it radio buttonssingle choice

Try an example

Radio Group

A real example

For delivery, the choices are standard, express, or pickup, and only one can be active.

Main parts

  1. 01Visible label
  2. 02Interaction target
  3. 03Current state
  4. 04Keyboard behavior

Use it when

Use it when there are only a few choices and seeing them all helps people decide.

Do not use it when

Never use it for a long list or when choosing nothing is often allowed.

Name used in code

<fieldset><input type="radio">

Before you ship

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.

Request you can copy

Outcome: Use Radio Group to solve this user need without losing the current context. User context: For delivery, the choices are standard, express, or pickup, and only one can be active. Recommended pattern: Radio Group. Why it fits: Use it when there are only a few choices and seeing them all helps people decide. Do not use it when: Never use it for a long list or when choosing nothing is often allowed. 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): The standard covers only the listed scope. It does not choose the visual style, product decision, or Vibulary example. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.

Check this request

Review the current use of Radio Group. Definition: A radio group shows several choices but lets a person select exactly one. 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, report the evidence you found, gaps, severity, and the smallest safe fix.

A1
How official is this term?

Official standard

A named standard sets the rules described on this page.

The standard covers only the listed scope. It does not choose the visual style, product decision, or Vibulary example.

Scope
HTML and ARIA
Document status
living standard
Checked on
2026-07-30

Evidence sources & scope

Authority source + Term reference · WHATWG · living standard HTML Living Standard — Radio Button input state Radio Button input state Scope: Web platform; direct scope: Radio Button input state Role here: Direct term reference Source covers: canonical name, definition, semantics, implementation Authority source · WHATWG · living standard HTML Living Standard Scope: Web platform Role here: Authority within stated scope Source covers: canonical name, definition, semantics, implementation Authority source · W3C · recommendation Accessible Rich Internet Applications (WAI-ARIA) 1.2 Scope: Web accessibility semantics Role here: Authority within stated scope Source covers: canonical name, definition, semantics, implementation

Copy it yourself

The browser could not copy this. Select the request below and copy it yourself.