Översikt

Moderna webbapplikationer bygger på återanvändbara UI-komponenter, och hur vi designar, bygger och delar dem är viktigt. Denna specifikation syftar till att etablera en formell, öppen standard för att bygga öppen källkods‑UI‑komponenter för den moderna webben.

Den är medförfattad av Hayden Bleasel och shadcn, med bidrag från öppen källkodsgemenskapen och influerad av populära projekt i React-ekosystemet.

Målet är att hjälpa underhållare av öppen källkod och erfarna frontendingenjörer att skapa komponenter som är komponerbara, tillgängliga och lätta att ta i bruk i olika projekt.

Vad är denna specifikation?

Denna specifikation är inte en handledning eller kurs om React, och inte heller reklam för något specifikt komponentbibliotek eller register. Istället ger den övergripande riktlinjer, bästa praxis och en gemensam terminologi för att designa UI‑komponenter.

Genom att följa denna specifikation kan utvecklare säkerställa att deras komponenter överensstämmer med moderna förväntningar och enkelt integreras i vilken kodbas som helst.

Vem är detta för?

Vi skriver detta för underhållare av öppen källkod och erfarna frontendingenjörer som bygger och distribuerar komponentbibliotek eller designsystem. Vi utgår från att du är bekant med JavaScript/TypeScript och React.

Alla exempel använder React (med JSX/TSX) för att vara konkreta, men vi hoppas att de grundläggande koncepten gäller även för andra ramverk som Vue, Svelte eller Angular.

Med andra ord hoppas vi att filosofin i denna specifikation är ramverksagnostisk – oavsett om du bygger med React eller ett annat bibliotek bör du betona samma principer för komposition, tillgänglighet och underhållbarhet.