← Components/primitives

RadioButton

RadioButton + RadioButtonGroup — primitives.

primitivesstablea11y: untested3/3 coverageEdit on GitHub ↗
primitives-radiobutton--defaultOpen all variants →

When to use

  • Single-of-many selection: 2-7 mutually exclusive options the user picks one of.
  • The full set of options is short and worth showing inline.

When not to use

  • More than 7 options → use `Select` (inline radios stop scaling visually past that).
  • Multi-of-many selection → use `Checkbox`.
  • Binary on/off → use `Toggle` or `Switch`.
  • Tab-style content switching → use `Tabs` or ContentSwitcher pattern.