Red Amber Green Radio Group
RedAmberGreenRadioGroup is a headless <fieldset role="radiogroup"> for choosing a red/amber/green (RAG) status, holding the RedAmberGreenRadioInput radios the consumer composes, with whatever labels and layout the consumer writes. It replaces the earlier red-amber-green-picker (removed 2026-11-15).
Status: experimental — new (2026-11-15), implemented and unit-tested in every headless library; not yet exercised in a composed flow.
Usage
<RedAmberGreenRadioGroup label="Project status">
<RedAmberGreenRadioInput
value="red"
label="Off track"
name="status"
/>
<RedAmberGreenRadioInput
value="amber"
label="At risk"
name="status"
checked
/>
<RedAmberGreenRadioInput
value="green"
label="On track"
name="status"
/>
</RedAmberGreenRadioGroup>
It renders:
<fieldset
class="red-amber-green-radio-group"
role="radiogroup"
aria-label="Project status"
>
<input
class="red-amber-green-radio-input"
type="radio"
aria-label="Off track"
name="status"
value="red"
data-value="red"
/>
…
</fieldset>
Props
label: string (required) -- accessible name for the group
children: slot (required) -- the RedAmberGreenRadioInput elements
...restProps: any additional HTML attributes spread onto the fieldset
Keyboard Interactions
- Tab: focus the checked radio, or the first if none is checked
- ArrowDown / ArrowRight: move to and check the next radio
- ArrowUp / ArrowLeft: move to and check the previous radio
- Space: check the focused radio
ARIA
role="radiogroup" on the <fieldset>, named by aria-label
- Each radio is named by its own
label, so a status or rating is never shown by colour alone (WCAG 1.4.1)
When to Use
- Use when the consumer wants to lay out, order or label the options themselves, for example with a visible
<label> beside each radio.
- Use inside a form, where the native radios submit the chosen value under one
name.
- Use when a form reset must restore the starting choice without any script.
- Use when the options need extra content between them, such as a description under each one.
When Not to Use
- Do not use when more than one option may be chosen -- use CheckboxGroup instead.
- Do not use for a read-only display -- use RedAmberGreenView instead.
- Do not use for a plain set of choices with no status or rating meaning -- use RadioGroup instead.
Headless
The RedAmberGreenRadioGroup headless component provides a <fieldset> with role="radiogroup" and aria-label. It relies on native radio behaviour for selection and the keyboard. The consumer provides all visual styling, including any colour coding.
Styles
The consumer provides all CSS styling. The component renders with a .red-amber-green-radio-group class for targeting; each radio carries .red-amber-green-radio-input and data-value. No default styles are included — this is a fully headless component.
Testing
- Verify the component renders a
<fieldset> element with class red-amber-green-radio-group and role="radiogroup"
- Verify the group is named by
aria-label
- Verify the consumer's radios render inside it
- Verify pass-through attributes are applied
Advice
- Designers: Give every option visible text as well as its colour or icon; colour alone fails people with colour vision deficiencies.
- Developers: Give every
RedAmberGreenRadioInput the same name, so the browser treats them as one group for the arrow keys and form submission.
Implementation Notes
- Renders a
<fieldset> with role="radiogroup" and aria-label
- The consumer supplies one
RedAmberGreenRadioInput per value (red, amber, green); the group renders no option text of its own
- Selection, the arrow keys, form submission and form reset are native radio behaviour, so the group keeps no state
- Spreads
restProps onto the fieldset, so disabled, id or data-* pass through
Related components
red-amber-green-radio-input — a radio input for one choice of a red/amber/green status <input type="radio">
red-amber-green-view — the read-only display
radio-group — the general radio group
References
Lily™ and Lily Design System™ are trademarks.
Canonical contract
Generated from this component's canonical metadata — the machine-checked source the implementations are held to.
Metadata
- Component: red-amber-green-radio-group
- PascalCase: RedAmberGreenRadioGroup
- Description: a fieldset radio group for selecting a red/amber/green status
- Status: experimental — new (2026-11-15), implemented and unit-tested in every headless library; not yet exercised in a composed flow
- HTML tag: <fieldset>
- CSS class: .red-amber-green-radio-group
- Interactive: no
ARIA
role="radiogroup" -- on the <fieldset>, identifies the group as a set of radio buttons aria-label={label} -- the group's accessible name
Keyboard
- Tab: focus the checked radio, or the first if none is checked
- ArrowDown / ArrowRight: move to and check the next radio
- ArrowUp / ArrowLeft: move to and check the previous radio
- Space: check the focused radio
Props
label: string (required) -- accessible name for the group, applied via aria-label children: slot (required) -- the RedAmberGreenRadioInput elements ...restProps: any additional HTML attributes spread onto the fieldset