Emoji Character Radio Group

EmojiCharacterRadioGroup is a headless <fieldset role="radiogroup"> for choosing an emoji character, holding the EmojiCharacterRadioInput radios the consumer composes, with whatever labels and layout the consumer writes. It replaces the earlier emoji-character-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.

Example

Show demo markup
<fieldset class="emoji-character-radio-group" role="radiogroup" aria-label="Your reaction"><label class="label" for="demo-emoji-g-0"><input class="emoji-character-radio-input" type="radio" id="demo-emoji-g-0" name="demo-reaction" aria-label="Grinning face" value="😀" data-value="😀" /> <span aria-hidden="true">😀</span> Grinning face</label><label class="label" for="demo-emoji-g-1"><input class="emoji-character-radio-input" type="radio" id="demo-emoji-g-1" name="demo-reaction" aria-label="Slightly smiling face" value="🙂" data-value="🙂" checked /> <span aria-hidden="true">🙂</span> Slightly smiling face</label><label class="label" for="demo-emoji-g-2"><input class="emoji-character-radio-input" type="radio" id="demo-emoji-g-2" name="demo-reaction" aria-label="Neutral face" value="😐" data-value="😐" /> <span aria-hidden="true">😐</span> Neutral face</label></fieldset>
Usage example
<script lang="ts">
  import EmojiCharacterRadioGroup from "./EmojiCharacterRadioGroup.svelte";
</script>

<EmojiCharacterRadioGroup label="Size">
  <label
    ><input
      type="radio"
      name="size"
      value="s"
    /> Small</label
  >
  <label
    ><input
      type="radio"
      name="size"
      value="m"
    /> Medium</label
  >
  <label
    ><input
      type="radio"
      name="size"
      value="l"
    /> Large</label
  >
</EmojiCharacterRadioGroup>
Show Svelte source
// In your Svelte component:
import EmojiCharacterRadioGroup from "lily-design-system-svelte-headless/components/EmojiCharacterRadioGroup/EmojiCharacterRadioGroup.svelte";

<EmojiCharacterRadioGroup>
  <!-- content -->
</EmojiCharacterRadioGroup>

Usage

<EmojiCharacterRadioGroup label="Your reaction">
  <EmojiCharacterRadioInput
    value="😀"
    label="Grinning face"
    name="reaction"
  />
  <EmojiCharacterRadioInput
    value="🙂"
    label="Slightly smiling face"
    name="reaction"
    checked
  />
  <EmojiCharacterRadioInput
    value="😐"
    label="Neutral face"
    name="reaction"
  />
</EmojiCharacterRadioGroup>

It renders:

<fieldset
  class="emoji-character-radio-group"
  role="radiogroup"
  aria-label="Your reaction"
>
  <input
    class="emoji-character-radio-input"
    type="radio"
    aria-label="Grinning face"
    name="reaction"
    value="😀"
    data-value="😀"
  />
  …
</fieldset>

Props

  • label: string (required) -- accessible name for the group
  • children: slot (required) -- the EmojiCharacterRadioInput 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 Emoji instead.
  • Do not use for a plain set of choices with no status or rating meaning -- use RadioGroup instead.

Headless

The EmojiCharacterRadioGroup 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 .emoji-character-radio-group class for targeting; each radio carries .emoji-character-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 emoji-character-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 EmojiCharacterRadioInput 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 EmojiCharacterRadioInput per value (any emoji character); 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

  • emoji-character-radio-input — a radio input for one choice of an emoji character <input type="radio">
  • emoji — 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: emoji-character-radio-group
  • PascalCase: EmojiCharacterRadioGroup
  • Description: a fieldset radio group for selecting an emoji character
  • 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: .emoji-character-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 EmojiCharacterRadioInput elements
  • ...restProps: any additional HTML attributes spread onto the fieldset

Markdown

This page as Markdown, for people and AI tools: emoji-character-radio-group.md