Airframe GitHub Storybook

ba-radio-card

An enhanced radio button component with a description area for additional context, intended for use within ba-radio-group

Figma

GitHub

Storybook

Must be used with ba-radio-group

This component should not be used on its own. Always use it within ba-radio-group to ensure correct spacing, layout, and enable validation messages when used with other radio options

ba-radio-group

Flight 1 details

Flight 2 details

Flight 3 details

<ba-radio-group
  legend="Pick an option"
  hint-text="Some hint text to help select the right option"
  name="name"
>
  <ba-radio-card label="Flight 1" value="flight1">
    <ba-content>
      <p>Flight 1 details</p>
    </ba-content>
  </ba-radio-card>
  <ba-radio-card label="Flight 2" value="flight2">
    <ba-content>
      <p>Flight 2 details</p>
    </ba-content>
  </ba-radio-card>
  <ba-radio-card label="Flight 3" value="flight3">
    <ba-content>
      <p>Flight 3 details</p>
    </ba-content>
  </ba-radio-card>
</ba-radio-group>

Always use the label attribute to give a meaningful label to the field.

Further reading:

Always add descriptive text in the body of ba-radio-card to provide users with the context needed for informed selections. This enhances clarity and supports accessibility by offering more information about each option

If you require a radio button without a description, use the ba-radio component instead.

Disabled form elements are not supported in BAgel because they create accessibility challenges, such as preventing keyboard navigation, confusing screen reader users, and reducing visual clarity for those with impairments

Further reading:

Property Attribute Description Type Default
label(required) label Text displayed next to the radio "" undefined
value(required) value The value of the radio string undefined
Slot Description Permitted elements
Unnamed slot Elements will render in the body of the component <ba‑content>, <ba‑grid>, <ba‑image>

ba-radio-card can be slotted into:

See ba-radio-group for usage examples.

Figma GitHub Storybook Version 3 release guide Release history BAgel helper QA process