Aperçu

Les applications web modernes reposent sur des composants d'interface utilisateur réutilisables, et la façon dont nous les concevons, les construisons et les partageons est importante. Cette spécification vise à établir une norme formelle et ouverte pour la création de composants d'interface utilisateur open-source pour le web moderne.

Elle est co-rédigée par Hayden Bleasel et shadcn, avec des contributions de la communauté open-source et s'inspire de projets populaires de l'écosystème React.

L'objectif est d'aider les mainteneurs open-source et les ingénieurs front-end seniors à créer des composants qui sont composables, accessibles et faciles à adopter dans différents projets.

Qu'est-ce que cette spécification ?

Cette spécification n'est pas un tutoriel ni un cours sur React, ni une promotion pour une librairie ou un registre de composants spécifique. Elle fournit plutôt des lignes directrices de haut niveau, des bonnes pratiques et une terminologie commune pour la conception de composants d'interface.

En suivant cette spécification, les développeurs peuvent s'assurer que leurs composants sont conformes aux attentes modernes et s'intègrent facilement dans n'importe quelle base de code.

À qui s'adresse cette spécification ?

Nous rédigeons ceci pour les mainteneurs open-source et les ingénieurs front-end expérimentés qui construisent et distribuent des bibliothèques de composants ou des design systems. Nous supposons que vous maîtrisez JavaScript/TypeScript et React.

Tous les exemples utiliseront React (avec JSX/TSX) pour plus de précision, mais nous espérons que les concepts fondamentaux s'appliquent à d'autres frameworks comme Vue, Svelte ou Angular.

Autrement dit, nous espérons que la philosophie de cette spécification est agnostique vis‑à‑vis du framework — que vous développiez avec React ou une autre bibliothèque, vous devez mettre l'accent sur les mêmes principes de composition, d'accessibilité et de maintenabilité.