BridgeBeta
  • Brand
  • Digital Assets
    Foundations
    Icons
    Components
    Templates
  • Resources
    Design Tokens
    How-tos
    Best Practices
    Libraries
    Accessibility
    Products List
  • Support
    • Overview
    • Actions
      • Overview
      • Button
      • ContextMenu
      • Link
    • Controls
      • Overview
      • Checkbox
      • Tag
      • Toggle
    • Forms
      • Overview
      • DatePicker
      • FileUploader
      • Input
      • NumberInput
      • RadioButton
      • Search
      • Select
      • Slider
      • TextArea
      • TextInput
    • Hooks
      • useIsomorphicLayoutEffect
      • useMediaQuery
      • useSettings
    • Navigation
      • Overview
      • AnchorNavigation
      • BannerNavigation
      • Breadcrumb
      • Footer
      • InfoBar
      • MainNavigation
      • SecondaryNavigation
      • StepNavigation
      • SubNavigation
    • Overlay
      • Overview
      • Credits
      • Modal
      • ModalWrapper
      • Notification
      • Tooltip
    • Structure
      • Overview
      • Accordion
      • AuthLayout
      • Avatar
      • Callout
      • Card
      • ContentSwitcher
      • Empty
      • Hero
      • InlineLoading
      • Item
      • List
      • Loading
      • mdxComponents
      • Module
      • Pagination
      • ReadMore
      • Story
      • Table
      • Tabs
      • Text
      • Unit
      • User
      • WFPCoreProvider
      • Wrapper
Components
Forms

RadioButton

  • Design
  • Code
  • Props

RadioButtons allow the user to select one option from a set.

The RadioButton component represents a mutually exclusive option within a set, allowing users to select a single choice from a predefined list.

Figma image
Figma image

When to use

  • Mutually Exclusive Options: Implement RadioButton when users need to choose a single option from a set where only one selection is allowed.
  • Limited Choices: Use RadioButton for relatively small sets of options (e.g., fewer than 5) to maintain clarity and simplicity.
  • Single Selection: When users are required to make a single, distinct choice from a group of options.

When not to use

  • Large Sets of Options: Avoid RadioButton for extensive lists; consider alternative components like checkboxes or dropdown menus for improved usability.
  • Multi-Selection: If users need to choose more than one option simultaneously, opt for checkboxes instead.
  • Space Constraints: In situations with limited screen real estate, consider more compact components like dropdowns or toggle switches.

Alternative Components

  • Checkboxes When multiple selections are allowed.
  • Select For conserving space when dealing with a large set of options.
  • Toggle Switches When a binary choice (on/off) is more appropriate than a list of options.

Accessibility Guidelines

  • Keyboard Accessibility: Ensure users can navigate and select RadioButton using keyboard controls.
  • Focus Styles: Clearly indicate the focus state for users navigating through the options using the keyboard.
  • Aria Roles: Implement ARIA roles to enhance the accessibility of RadioButton for screen readers.
  • Labeling: Provide clear and descriptive labels for each RadioButton to aid users with visual impairments.
  • Colour contrast: Maintain sufficient colour contrast between the RadioButton and its surroundings to assist users with visual disabilities.

On this page

  • Alternative Components
  • Accessibility Guidelines

References

  • Storybook
Storybook
Figma library
Contact us
2025 © World Food Programme