id: radio
label: Radio
family: family-b-selection
category: Form
intent: Select one option from a group
description: Radio button input
composable: true
capabilities: Disabled
required_parts: ["RadioGroup"]
optional_parts: []
tags: ["radio", "choice", "exclusive", "selection"]
keywords:
pain: Radio inputs desync checked state and accessibility attributes
promise: Selection state mapped directly to DOM and ARIA
why: |
RadioPrimitive maps SelectionState to checked and aria attributes. Disabled state is also enforced structurally. This guarantees consistent selection behavior.
rules: ["CR-001", "CR-004"]
use_cases: ["forms", "single choice inputs"]
related: ["select", "combobox", "radio_group", "color_picker", "slider"]
file: radio_ui.css
tokens: radio-*, size-*, radius-*, motion-*, state-*
foundation: size, radius, motion, interaction, shadow
states: ["selected", "focus", "disabled"]
island: radio_boundary.rs
pillar: select
badges: ["SSR Safe", "Hydration Safe", "Token Driven", "Deterministic API", "Zero Drift", "Island Architecture"]
before: |
// ❌ Typical
view! {
<input type="radio" checked />
}
after: |
// ✅ CanonRS
view! {
<Radio value="a" name="group" checked=true>"Option"</Radio>
}
boundary_type: init
ix_group: ~
block: []
blocks_primitives: [stack]