StellarUI

<stellar-radio-item>

Individual radio option surface for the upcoming `stellar-radio` controller.

Component

Example

Choice A Optional helper copy.

Copy

<stellar-radio-item
  checked
  value="choice-a"
>
  Choice A
  <span slot="description">Optional helper copy.
</span>
</stellar-radio-item>

Complete props, events, slots, and implementation notes for the shipped radio item.

Prop	Type	Default	Notes
`appearance`	`normal \| filled`	`normal`	Switches between the default radio row and the filled/filter-style option surface.
`size`	`xs \| sm \| md \| lg \| xl`	`md`	Scales the visual dot and copy size together.
`label`	`string`	`''`	Fallback label text when default slot content is not authored.
`description`	`string`	`''`	Fallback helper copy for the `description` slot.
`value`	`string`	`''`	Option value that the parent controller will read when selection is committed.
`checked`	`boolean`	`false`	Marks the option as selected.
`disabled`	`boolean`	`false`	Prevents selection and applies the disabled treatment.

Event	Source	Notes
custom events	none	`stellar-radio-item` is a passive option surface. The parent `stellar-radio` controller will own interaction events.

Slot	Notes
default	Main option label content. Overrides the `label` prop when present.
`label`	Explicit named label slot when the parent markup needs to separate default children from label text.
`description`	Optional helper copy below the label. Overrides the `description` prop when present.

`stellar-radio-item` is the option primitive that the upcoming `stellar-radio` controller will own.
It currently renders as a standalone radio option surface with `role="radio"`, checked state styling, and slot-based label/description copy.
`checked` and `disabled` can be driven directly today, but they are expected to be controller-managed once `stellar-radio` is shipped to the slotted-item boundary.
`data-tone` and `data-group-disabled` are intentionally external state channels used by the controller rather than public props on the item itself.
`appearance` switches between the default radio-row treatment and the filled/filter-style item surface already supshipped by the shared CSS.