Adaptations mobiles des composants web
Les 13 modules auparavant À adapter possèdent une API native expérimentale, implémentée pour la prochaine publication de @sia-ui/react-native. Ils couvrent leur responsabilité principale avec des interactions adaptées au téléphone ; cela ne signifie pas identité de toutes les props ou de toutes les fonctions web.
Architecture
Aucun composant n’importe le DOM ou le rendu web. Les seules commandes clavier DOM sont attachées par CommandPalette lorsque Platform.OS === 'web'. react-native-svg reste un pair, déjà utilisé par les icônes ; qrcode-generator@^2.0.4 est une peerDependency requise, fournie explicitement par l’application. Le paquet la conserve externe aux bundles et l’utilise aussi en développement pour ses tests ; la démo Expo la déclare dans ses dépendances. L’import racine expose QRCode : le pair reste requis même si l’écran courant n’affiche pas de QR code. Il ne nécessite aucun module natif à compiler.
pnpm add qrcode-generator@^2.0.4jsqr est uniquement une dépendance de test : il décode les matrices produites pour vérifier indépendamment l’encodage ASCII et UTF-8.
Conteneurs
AspectRatio
<AspectRatio ratio={16 / 9} style={{ borderRadius: 16 }}>
<Image source={cover} style={{ width: '100%', height: '100%' }} />
</AspectRatio>Le rapport doit être fini et strictement positif. Le conteneur suit la largeur disponible et masque les débordements. Les autres props et styles sont ceux de View.
ScrollArea
ScrollArea expose les props et la ref de ScrollView, avec keyboardShouldPersistTaps="handled" par défaut. horizontal, les indicateurs, contentContainerStyle, onScroll et scrollTo restent natifs. Pour des milliers d’éléments, employer FlatList ou ResourceList : ce wrapper ne virtualise pas.
ResizablePanel
<ResizablePanel
first={{ title: 'Liste', content: <ContactList /> }}
second={{ title: 'Détail', content: <ContactDetail /> }}
mobile="tabs"
defaultValue={40}
onValueChange={setPercent}
/>Sous breakpoint (720 par défaut), les contenus sont empilés (mobile="stack") ou choisis par onglets (tabs). Sur grand écran, la poignée tactile règle le pourcentage du premier panneau. orientation accepte horizontal/vertical ; value contrôle le pourcentage, defaultValue initialise le mode local, min/max bornent la valeur (20/80 par défaut, limites absolues 5/95). height vaut 360. Des boutons et les actions d’accessibilité ajustables offrent une alternative au glissement. Le contenu de chaque panneau gère son défilement.
Navigation et découverte
Breadcrumb
items contient { key, label, disabled? } ; onNavigate reçoit l’ancêtre choisi. Le dernier élément est la page courante. Sous 640 px, seuls le parent et la page courante restent visibles et le bouton « … » ouvre les autres ancêtres dans une feuille. compact permet d’imposer ou désactiver cette présentation ; label remplace le nom accessible du fil.
Tooltip et HoverCard
<Tooltip label="Aide sur les rôles" content="Le rôle limite les actions possibles.">
<InfoIcon />
</Tooltip>
<HoverCard label="Aperçu du contact" content={<ContactSummary />}>
<Text>Alex Martin</Text>
</HoverCard>Les enfants sont un contenu visuel non interactif : le composant fournit le Pressable. L’ouverture fonctionne par appui, appui long et activation clavier. open/onOpenChange permettent un contrôle externe, disabled bloque l’action. Le Popover commun choisit une feuille sur téléphone et un ancrage sur grand écran. presentation="sheet" ou "popover" permet d’imposer ce choix. HoverCard ne dépend pas d’un survol : c’est un aperçu tactile, pouvant contenir des actions dans sa feuille.
CommandPalette
<CommandPalette
open={open}
onOpenChange={setOpen}
can={session.can}
items={[
{ key: 'create', label: 'Créer un contact', group: 'Contacts',
keywords: 'nouveau utilisateur', permission: 'contacts.create',
onSelect: async () => navigate('/contacts/new') },
]}
/>La recherche ignore accents et casse, couvre libellé, description, groupe et mots-clés ; la liste est virtualisée et le clavier ne bloque pas la sélection. Les commandes peuvent porter icon, disabled, description et permission. Le filtre can est partagé avec les autres composants. Une action asynchrone bloque les doubles appuis ; une erreur conserve la feuille, une réussite la ferme. Une résolution tardive ne ferme pas une autre ouverture. Entrée lance la première commande disponible. Ctrl/Cmd+K fonctionne dans la cible web ; sur téléphone ou clavier externe natif, l’application peut piloter open avec son système de raccourcis. Garder une seule instance globale qui écoute le raccourci ; passer shortcut={false} aux aperçus ou instances dont l’écran n’est plus actif.
Tour
const target = useRef<View>(null);
const steps = [
{ key: 'contacts', title: 'Vos contacts', description: 'Retrouvez votre équipe.',
targetRef: target,
beforeEnter: async () => {
await navigateAndWaitForScreen('/contacts');
await scrollToTargetAndWait();
} },
];
<View ref={target} collapsable={false}><ContactsSummary /></View>
<Tour open={open} onOpenChange={setOpen} steps={steps} onFinish={markCompleted} />Chaque étape a une clé, un titre, une description optionnelle, une ref native measureInWindow et une préparation beforeEnter optionnelle. La préparation attend le routage/défilement fourni par l’application, puis la visite mesure la cible. Un spotlight garde la cible visible au milieu du masque ; la carte se place sous elle si possible ou en bas avec protection des zones sûres. Sans cible montée ou visible, la visite reste utilisable sous forme de carte sans spotlight. Une erreur de préparation affiche Réessayer ; une fermeture ou un changement d’étape invalide les résultats asynchrones tardifs. initialStep, onStepChange, Précédent, Suivant, Terminer et Retour Android sont disponibles. Le titre reçoit le focus et la carte est modale. La visite ne devine pas les routes et ne recherche pas de sélecteur CSS sur téléphone. L’application conserve elle-même la progression et le focus de retour si le parcours navigue entre plusieurs écrans.
Sélection et agenda
Transfer
La double colonne de bureau devient un résumé et une feuille de sélection. items contient { key, label, description?, disabled? }. targetKeys est contrôlé, onChange est appelé à la confirmation ; Annuler ferme sans modifier la sélection. La recherche et la liste virtualisée permettent de longues collections. Les clés inconnues du catalogue et les éléments verrouillés sont conservés lors de la confirmation. Le résumé propose aussi le retrait individuel autorisé. disabled, readOnly, sourceTitle et targetTitle personnalisent le comportement.
EventCalendar
<EventCalendar
events={events}
date={date}
onDateChange={setDate}
view={view}
onViewChange={setView}
onRangeChange={(range, view) => loadEvents(range, view)}
onEventClick={showEvent}
height={520}
/>Les vues sont month, week, day et agenda ; agenda est le défaut. Les dates civiles, périodes et événements de plusieurs jours utilisent le modèle headless commun. La vue mois associe le calendrier complet et la liste du jour ; semaine et agenda sont des sections chronologiques plutôt qu’une grille horaire serrée. La liste et son en-tête partagent un seul défilement virtualisé. views limite le choix ; defaultDate et defaultView initialisent les modes locaux. onDayClick, renderEvent, loading et height sont disponibles. Calendar expose désormais onMonthChange pour synchroniser aussi sa navigation interne avec le chargement de la période. EventManager reste responsable de la création et de l’édition. Le déplacement/redimensionnement des événements par glisser, les colonnes horaires par ressource et le zoom ne font pas partie de cette API mobile.
Graphiques et QR codes
Chart
<Chart label="Inscriptions hebdomadaires" type="bar"
labels={['Lun', 'Mar', 'Mer']}
series={[{ key: 'count', label: 'Inscriptions', values: [4, null, -2] }]}
/>Le rendu SVG natif couvre line, area et bar, plusieurs séries, tons ou couleurs explicites, grille, légende, hauteur, bornes min/max, format et caption. Les valeurs nulles/non finies créent des ruptures ; les barres utilisent une base zéro et acceptent les valeurs négatives. La légende masque/rétablit une série. L’appui choisit le point le plus proche, les boutons Précédent/Suivant permettent la même lecture sans précision tactile, avec libellés et valeurs textuelles. selectedIndex/onSelectionChange contrôlent cette lecture. readOnly la désactive. Le graphe reste un SVG léger : pas d’axes secondaires, de zoom/pincement, de navigation temporelle infinie ou de moteur de dessin web embarqué.
QRCode
Le QR est encodé localement en UTF-8 puis dessiné en SVG noir sur blanc pour rester scannable en clair et sombre. level accepte L/M/Q/H (M par défaut), quietZone conserve au moins quatre modules blancs, size vaut 180 par défaut (minimum 48), showValue affiche la valeur sélectionnable et label nomme l’image. Les valeurs trop volumineuses ou invalides donnent un état d’erreur, pas un crash.
shareable propose le partage natif de la valeur textuelle. Pour enregistrer ou partager l’image, injecter onShare(svg, value) avec l’adaptateur de fichiers de l’application ; le SVG fourni contient la zone calme. Cette distinction évite de prétendre que les URI de données sont des fichiers partageables sur tous les OS.
LogStream
<LogStream lines={lines} maxLines={500} height={320} streaming
onCopy={text => Clipboard.setStringAsync(text)} />Chaque ligne a un id stable, time, level (debug/info/warn/error/success), message textuel et un group optionnel. La vue ne garde qu’un instantané borné (maxLines : 1 à 10000, défaut 500), avec rendu virtualisé. Recherche par message ou groupe, filtre de niveau, copie injectable et états vide/chargement sont disponibles. Le mode compact (défaut) place recherche, niveau et suivi dans une feuille ; variant="full" garde ces contrôles visibles. La liste est inversée avec données réordonnées pour rejoindre sa fin sans estimation de hauteur des lignes. Le défilement manuel suspend le suivi ; Pause gèle la vue sans demander au producteur d’arrêter le flux. paused/onPausedChange contrôlent cet état. Le passage en arrière-plan gèle aussi les mises à jour ; le retour reprend la fenêtre courante. La source réseau, son buffer total, sa reconnexion et son arrêt restent gérés par l’application ; aucune socket n’est ouverte par l’UI.
Démo et limites de validation
Composants → Adaptations mobiles contient Disposition, Aides et recherche, Visite guidée, Agenda multivue, Graphiques et QR, Journal en direct. Les 13 fiches figurent aussi dans Tous (123 fiches au total) ; les collections virtualisées et la visite utilisent leur écran dédié pour éviter les listes imbriquées du catalogue. Les zones sûres, gestes, focus natif, agrandissement système du texte et partage système doivent encore être essayés sur appareil. Les tests automatisés et les exports Expo ne constituent pas cette validation.