Skip to content

Affichage métier et tableaux de bord mobiles ​

Le socle natif expérimental fournit désormais Statistic, StatCard, KpiGrid, AmountDisplay, DurationDisplay, RelativeTime, EntityMeta, AuditMeta et Timeline. Ils reprennent les responsabilités du web avec des primitives natives, les formats partagés, les palettes SIA et la réduction des mouvements. Les props DOM et les feuilles CSS du web ne sont pas transférées sur mobile.

Indicateurs ​

tsx
import { KpiGrid, StatCard } from '@sia-ui/react-native';

<KpiGrid columns={3} minCardWidth={220} gap={12}>
  <StatCard label="Contacts" value={summary.total} loading={loading} />
  <StatCard label="Actifs" value={summary.active} tone="success" variant="accent" />
  <StatCard label="Taux actif" value={summary.active / summary.total}
    format="percent" precision={1} />
</KpiGrid>

L'application calcule les agrégats ; pour une collection paginée sur un serveur, utiliser un endpoint de statistiques, pas les dix lignes de la page courante. Gérer explicitement un dénominateur nul. Un nombre absent (null) ou non fini s'affiche avec la valeur de repli des formats (— par défaut).

Statistic accepte number, currency et percent, la devise, la locale, la précision, les préfixe/suffixe, les tailles sm/md/lg et un ton sémantique. Une tendance est fractionnaire : 0.12 représente +12 %, pas +0,12 %. trendDirection="lower-is-better" signale une baisse favorable ; neutral neutralise la couleur. Le signe reste visible sans dépendre de cette couleur.

StatCard ajoute icône décorative, description, action indépendante et variantes outline/soft/accent. loading masque la valeur par des squelettes ; error a priorité et propose onRetry. Aucun détail technique d'exception n'est affiché. cardProps configure la surface ; style et les props natives restent disponibles.

KpiGrid limite le nombre de colonnes à columns (1–4), puis mesure son espace intérieur pour respecter minCardWidth (220 par défaut, minimum 120). Sur téléphone, les cartes passent en colonne ; sur tablette, plusieurs colonnes deviennent possibles. Les cartes et leurs actions ne sont pas remontées à chaque changement de largeur. Le composant n'est pas un moteur de graphiques ni une liste virtualisée.

Montants, durées et dates ​

tsx
<AmountDisplay value={-12500} currency="XAF" label="Débit" tone="danger" />
<AmountDisplay value={180} currency="EUR" sign="always" secondary="Exemple" />
<DurationDisplay milliseconds={3661000} style="clock" />
<RelativeTime value={contact.updatedAt} refreshInterval={60000} />
  • AmountDisplay conserve le signe, y compris avec les montants négatifs ; sign="always" affiche également le signe des valeurs positives et de zéro. Devise, locale, valeur vide et signe moins suivent les formats partagés.
  • DurationDisplay affiche short, long ou clock ; une durée négative devient zéro, une durée non finie utilise le repli. Les heures peuvent dépasser 24. Le style React Native se passe dans textStyle, car style sélectionne ici le format comme sur le web. Les unités viennent des messages de la locale SIA.
  • RelativeTime annonce une date relative et fournit la date complète en accessibilityHint. Son intervalle s'arrête en arrière-plan et se nettoie au démontage ; la date se recalcule immédiatement au retour actif. Une valeur refreshInterval nulle/négative désactive l'intervalle. L'intervalle positif est borné à une seconde au minimum. Une date invalide n'entraîne pas d'exception.

Les props explicites de locale ont priorité. Sans prop, ces composants utilisent useFormatLocale et useFormatDefaults, comme les composants web.

Métadonnées et historique ​

tsx
<EntityMeta identifier={contact.id} status={<Badge>Actif</Badge>}
  createdAt={contact.createdAt} createdBy="Alex"
  updatedAt={contact.updatedAt} variant="stacked" />

<AuditMeta events={events.map(event => ({
  key: event.id, label: event.label, at: event.at,
  by: event.author, detail: event.description,
}))} />

EntityMeta expose les variantes stacked/inline, un identifiant sélectionnable, un statut riche et les auteurs/dates. Les informations absentes sont omises. AuditMeta affiche titre, auteur, détail et date relative, avec un état vide localisé. Il réutilise Timeline : variantes line/cards, repères dot/number ou icônes par événement, densité compact/comfortable, inversion et événement en attente. Les tons sont sémantiques ; le texte porte également le sens. Un événement peut proposer une action native accessible.

La chronologie suit l'ordre fourni ; reverse inverse cet ordre sans trier les horodatages ni modifier les données. Fournir des clés stables, surtout lors d'une insertion en tête. Les très grands journaux demandent une source paginée et une liste virtualisée ; Timeline ne monte pas seulement les éléments visibles.

CrudPage expose renderDetailHeader(item) et renderDetailFooter(item) pour composer ces briques autour de la description, avec l'entité effectivement chargée. Les slots sont absents des formulaires et des pages refusées/introuvables.

Animations et personnalisation ​

Les valeurs des indicateurs apparaissent avec fondu et léger déplacement lors de leur changement ; les événements apparaissent à leur montage. animation accepte duration, easing et disabled. Il s'agit d'une transition visuelle, pas d'un comptage artificiel des valeurs. La préférence système de mouvement réduit est prioritaire. Aucun délai ni animation n'est requis pour comprendre la valeur.

Les defaults du provider acceptent les clés statistic, statCard, kpiGrid, timeline, entityMeta, auditMeta, amountDisplay, durationDisplay et relativeTime. Une prop explicite prime sur ces defaults. Dans la démo, le réglage de durée des transitions pilote également Statistic et Timeline. Le thème et les couleurs utilisent le même panneau Personnaliser que les autres pages.

Démo Contacts ​

  1. Ouvrir Contacts, puis Tableau de bord Contacts, en Membre ou Administrateur.
  2. Vérifier les trois indicateurs : total, actifs et organisations distinctes. Ils portent sur toute la collection locale, pas sur la page/les filtres de liste.
  3. Ouvrir une fiche depuis l'activité récente : métadonnées et historique sont visibles.
  4. En Administrateur, créer puis modifier un contact : l'auteur local et les dates sont conservés après rechargement. Revenir au tableau de bord pour recalculer.
  5. Ouvrir Variantes et états métier : cartes, tailles, chronologies, repères, ordre, densité, chargement/erreur et formats. Faire évoluer les valeurs exemples.
  6. Comparer téléphone/tablette, clair/sombre, palette personnalisée, transitions et mouvement réduit. Tester également le réessai d'une erreur des indicateurs.

Les valeurs financières et tendances de la section d'exemples sont fictives. Le résumé d'activité montre la dernière modification connue de cinq contacts. L'historique stocké sur une fiche est limité aux 100 derniers événements locaux ; les anciennes fiches ne disposent que de leurs dates connues, sans auteur inventé. Ce stockage modifiable n'est pas un journal d'audit serveur ni une preuve inviolable.

Limites et validation ​

Le lot ne fournit ni backend analytique, ni graphiques, ni export de rapports, ni journal serveur, ni flux temps réel. La bibliothèque affiche les données fournies par l'application. Les tests automatisés, builds et essais navigateur doivent être complétés sur Android/iOS : grandes polices, lecteur d'écran, retour d'arrière-plan, zones sûres et performances avec de vrais volumes.

Compatibilité des dates relatives ​

Sur un moteur sans Intl.RelativeTimeFormat, les utilitaires partagés fournissent un repli FR/EN, avec date complète localisée pour les autres langues. RelativeTime, EntityMeta et AuditMeta ne nécessitent pas d'installation de polyfill. Voir les détails de compatibilité.

Publié sous licence MIT.