Skip to content

Field ​

Field est une fabrique typée autour des contrôles de formulaire SIA UI. Il remplace FormField et réutilise les composants autonomes au lieu de reproduire leur logique.

tsx
<Field type="email" label="Adresse e-mail" helpText="Utilisée pour les notifications." required />

<Field type="switch" label="Compte actif" warning="Validation requise." />

Contrôles supportés ​

  • Input, CurrencyInput et Textarea;
  • Select, TreeSelect et les sélecteurs de date/heure;
  • Checkbox, Switch et RadioGroup;
  • tout contrôle acceptant id et les attributs aria-* standards.

États ​

PropUsage
helpTextAide persistante sous le contrôle
statusdefault, error, success ou warning
messageMessage associé au statut
errorRaccourci du statut erreur
warningRaccourci du statut avertissement
successRaccourci du statut succès
requiredAjoute l'indicateur et aria-required
optionalAffiche le libellé optionnel
orientationMise en page verticale ou horizontale

helpText reste affiché avec le message d'état. Leurs identifiants sont ajoutés à aria-describedby pour conserver tout le contexte auprès des lecteurs d'écran.

Migration ​

tsx
// Avant
<FormField label="Nom" description="Nom affiché" error={error}><Input /></FormField>

// Maintenant
<Field label="Nom" helpText="Nom affiché" error={error}><Input /></Field>

Le mode children reste disponible pour un contrôle personnalisé. L'entrée form-field reste temporairement disponible comme alias déprécié.

Publié sous licence MIT.