Skip to content

Composants mobiles : présentation et organisation d’écran ​

Implémenté, expérimental. Ce lot ajoute des briques natives de présentation, des états visuels, des étapes, des onglets de contenu, un accordéon et un hôte de notifications relié au store partagé. Il enrichit BottomSheet avec des positions par poignée ; il ne livre pas un moteur de gestes sur tout le contenu.

Réutilisation des fondations ​

Aucun import de rendu web et aucune nouvelle dépendance native ne sont ajoutés. Les nouveaux comportements s’appuient sur React Native Animated et PanResponder. La réduction des animations reste prioritaire sur les transitions SIA ; les indicateurs système utilisent leur rendu natif.

Présentation et états visuels ​

APIUsage et contrat disponible
BadgeTons sémantiques, variantes soft/solid/outline et tailles sm/md.
AvatarImage native, repli par initiales ou contenu personnalisé après échec, nom accessible et taille.
AlertTitre, contenu, ton, action et fermeture contrôlée. Le message est annoncé séparément des boutons pour les garder accessibles.
SpinnerDessins SIA ring/double-ring/dots, cinq tailles xs–xl, tons du web, current et libellé accessible ; statique en mouvement réduit.
SkeletonBloc décoratif avec dimensions et rayon ; pulsation facultative, statique si mouvement réduit. Ne remplace pas un libellé de chargement accessible.
ProgressRemplissage animé entre valeurs bornées, état indéterminé si value est absent, libellé obligatoire et pourcentage facultatif. Le mouvement indéterminé est statique en mouvement réduit.
DividerSéparation horizontale/verticale ; la dimension disponible reste déterminée par le parent.
IconButtonNom accessible obligatoire et icône ; réutilise Button, ses états occupés/désactivés et sa cible tactile.
CardHeader, CardBody, CardFooterParties composables d’une Card ; les props title/description existantes restent compatibles.
TextVariantes existantes body/title/caption, plus display/heading/subtitle/code. Le rôle de titre doit être fourni lorsque pertinent ; ceci ne porte pas toute la typographie web.
tsx
<Card>
  <CardHeader><Text variant="heading" accessibilityRole="header">Import</Text></CardHeader>
  <CardBody>
    <Badge tone="info">En cours</Badge>
    <Progress label="Fichiers importés" value={4} max={10} showValue />
  </CardBody>
  <CardFooter><Button onPress={cancel}>Annuler</Button></CardFooter>
</Card>

Les valeurs max non positives ou non finies et les valeurs non finies de Progress sont refusées. Une valeur finie hors intervalle est bornée. Les propriétés de style et d’accessibilité natives restent disponibles sur les wrappers.

Valeurs par défaut locales ​

Les clés button, badge, spinner, alert, avatar, skeleton, progress, steps, tabs et accordion sont lues par les composants concernés :

tsx
<SiaNativeProvider defaults={{
  badge: { variant: "outline" },
  steps: { orientation: "vertical" },
  accordion: { variant: "separated" },
}}>
  <Badge tone="success">Disponible</Badge>
</SiaNativeProvider>

Une prop explicite prime sur le défaut local ; undefined conserve le défaut. Les providers imbriqués composent les clés existantes. Restant : généraliser cette consommation aux autres composants natifs ; le simple passage de defaults au provider ne signifie pas que chaque composant le lit déjà.

Steps : progression ordonnée ​

Steps reçoit items, current, orientation, size et onStepPress. Chaque item comporte une clé, un titre, une description, une icône, un état explicite facultatif et un état désactivé. Les états sont done, current, upcoming, error ; sans état explicite, ils sont dérivés de l’index courant.

Les connecteurs se remplissent ou se vident progressivement, le repère courant change d’échelle et l’icône de statut apparaît en fondu. La disposition verticale utilise un connecteur vertical. statusLabels permet de traduire les valeurs d’état annoncées. Les titres restent fournis par l’application. La validation, le droit d’aller plus loin et le passage à l’étape suivante restent dans le formulaire : cliquer une étape n’enregistre rien automatiquement. La démo refuse l’étape suivante si le nom est vide et n’autorise le retour qu’aux étapes déjà atteintes.

Tabs : vues de même rang ​

tsx
<Tabs defaultValue="profile">
  <TabsList label="Fiche client">
    <TabsTrigger value="profile">Profil</TabsTrigger>
    <TabsTrigger value="notes">Notes</TabsTrigger>
  </TabsList>
  <TabsContent value="profile"><Input label="Nom" /></TabsContent>
  <TabsContent value="notes"><Text>Notes du dossier</Text></TabsContent>
</Tabs>

value / onValueChange offrent un mode contrôlé ; defaultValue initialise le mode local. TabsList peut défiler horizontalement avec scrollable. Un onglet désactivé ne change pas la valeur. Le fond actif apparaît avec les tokens SIA ; le panneau sélectionné apparaît en fondu et glissement court par défaut, sans remonter les champs. Les panneaux restent montés et sont masqués lorsqu’ils sont inactifs, afin de conserver les saisies. keepMounted={false} sur un panneau permet son démontage.

Ce composant ne change pas l’adresse et ne remplace pas BottomBar. L’appui tactile et Espace sont pris en charge ; la navigation complète par flèches/Home/End du web reste à compléter pour les claviers externes. Les correspondances entre noms et panneaux doivent être vérifiées avec VoiceOver/TalkBack.

Accordion : sections conservées ​

Accordion reprend useAccordionState : modes single/multiple, valeurs contrôlées ou initiales, callback, sections désactivées et collapsible. Les variantes sont bordered/separated/plain. Les items reçoivent titre, description, contenu, icône et métadonnées facultatives.

Les enfants restent montés après repli. Le panneau fermé est retiré du parcours accessible ; sa mesure sert à animer la hauteur. Cette animation utilise le pilote JavaScript, car elle change la mise en page ; elle devient immédiate en mouvement réduit. animationDuration règle sa durée. Les contenus dynamiques, le clavier et les très longues sections restent à éprouver sur appareil.

Notifications partagées ​

Monter un Toaster par store dans un conteneur plein écran, au-dessus des pages :

tsx
<View style={{ flex: 1 }}>
  <Application />
  <Toaster placement="top-center" limit={3} />
</View>

toast, toast.success, toast.error, toast.loading, toast.update, toast.dismiss et toast.promise réutilisent l’API headless existante. Les annonces sont mises à jour dans la même carte, sans seconde pile métier. Les actions, annulations, fermetures, contenu personnalisé et six placements sont rendus. store, limit, duration, offset et width configurent l’hôte.

Le délai utilise la même gestion native que Toast : pause en arrière-plan et avec lecteur d’écran. Une durée nulle ou infinie conserve l’annonce. La sortie retire ensuite l’enregistrement du store. Un hôte monté dans l’écran principal reste derrière une fenêtre Modal native ; cela ne promet pas une surcouche système. Ne pas monter plusieurs hôtes pour le même store dans des fenêtres différentes : ils partageraient aussi les délais et les suppressions.

Le Toast contrôlé existant reste disponible pour un retour local à une page.

BottomSheet : positions supplémentaires ​

La présentation bord à bord, la poignée haute et les nouvelles options de mouvement sont décrites dans le guide BottomSheet.

tsx
const positions = ["45%", "70%", "95%"] as const;
const [index, setIndex] = useState(1);
<BottomSheet open={open} onOpenChange={setOpen} title="Sélection"
  snapPoints={positions} index={index} onIndexChange={setIndex}
  animationDuration={220} scrollable={false}>
  <FlatList {...listProps} />
</BottomSheet>

Sans snapPoints, height conserve son fonctionnement existant. Avec snapPoints, les nombres sont des unités natives et les pourcentages se rapportent à la hauteur disponible du conteneur après retraits des zones sûres et marges. La mesure suit la taille du conteneur d’évitement du clavier lorsque la plateforme la met à jour. Fournir une liste non vide, positive et croissante après conversion ; les hauteurs sont bornées à l’espace disponible. Une rotation peut changer la conversion des pourcentages.

index est contrôlé ; defaultIndex initialise le mode local. La poignée permet un glissement vers le haut/bas, une projection de vélocité et l’arrêt à la position la plus proche. Descendre suffisamment sous la première position demande une fermeture si elle est autorisée. Le parent doit appliquer les callbacks. Les actions d’accessibilité increment/decrement changent aussi la position ; une feuille non fermable peut ainsi être redimensionnée.

Le geste commence sur la poignée, dès le contact : la FlatList et les champs gardent leurs interactions. La poignée conserve le geste au lieu de le céder à un parent natif. Sa barre décorative ne reçoit pas les événements et le navigateur ne transforme pas le glissement en défilement de page. Le mouvement part de la hauteur réellement affichée au contact et reste sous le doigt pendant les mises à jour du parent ; l’arrêt s’applique après relâchement. Le changement de hauteur utilise le pilote JavaScript. L’évitement du clavier et le Retour réutilisent Modal. Prévu : arbitrage du glissement sur tout le contenu, stratégie dédiée au clavier et à la restauration de position, tests de fluidité et de gestes natifs approfondis. Aucun moteur Reanimated ou Gesture Handler n’est introduit dans ce lot.

  • Accueil : premiers exemples et identité visuelle.
  • Composants : catalogue puis pages États et présentation, Étapes/onglets/sections, Feuilles et gestes.
  • Formulaires : saisie et validation.
  • Session et accès : compte et administration filtrée par droits.
  • Réglages : personnalisation persistée ; le bouton de personnalisation reste accessible depuis chaque page.
  • Aide et récupération : guide et exemple d’erreur.

La barre basse épingle Accueil, Composants et Saisie ; Plus ouvre l’arbre complet. primaryKeys de BottomBar permet ce choix sans contourner le filtrage des droits. Une destination épinglée reste sélectionnée sur ses sous-pages lorsque leurs adresses partagent son préfixe de chemin (hors racine) ; la correspondance la plus précise gagne. La sidebar regroupe les pages par famille et ouvre la branche active. Les pages de composants offrent un retour explicite au catalogue.

Les tests contrôlent les contrats, états, désactivations, conservation des saisies, notifications et positions. Les exports ne remplacent pas la validation sur appareil. Voir aussi la matrice de couverture.

Transitions de progression, étapes et panneaux ​

Progress, Steps et Tabs acceptent animation: NativeTransitionOptions : duration en millisecondes, easing parmi les courbes SIA et disabled. Les props explicites priment sur les clés progress/steps/tabs du provider. Le mouvement réduit reste prioritaire ; les valeurs et états accessibles suivent immédiatement la valeur demandée, indépendamment de l’animation décorative.

tsx
<Progress label="Import" value={value} animation={{ duration: 500, easing: "standard" }} />
<Steps items={items} current={step} animation={{ duration: 360 }} />
<Tabs defaultValue="profile" animation={{ duration: 300 }} transition="slide">
  {/* TabsList, TabsTrigger et TabsContent */}
</Tabs>

Une mise à jour rapide de Progress interrompt la transition et repart de la position affichée, sans réinitialiser à zéro. Sa première valeur est affichée directement ; les changements ultérieurs sont animés. Pour Steps, la sélection et le remplissage sont animés, mais la validation reste externe.

Tabs.transition accepte slide (fondu/glissement), fade (fondu) ou none (panneau immédiat). animation.disabled désactive aussi le mouvement du déclencheur. Les panneaux masqués restent montés par défaut : l’animation ne réinitialise pas leurs saisies. La transition d’entrée ne prétend pas être un fondu croisé de deux panneaux de hauteurs différentes.

Les transformations et opacités utilisent le pilote natif ; le remplissage des largeurs/hauteurs utilise le pilote JavaScript. Ces valeurs vivent sur des vues Animated distinctes pour ne pas soumettre des dimensions animées au pilote natif.

Dans Personnaliser → Animations de navigation et de contenu, régler la durée des transitions de contenu et le type d’apparition des panneaux. Les préférences sont persistées. Les tests tactiles dans le navigateur vérifient un déplacement réel avant le relâchement ; ils ne remplacent pas un essai Expo Go sur appareil.

Spinner : variantes du web, rendu natif SIA ​

Spinner propose variant="ring", "double-ring", "dots" et size="xs" à "xl". Les dimensions sont 12, 16, 24, 32 et 48 unités natives, correspondant aux tailles web à la base 16. La valeur par défaut est ring/md/current comme sur le web. Les deux anneaux tournent en sens inverse ; les points pulsent avec un décalage. Le double-ring web reprend le même dessin : anneau intérieur en retrait de 16 %, opacité de 50 %, tours de 1,2 s et 0,8 s en sens inverse. Les dessins sont natifs et ne dépendent pas de l’apparence système.

Les tons current, neutral, primary, info, success, warning et danger sont présents. Neutral utilise la couleur atténuée ; info suit primary comme le Spinner web. color surcharge explicitement la couleur ; strokeWidth, duration et animating règlent le dessin et sa vitesse. La durée doit être finie et positive.

React Native n’hérite pas de color à travers une View comme le DOM : SpinnerColorProvider color={...} fournit la couleur de tone="current" à son sous-arbre. Sans contexte, current utilise le texte du thème. Une couleur explicite prime sur le ton et le contexte ; un ton sémantique prime sur le contexte.

tsx
<Spinner variant="dots" size="lg" tone="success" label="Enregistrement" />
<SpinnerColorProvider color="#7c3aed">
  <Spinner tone="current" />
</SpinnerColorProvider>
<Button loading spinnerProps={{ variant: "double-ring" }}>Enregistrer</Button>

Button fournit sa couleur de premier plan au Spinner ; spinnerProps permet de choisir sa variante. StateScreen accepte aussi spinnerProps, et Toaster utilise le même composant. Les spinners internes aux boutons/notifications sont décoratifs pour éviter de répéter leurs annonces. Un Spinner autonome conserve un seul nom accessible et l’état occupé même lorsqu’il est statique.

Toutes les boucles utilisent le pilote natif, s’arrêtent en arrière-plan et au démontage, et sont désactivées par le mouvement réduit du provider ou du système. animating={false} garde un dessin lisible sans boucle ; cela n’annonce pas la fin du chargement. La page Composants → Spinners et chargement montre les quinze combinaisons variante/taille et un aperçu personnalisable. Les tailles et le vocabulaire sont alignés sur le web ; ceci ne prétend pas rendre les props DOM ou l’héritage CSS disponibles sur une View native.

Publié sous licence MIT.