Aller au contenu

Composant · Formulaire

RadioGroup

Stable

Choix exclusif parmi plusieurs options. Le name partagé garantit l'exclusivité radio ; valeur contrôlée unique et légende fieldset.

Exemples

Vertical (par défaut)

Livraison

Choisissez un mode unique.

Voir le code (Svelte)
<RadioGroup
  legend="Livraison"
  name="shipping"
  value="standard"
  helperText="Choisissez un mode unique."
  options={[{"label":"Standard (3–5 j)","value":"standard"},{"label":"Express (24 h)","value":"express"},{"label":"Retrait en point relais","value":"pickup"}]}
/>

orientation="horizontal"

Taille
Voir le code (Svelte)
<RadioGroup
  legend="Taille"
  name="size"
  orientation="horizontal"
  value="m"
  options={[{"label":"S","value":"s"},{"label":"M","value":"m"},{"label":"L","value":"l"}]}
/>

API

PropTypeDefault
legendstringrequis
namestringrequis
options{ label, value, disabled?, helperText? }[][]
valuestring–
onchange / onChange(value: string) => void–
orientation"vertical" | "horizontal""vertical"
helperTextstring–
disabledbooleanfalse

Rend un fieldset/legend natif. React expose onChange ; Svelte/Vue exposent onchange (ou @change).

Tokens utilisés

  • --st-semantic-text-primary
  • --st-spacing-1 … --st-spacing-12