Formulaires mobiles
Lot expérimental implémenté. Les versions et commandes sont celles du guide React Native. La galerie Expo propose une feuille libre, un écran Connexion et un menu Formulaires avec assemblage manuel, parcours déclaratif, sélections et variantes. Les données restent locales ; aucune authentification ni création de compte réelle.
FormContainer et FormSection
FormContainer reçoit un FormAdapter<TValues>. useLocalForm est l’adaptateur fourni ; tout autre adaptateur respectant ce contrat peut être utilisé. Le conteneur ne duplique pas les règles de validation.
const form = useLocalForm({
defaultValues: { name: '', accepted: false },
validate: (values) => ({
name: values.name.trim() ? undefined : 'Indiquez votre nom.',
accepted: values.accepted ? undefined : 'Acceptez les conditions.',
}),
onSubmit: async (values) => { await saveProfile(values); },
});
const name = form.bind('name');
const accepted = form.bind('accepted');
<FormContainer form={form} title="Votre profil" submitLabel="Continuer">
{({ submit, disabled }) => <>
<FormSection title="Identité">
<Input label="Nom" value={name.value} onChangeText={name.onChange}
onBlur={name.onBlur} editable={!disabled}
{...(name.error ? { error: name.error } : {})}
onSubmitEditing={() => { void submit(); }} />
</FormSection>
<FormSection title="Conditions">
<Checkbox label="J’accepte les conditions" checked={accepted.value}
onCheckedChange={accepted.onChange} disabled={disabled}
{...(accepted.error ? { error: accepted.error } : {})} />
</FormSection>
</>}
</FormContainer>Les imports proviennent de @sia-ui/react-native et useLocalForm de @sia-ui/headless. saveProfile représente l’action de l’application.
Le conteneur fournit titre, description, résumé des erreurs après tentative, bouton d’envoi, annulation facultative et footer. Le verrou s’active avant la validation : même une validation asynchrone ne permet pas deux envois. La soumission clavier doit appeler le submit fourni aux enfants, comme le bouton, pour bénéficier du même verrou et de la gestion des exceptions. disabled du render prop permet de bloquer les champs pendant l’opération ; il n’est pas injecté automatiquement dans les enfants.
Une exception affiche locale.submitError ou submitErrorMessage. Les détails techniques ne sont pas affichés. Les erreurs de validation et de serveur par champ restent celles de l’adaptateur. Le résumé et chaque erreur utilisent explicitement la couleur sémantique rouge colors.danger et un rôle d’alerte ; les aides restent atténuées. Le conteneur manuel ne focalise pas automatiquement le premier champ invalide ; le composant déclaratif Form assure cette responsabilité.
Par défaut, le formulaire possède son ScrollView, l’évitement du clavier et le retrait de zone sûre inférieur. keyboardVerticalOffset permet de remplacer le décalage hérité du shell ; dans une modale, la compensation déjà assurée est reconnue automatiquement. Privilégier le défilement propre de FormContainer. Si scrollable={false} est utilisé, le propriétaire extérieur doit assurer la visibilité du champ et le clavier ; une ScrollView simple ne suffit pas. La démo manuelle utilise désormais le défilement propre du conteneur. FormSection groupe les champs avec titre et description sans créer un autre formulaire ni remonter les champs à chaque frappe.
Champs et contrats
| Composant | État et actions | Utilité |
|---|---|---|
| Checkbox | `checked: boolean | 'mixed', onCheckedChange, disabled` |
| Switch | checked, onCheckedChange, size, props Pressable | Activer une préférence avec une identité SIA commune aux plateformes. |
| RadioGroup | value, onValueChange, options, disabled | Choix exclusif visible ; options décrites et désactivables. |
| PasswordInput | Props Input, ref, showLabel et hideLabel | Visibilité réversible avec bouton intégré au champ, sans remonter le TextInput. |
| Select | value, onValueChange, onBlur, options | Choix dans une feuille, avec recherche et liste virtualisée. |
Ces champs sont contrôlés : leur parent applique les callbacks à son état. Ils acceptent label, description et error. Les boutons/options ont une hauteur d’au moins 48 unités. Le Switch utilise désormais une ligne Pressable d’au moins 48 unités : le libellé et le contrôle activent la même bascule, avec un seul élément accessible. Input expose endAdornment pour une action extérieure au texte, comme la visibilité du mot de passe. PasswordInput conserve secureTextEntry, le mode monoligne et cette action ; l’application choisit autoComplete et les réglages adaptés au mot de passe existant ou nouveau.
Switch : identité SIA
Le rendu du Switch est commun à Android, iOS et à l’aperçu web : piste arrondie, pouce contrasté avec ombre discrète, repère coché à l’activation et tiret à l’arrêt. Le rôle switch, son label et son état checked constituent le contrat accessible ; les repères de dessin sont décoratifs. L’état ne dépend donc pas uniquement de la couleur. Toute la ligne peut être activée, y compris le libellé, avec une hauteur tactile minimale de 48 unités quelle que soit la taille du dessin.
size accepte sm, md (défaut) et lg. Le dessin mesure respectivement 44×28, 52×32 et 60×36 unités. Le pouce se déplace avec la durée base et la courbe spring partagées ; l’appui produit une légère dilatation avec la durée instant. Le mouvement réduit supprime ces transitions. Une valeur initiale déjà cochée s’affiche directement à droite, sans simuler une activation au montage.
Le focus est visible autour de la piste. Les erreurs restent rouges ; la bordure de focus suit aussi ce rouge en cas d’erreur. disabled conserve l’état visible et bloque l’activation. Les couleurs clair/sombre viennent des tokens SIA ; les réglages trackColor, thumbColor et l’alias de fond éteint ios_backgroundColor restent disponibles. Vérifier le contraste si l’application les remplace.
Les interactions et style reposent sur PressableProps ; le style concerne maintenant la ligne tactile. L’événement natif onChange du contrôle système n’est plus exposé : utiliser onCheckedChange. onFocus, onBlur, onPressIn et onPressOut permettent de suivre les interactions. La bascule se fait par appui ou activation d’accessibilité ; le glissement latéral n’est pas implémenté. La galerie Expo présente les trois tailles et l’état désactivé.
Select et recherche intégrée
<Select label="Équipe" value={team} onValueChange={setTeam}
options={[
{ value: 'dev', label: 'Développement', description: 'Applications et services' },
{ value: 'design', label: 'Design' },
{ value: 'research', label: 'Recherche', disabled: true },
]} />La feuille contient un seul champ de recherche. Il filtre localement les labels, descriptions et keywords, sans tenir compte de la casse ou des accents. searchable={false} masque ce champ. loading, emptyLabel et searchLabel adaptent le retour utilisateur. Le choix conserve sa valeur pendant le filtrage. La fermeture réinitialise la recherche et déclenche onBlur. Désactiver un Select ouvert le ferme et sa réactivation ne le rouvre pas. Les options doivent avoir des valeurs uniques. La liste utilise FlatList, sans ScrollView imbriquée. La recherche distante annulable est maintenant disponible via fetcher(query, signal). Le chargement paginé distant reste prévu. Voir le lot déclaratif et clavier.
BottomSheet et mouvement
BottomSheet réutilise la couche Modal : open, onOpenChange, titre, description, contenu, footer, bouton Fermer, Retour Android, évitement du clavier et zones sûres. height vaut 75% par défaut. scrollable={false} laisse un enfant virtualisé posséder son défilement. Modal expose les primitives communes placement, sheetHeight, swipeToDismiss et scrollable.
Le geste commence sur la poignée, pas dans la liste ni les champs. Un déplacement vers le bas suffisant, ou un mouvement rapide, demande la fermeture ; un petit geste revient à sa position initiale. swipeToDismiss={false} retire la poignée. dismissible={false} retire aussi le bouton et refuse le Retour et le fond. Le parent doit appliquer onOpenChange pour fermer la feuille.
Les entrées/sorties et retours reprennent les tokens Animated et le mouvement réduit. Le suivi du doigt utilise PanResponder en JavaScript, sans nouvelle dépendance. Les positions intermédiaires sont désormais disponibles via snapPoints : voir le guide des composants mobiles. Le glissement sur tout le contenu et les gestes de navigation restent prévus.
Vérifications et suite
Les tests vérifient contrats, états désactivés, recherche accentuée, conservation de valeur, fermeture/réouverture, erreurs rouges en deux thèmes, validation, exceptions et double envoi. Les exports Metro Android/iOS/web vérifient la compilation. Les tests navigateur portent sur l’aperçu web.
Restant sur appareils pour ce nouveau lot : geste de poignée, concurrence avec le défilement, clavier et visibilité du mot de passe (curseur/clavier iOS compris), Retour, VoiceOver/TalkBack, grandes tailles de texte et fluidité. Les composants restent expérimentaux ; ce lot n’est pas présenté comme validé sur téléphone par les seuls tests ou exports.
Le lot déclaratif ajoute Form/Field, la liaison automatique, les champs spécialisés et la gestion du premier invalide. FormContainer reste le conteneur manuel : il ne peut pas deviner les références de ses enfants. Les feuilles peuvent maintenant s’agrandir à l’ouverture du clavier.
Compléments du 17 novembre 2026
Les champs avancés web sont maintenant reconnus par Field/Form. Voir les API, adaptateurs et exemples des compléments mobiles pour slider, rating, color, tags, reference, json, markdown, rich-text, hidden, et les nouveaux comportements de recherche, montant, téléphone et OTP.