Tous les composants dans la démonstration web
La démonstration web s’ouvre maintenant sur Composants → Tous. Le catalogue référence les 115 modules de composants du registre public, avec noms, descriptions, familles, statut du registre, aperçus et variantes.
Parcourir la page
- Tous est la première entrée du groupe Composants ; Vue d’ensemble et les scénarios métier restent accessibles.
- Boutons, badges, spinners et contrôles courants apparaissent en premier.
- La recherche porte sur noms, sous-composants, descriptions et alias français. Elle ignore casse et accents et accepte les pluriels courants.
- Les familles filtrent la liste ; changer la recherche ou la famille revient à la première page. Douze fiches sont affichées par page.
- Les contrôles compacts sont visibles immédiatement. Les grandes compositions se chargent avec Afficher l’aperçu ; elles ne démarrent pas toutes à la fois.
- Voir les variantes ouvre les exemples du composant dans la démonstration, sans nécessiter un second serveur Storybook. Le retour conserve les filtres.
- Les compositions liées à une application, à un adaptateur de formulaire ou à la session renvoient vers leur parcours existant.
Les statuts Stable, Expérimental et Déprécié viennent du registre. Ils n’indiquent pas une comparaison avec React Native. Le compteur porte sur les modules de composants ; une fiche peut exposer plusieurs sous-composants.
Thème et petits écrans
Le bouton clair/sombre reste accessible dans l’en-tête, y compris sur téléphone. Le panneau Personnalisation conserve les choix Clair, Sombre et Auto, ainsi que les couleurs et rayons. Les aperçus réutilisent le SiaProvider et les notifications de la démonstration. La pagination et les conteneurs défilants limitent les grands exemples sans faire déborder la page.
Source unique des exemples
apps/docs/catalogue.ts génère les métadonnées depuis le registre, les sources, les descriptions des composants et les fichiers d’exemples existants. Le module virtuel virtual:sia-web-catalogue fournit seulement ces métadonnées au navigateur : il n’embarque pas les fichiers Markdown et TypeScript bruts.
WebCatalogue.tsx compose le catalogue et ses filtres. WebExamples.tsx réutilise le composant ou le rendu, les args et les décorateurs locaux des exemples. Les fonctions de test interactif et la barre de contrôle Storybook ne sont pas exécutées. Le choix d’une variante remonte uniquement son exemple ; un rendu ordinaire du catalogue ne recrée pas la fonction de composant contenant une saisie.
Les scénarios Sidebar/AppShell restent dans les pages déjà prévues pour eux. Les composants sans story autonome (Container et ColorModeToggle) possèdent un aperçu compact ; FormField et RequireSession utilisent leurs parcours existants.
Lors d’un ajout, le registre et l’exemple doivent rester cohérents. Les tests vérifient que l’inventaire correspond aux exports publics et que chaque fiche a un aperçu, un exemple ou un parcours. Le catalogue n’est pas une promesse que les scénarios d’une application réelle ont été validés.