Bibliothèque de motifs
Un motif est une composition documentée de composants, orientée vers une tâche. Il offre une façon répétable de résoudre un problème récurrent d’interaction ou de contenu sans présenter un arrangement propre à une page comme universel.
Frontière#
| Couche | Possède |
|---|---|
| Fondation | Primitives visuelles et jetons sémantiques : couleur, typographie, espacement, rayons, ombres et mouvement |
| Composant | Une unité d’interface réutilisable avec un objectif, un comportement, un contrat d’accessibilité, une source et des variantes définis |
| Motif | Une composition de composants qui aide une personne à accomplir une tâche récurrente |
| Mise en page | La structure de gabarit qui place les motifs et le contenu de page dans une surface |
Un motif peut utiliser des composants, mais il ne remplace pas leurs pages. Une mise en page peut placer un motif, mais elle ne devient pas le motif simplement parce qu’elle en contient un.
Règle#
Créez un motif canonique seulement lorsque toutes les conditions suivantes sont remplies :
- la tâche revient sur plusieurs pages ou propriétés;
- la composition comporte des choix, des états ou un comportement d’accessibilité importants au-delà d’un composant;
- ses composants constitutifs et ses preuves sources sont connus;
- les personnes qui rédigent ou implémentent répéteraient autrement du balisage structurel ou trancheraient de nouveau le même comportement.
Ne créez pas de motif pour une composition de page unique, un tableau d’inspiration visuelle ou un composant présenté à côté d’un autre sans tâche utilisateur.
Fiche canonique#
Chaque motif consigne sa tâche, sa catégorie, son statut, ses composants constitutifs, ses exigences de contenu ou de données, ses attentes adaptatives et d’accessibilité, ses preuves d’implémentation et ses motifs liés. Sa règle courante vit dans la page du motif; les fichiers sources et les pages de composants restent les preuves qui la soutiennent.
Les motifs ne remplacent ni les Composants ni les Shortcodes. Les composants restent la bibliothèque d’interfaces canonique. Les shortcodes restent l’API destinée à la rédaction. Les motifs rendent leur relation utile pour une tâche récurrente.
Portée initiale#
La bibliothèque initiale documente le comportement existant avant d’inventer un nouveau comportement :
- Navigation du site
- Mise en page de documentation
La recherche, les index de référence et les flux de formulaire deviendront des motifs canoniques seulement après l’audit de leur tâche répétée et de leurs preuves sources.
Utilisez Bibliothèque de motifs pour la recette de métadonnées et d’implémentation.