Red Orange Yellow Green Blue Radio Input
RedOrangeYellowGreenBlueRadioInput is a headless native <input type="radio"> for one choice of a five-level colour status, used inside a RedOrangeYellowGreenBlueRadioGroup. Because it is a real radio, the group gets native arrow keys, form submission and form reset.
Status: experimental — new (2026-11-15), implemented and unit-tested in every headless library; not yet exercised in a composed flow.
Usage
<RedOrangeYellowGreenBlueRadioGroup label="Risk level">
<RedOrangeYellowGreenBlueRadioInput
value="red"
label="Severe"
name="status"
/>
<RedOrangeYellowGreenBlueRadioInput
value="orange"
label="High"
name="status"
/>
<RedOrangeYellowGreenBlueRadioInput
value="yellow"
label="Moderate"
name="status"
checked
/>
</RedOrangeYellowGreenBlueRadioGroup>
Props
value: string (required) -- the status or rating this radio stands for (red, orange, yellow, green, blue), also exposed as data-value
label: string (required) -- accessible name via aria-label
name: string (default: undefined) -- radio group name
checked: boolean (default: false) -- whether this radio starts checked
disabled: boolean (default: false) -- whether this radio is disabled
...restProps: any additional HTML attributes spread onto the input
Keyboard Interactions
- Tab: focus the checked radio in the group, 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
aria-label={label} names the radio; the native radio role and checked state need no ARIA
- The label carries the option's words, so the choice is never colour or an icon alone (WCAG 1.4.1)
When to Use
- Use inside a
RedOrangeYellowGreenBlueRadioGroup, one radio per value.
- Use when a form must submit the chosen value without script.
- Use when consumer CSS should draw each option from
data-value.
When Not to Use
- Do not use alone for a yes/no choice -- a lone radio cannot be unchecked; use CheckboxInput instead.
- Do not use outside its group -- put every option in one RedOrangeYellowGreenBlueRadioGroup with a shared
name.
- Do not use for an option with no status or rating meaning -- use RadioInput instead.
Headless
The RedOrangeYellowGreenBlueRadioInput headless component renders a native radio with aria-label and data-value. The consumer provides all visual styling.
Styles
The consumer provides all CSS styling. The component renders with a .red-orange-yellow-green-blue-radio-input class for targeting; style each option with [data-value]. No default styles are included — this is a fully headless component.
Testing
- Verify the component renders an
<input type="radio"> with class red-orange-yellow-green-blue-radio-input
- Verify
aria-label, name, checked and disabled
- Verify
data-value matches the value
- Verify Tab reaches it and Space checks it
Advice
- Designers: Pair every colour or icon with words; colour alone is not enough.
- Developers: Give every radio in the group the same
name, and a visible <label> where the layout allows one.
Implementation Notes
- Renders a native
<input type="radio"> with aria-label
- Sets
data-value to its value, so consumer CSS can colour or draw each option (.red-orange-yellow-green-blue-radio-input[data-value="red"])
- No two-way binding: the checked state is the browser's, and
checked sets where it starts
Related components
red-orange-yellow-green-blue-radio-group — a fieldset radio group for selecting a five-level color status
red-orange-yellow-green-blue-view — the read-only display
radio-input — the general radio input
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-orange-yellow-green-blue-radio-input
- PascalCase: RedOrangeYellowGreenBlueRadioInput
- Description: a radio input for one choice of a five-level color status <input type="radio">
- Status: experimental — new (2026-11-15), implemented and unit-tested in every headless library; not yet exercised in a composed flow
- HTML tag: <input>
- CSS class: .red-orange-yellow-green-blue-radio-input
- Interactive: no
ARIA
aria-label={label} -- the radio's accessible name, the option's words, so meaning is never colour alone
Keyboard
- **Tab**: Moves focus to the checked radio in the group (or the first if none is checked)
- **Arrow Up / Arrow Left**: Moves to and checks the previous radio in the group
- **Arrow Down / Arrow Right**: Moves to and checks the next radio in the group
- **Space**: Checks the focused radio
Props
value: string (required) -- the status or rating this radio stands for (red, orange, yellow, green, blue), also exposed as data-value label: string (required) -- accessible name via aria-label name: string (default: undefined) -- radio group name checked: boolean (default: false) -- whether this radio starts checked disabled: boolean (default: false) -- whether this radio is disabled ...restProps: any additional HTML attributes spread onto the input