Skip to content

React Native : styles avec Uniwind ​

Décision et état actuel ​

@sia-ui/react-native utilise Uniwind pour les styles. Les valeurs restent issues de @sia-ui/tokens et les comportements partagés de @sia-ui/headless. Le paquet natif fournit le rendu et les adaptations Android/iOS.

Le premier lot est implémenté et expérimental : provider, Text, Button, Input, Card, Modal et Toast, complétés par les champs, FormContainer/FormSection, BottomSheet et Select avec recherche intégrée. La démonstration Expo les réunit. Le guide mobile donne les commandes, la matrice de versions, les APIs et les limites. Les exports Android/iOS/web et les tests de comportement vérifient la compilation et la logique ; les essais sur appareils restent nécessaires avant une adoption en production.

Identité commune, usage mobile ​

Le rendu mobile conserve les palettes sémantiques, la typographie, les formes, la hiérarchie visuelle et les états SIA. Les mêmes tokens produisent les styles web et les classes natives, sans copie manuelle d’une deuxième palette.

Les adaptations concernent les cibles tactiles (au moins 48 unités pour les boutons), les zones sûres, le clavier logiciel, le défilement et le Retour Android. Les props restent natives : onPress, onChangeText, keyboardType et refs TextInput. Le changement de plateforme ne transforme pas les props DOM en contrat commun. Le provider fournit un thème local clair/sombre/système via ScopedTheme.

Mouvement ​

Le premier lot utilise Animated de React Native. Les courbes cubic-bezier et les durées proviennent des tokens partagés ; opacité et transformation utilisent le pilote natif. Les animations couvrent appui, focus, modale et toast. Elles peuvent être interrompues et respectent la préférence système de mouvement réduit, suivie pendant l’utilisation. Une prop peut forcer cette réduction, jamais la désactiver contre le choix système.

Uniwind fournit les styles ; Animated anime les valeurs. Le glissement de poignée des feuilles utilise PanResponder : suivi en JavaScript, retour Animated. Une dépendance dédiée sera évaluée si les interactions de navigation ou les mesures sur appareils le nécessitent.

Frontières et dépendances ​

  • Tokens et headless restent indépendants d’Uniwind et du runtime React Native.
  • La génération du thème et les classes vivent dans le paquet natif.
  • L’application fournit React Native, Uniwind et les zones sûres en dépendances compatibles ; la démo fixe ensemble Expo, React Native, React et Tailwind.
  • La démo part du template Expo TypeScript officiel, avec sa licence conservée.
  • Le preset NativeWind existant reste un export de tokens distinct ; il ne sert pas de configuration Uniwind et ne devient pas un composant mobile.
  • La CLI de copie et le registre web ne distribuent pas encore le catalogue natif.

Validation restante et extension prévue ​

Avant d’étendre le catalogue, vérifier sur Android et iOS :

  1. thème système, clair/sombre et changement pendant l’utilisation ;
  2. saisie, clavier logiciel, chargement et erreurs ;
  3. Retour Android, découpes d’écran et cibles tactiles ;
  4. fluidité, interruption et mouvement réduit ;
  5. VoiceOver/TalkBack, focus à l’ouverture et au retour, texte agrandi et contraste.

Prévu ensuite : validation sur appareils et parcours métier. La sélection, les feuilles, la navigation, les gardes de session et les états de page sont implémentés. L’intégration Expo Router reste une entrée optionnelle distincte. Le backlog distingue les APIs implémentées de ces travaux restants.

Publié sous licence MIT.