Chip Group

Preview

Set the options property to a list of { value, label, tone? }. Exactly one chip is active, tracked by value.

<esa-chip-group label="Status filter" value="open"></esa-chip-group>

<script>
  document.querySelector('esa-chip-group').options = [
    { value: 'all', label: 'All', tone: 'neutral' },
    { value: 'open', label: 'Open', tone: 'brand' },
    { value: 'flagged', label: 'Flagged', tone: 'amber' },
  ];
</script>

Tones

Each option's tone sets the palette of its active state, mapped to Ecology semantic tokens. neutral is the default.

{ value: 'n',  label: 'Neutral',        tone: 'neutral' }
{ value: 'ns', label: 'Neutral strong', tone: 'neutral-strong' }
{ value: 't',  label: 'Brand',           tone: 'brand' }
{ value: 'a',  label: 'Amber',          tone: 'amber' }

Sizes

Chips follow the shared form size scale.

<esa-chip-group size="xs" ...></esa-chip-group>
<esa-chip-group size="sm" ...></esa-chip-group>
<esa-chip-group size="md" ...></esa-chip-group>
<esa-chip-group size="lg" ...></esa-chip-group>

API

Events

Accessibility

• The host carries role="radiogroup" labeled by label (aria-label).
• Each chip is a role="radio" with aria-checked; only the active chip is in the tab order (roving tabindex).
• Arrow keys move selection with wrap-around; Home and End jump to the ends; selection follows arrow focus per the WAI-ARIA radio pattern.
• Enter and Space select the focused chip.
• The change event is composed and bubbles, so it can be caught on the host or an ancestor.

Theming surface

Every public token this component reads, extracted from its source at build time. The Resolves to column walks each token's real lineage — component → semantic → primitive → raw value — so you can see exactly where re-pointing it lands. A spoke re-skins by overriding these in its theme-<slug>.css; component internals are never edited. No hook for what you need? File it with /request-lego.