Diwa Design System

Radio Group

A group of radio inputs that lets users select exactly one option from a set.

When to use

  • When users must choose exactly one option from a set of mutually exclusive choices.
  • When there are 2-7 options that all need to be visible simultaneously.
  • When the options benefit from a visible label showing all available choices.

When not to use

  • Use diwa-select when there are many options (8+) or limited space.
  • Use diwa-checkbox when users can select multiple options.
  • Use diwa-segmented-control for compact, in-context mode switching.

Dos and don'ts

Do

  • Always provide a descriptive group label.
  • List options in a logical, consistent order.
  • Use short, unambiguous labels for each option.
  • Pre-select a sensible default when one exists.

Don't

  • Don't use a radio group for binary yes/no choices - prefer a checkbox or switch.
  • Don't mix enabled and disabled options without a clear reason.
  • Don't use more than 7 options - consider a select instead.