Component-stories schrijven
CSF3-indeling, default export (title, component), named exports als stories en args.
Component-stories schrijven is een gratis Vue Academy-les op CoddyKit. Dit is les 2 van 4. Je kunt 3 lessen uit dit leerpad gratis volledig lezen — daarna ontgrendelt CoddyKit PRO alle lessen, plus praktische oefeningen met een ingebouwde code-editor en een AI-tutor die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject Vue Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus Vue Academy bevat in totaal 4 lessen.
Stories beschrijven componenttoestanden
Een story legt één toestand van een component vast — een specifieke combinatie van props en inhoud. Een knop kan stories hebben voor Primair, Secundair en Uitgeschakeld. Storybook geeft elk daarvan weer als een afzonderlijk voorbeeld dat je kunt bekijken.
CSF3: de moderne indeling
Storybook gebruikt Component Story Format 3 (CSF3). Een bestand heeft één standaardexport die het component beschrijft en benoemde exports voor elke story. Het zijn gewone JavaScript/TypeScript-objecten — met minimale basiscode.
De standaardexport (meta)
De standaardexport is het meta-object. Dit heeft minimaal een title (het pad in de zijbalk) en het component dat wordt gedocumenteerd.
import Button from "./Button.vue"
export default {
title: "Components/Button",
component: Button,
}De title ordent de zijbalk
title gebruikt schuine strepen om een mappenstructuur in de Storybook-zijbalk te maken. "Forms/Inputs/TextField" nestelt drie niveaus diep.
export default {
title: "Forms/Inputs/TextField",
component: TextField,
}Benoemde exports zijn stories
Elke benoemde export is een variant van een story. De naam van de export wordt het label van de story in de zijbalk.
export const Primary = {}
export const Secondary = {}
export const Disabled = {}Het args-object
Het args-object van een story levert waarden voor de props. Storybook geeft deze door aan het component en met het deelvenster Controls kun je ze direct aanpassen.
export const Primary = {
args: {
label: "Click me",
variant: "primary",
},
}Meerdere varianten met args
Gebruik hetzelfde component in meerdere stories door alleen args te wijzigen. Elke export geeft het component met andere props weer.
export const Primary = { args: { variant: "primary", label: "Save" } }
export const Danger = { args: { variant: "danger", label: "Delete" } }Standaardargs op meta
Plaats gedeelde args op het meta-object; afzonderlijke stories overschrijven alleen wat afwijkt. Zo blijven stories DRY.
export default {
component: Button,
args: { label: "Button" }, // default for all stories
}
export const Disabled = { args: { disabled: true } }Stories met slots via render
Geef voor inhoud via slots een render-functie die een sjabloon met het component retourneert. Hiermee behandel je gevallen die je niet alleen met args kunt uitdrukken.
export const WithIcon = {
render: (args) => ({
components: { Button },
setup() { return { args } },
template: '<Button v-bind="args">⭐ Star</Button>',
}),
}Automatisch gegenereerde documentatie met tags
Voeg tags: ["autodocs"] toe aan meta om Storybook automatisch een documentatiepagina voor het component te laten genereren op basis van de props en stories.
export default {
title: "Components/Button",
component: Button,
tags: ["autodocs"],
}Wat autodocs oplevert
De autodocs-pagina vermeldt de props van het component (naam, type en standaardwaarde), toont elke story als live voorbeeld en geeft eventuele beschrijvende opmerkingen weer — een levende specificatie zonder extra bestanden.
Korte controle
Controleer of je begrijpt hoe je stories schrijft.
Samenvatting
Je hebt geleerd hoe je componentstories schrijft:
- Een story legt één toestand van een component vast; CSF3 gebruikt objectexports.
- De standaardexport is meta met
title(het pad in de zijbalk) encomponent. - Elke benoemde export is een variant van een story;
argslevert de waarden voor de props. - Gedeelde args staan op meta; stories overschrijven de rest. Gebruik
rendervoor slots. tags: ["autodocs"]genereert automatisch een documentatiepagina.
Leer HTML met een AI-tutor — gratis
Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.
- Cursussen
- 42
- Lessen
- 156
Veelgestelde vragen
Is de les “Component-stories schrijven” gratis?
Ja — je kunt hier op het web alle 3 lessen van het leerpad Vue Academy, waaronder “Component-stories schrijven”, gratis volledig lezen. Daarna ontgrendelt CoddyKit PRO alle lessen, plus interactieve oefeningen met een ingebouwde code-editor en een AI-tutor die 24/7 beschikbaar is. De cursus Vue Academy bevat in totaal 4 lessen.
Wat leer ik in “Component-stories schrijven”?
CSF3-indeling, default export (title, component), named exports als stories en args. Je oefent met Vue Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.
Heb ik ervaring nodig om met Vue Academy te beginnen?
Ervaring vooraf is niet nodig. Vue Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 2 van 4.
Hoe lang duurt de les “Component-stories schrijven”?
De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.
Kan ik code schrijven en uitvoeren in deze les over Vue Academy?
Ja. Elke les over Vue Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.
Alle lessen in deze cursus
- Storybook instellen voor Vue 3
- Component-stories schrijven
- Controls, actions en args
- Storybook-addons en toegankelijkheidstests