Emoji Character Radio Input

EmojiCharacterRadioInput is a headless native <input type="radio"> for one choice of an emoji character, used inside a EmojiCharacterRadioGroup. 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.

Example

Show demo markup
<label class="label" for="demo-emoji-i-0"><input class="emoji-character-radio-input" type="radio" id="demo-emoji-i-0" name="demo-reaction" aria-label="Slightly smiling face" value="🙂" data-value="🙂" checked /> <span aria-hidden="true">🙂</span> Slightly smiling face</label>
Usage example
<script lang="ts">
  import EmojiCharacterRadioInput from "./EmojiCharacterRadioInput.svelte";
</script>

<EmojiCharacterRadioInput
  label="Option A"
  name="choice"
  value="a"
/>
Show Svelte source
// In your Svelte component:
import EmojiCharacterRadioInput from "lily-design-system-svelte-headless/components/EmojiCharacterRadioInput/EmojiCharacterRadioInput.svelte";

<EmojiCharacterRadioInput>
  <!-- content -->
</EmojiCharacterRadioInput>

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>

Props

  • value: string (required) -- the status or rating this radio stands for (any emoji character), 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 EmojiCharacterRadioGroup, 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 EmojiCharacterRadioGroup with a shared name.
  • Do not use for an option with no status or rating meaning -- use RadioInput instead.

Headless

The EmojiCharacterRadioInput 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 .emoji-character-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 emoji-character-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 (.emoji-character-radio-input[data-value="😀"])
  • No two-way binding: the checked state is the browser's, and checked sets where it starts

Related components

  • emoji-character-radio-group — a fieldset radio group for selecting an emoji character
  • emoji — 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: emoji-character-radio-input
  • PascalCase: EmojiCharacterRadioInput
  • Description: a radio input for one choice of an emoji character <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: .emoji-character-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 (any emoji character), 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

Markdown

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