Getypeerde props en emits met defineProps/defineEmits
Generic defineProps (), complexe types, optionele props en typering van emits.
Getypeerde props en emits met defineProps/defineEmits 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.
Invoer en uitvoer van componenten typen
Met lang="ts" accepteren de macro's defineProps en defineEmits rechtstreeks TypeScript-typen. Hierdoor worden tijdens het compileren controles uitgevoerd op de gegevens die een component in- en uitgaan.
Props vanuit een interface
Geef een type door aan het generieke type van defineProps. Een interface houdt complexe propstructuren leesbaar en herbruikbaar.
<script setup lang="ts">
interface Props {
title: string
count: number
}
const props = defineProps<Props>()
</script>Inline typebeschrijvingen
Voor kleine componenten is een inline objecttype prima; een aparte interface is dan niet nodig.
<script setup lang="ts">
const props = defineProps<{
label: string
disabled: boolean
}>()
</script>Optionele eigenschappen met ?
Markeer een eigenschap als optioneel met ?. Optionele props krijgen het type T | undefined en de oudercomponent mag ze weglaten.
<script setup lang="ts">
interface Props {
title: string
subtitle?: string
}
const props = defineProps<Props>()
</script>Complexe prop-typen
Props kunnen arrays, unies of objectstructuren zijn — alles wat TypeScript kan uitdrukken.
<script setup lang="ts">
interface Props {
items: string[]
size: 'sm' | 'md' | 'lg'
user: { id: number; name: string }
}
const props = defineProps<Props>()
</script>Standaardwaarden met withDefaults
De vorm die alleen een type bevat kan geen standaardwaarden bevatten, dus wikkel deze in withDefaults. Het tweede argument koppelt propnamen aan standaardwaarden.
<script setup lang="ts">
const props = withDefaults(defineProps<{
size?: string
count?: number
}>(), {
size: 'md',
count: 0
})
</script>Standaardwaarden voor objecten en arrays
Standaardwaarden voor objecten en arrays moeten door een fabrieksfunctie worden teruggegeven, net als in de Options API, om te voorkomen dat componenten één exemplaar delen.
withDefaults(defineProps<{
tags?: string[]
}>(), {
tags: () => []
})Getypeerde emits declareren
defineEmits kan een type accepteren waarin elke gebeurtenis en de bijbehorende lading als aanroepsignatuur wordt opgesomd. Hierdoor worden onjuiste typen van ladingen al tijdens het compileren gevonden.
<script setup lang="ts">
const emit = defineEmits<{
(e: 'change', value: string): void
(e: 'delete', id: number): void
}>()
</script>Getypeerde ladingen uitzenden
emit accepteert nu alleen geldige gebeurtenisnamen en bijbehorende typen van ladingen. Een getal doorgeven waar een tekenreeks wordt verwacht, veroorzaakt een compileerfout.
function rename(name: string) {
emit('change', name) // ok
// emit('change', 123) // type error
}De syntaxis met benoemde tuples
Vue 3.3+ ondersteunt een verkorte objectvorm waarin elke gebeurtenis wordt gekoppeld aan een tuple met de typen van de argumenten — duidelijker dan aanroepsignaturen.
<script setup lang="ts">
const emit = defineEmits<{
change: [value: string]
delete: [id: number]
}>()
</script>Props en emits samen
Een typisch getypeerd component declareert beide: invoer via defineProps en uitvoer via defineEmits, van begin tot eind volledig gecontroleerd.
<script setup lang="ts">
defineProps<{ modelValue: string }>()
const emit = defineEmits<{
'update:modelValue': [value: string]
}>()
</script>Korte controle
Toets je kennis van getypeerde props en emits.
Samenvatting
Je hebt getypeerde invoer en uitvoer van componenten geleerd:
- Geef een interface of inline type door aan defineProps<T>().
- Gebruik ? voor optionele props en withDefaults voor standaardwaarden (een fabrieksfunctie voor objecten/arrays).
- defineEmits<T>() voorziet gebeurtenisnamen en ladingen van typen.
- De tuplevorm (event: [payload]) is de moderne verkorte notatie.
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 “Getypeerde props en emits met defineProps/defineEmits” gratis?
Ja — je kunt hier op het web alle 3 lessen van het leerpad Vue Academy, waaronder “Getypeerde props en emits met defineProps/defineEmits”, 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 “Getypeerde props en emits met defineProps/defineEmits”?
Generic defineProps (), complexe types, optionele props en typering van emits. 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 “Getypeerde props en emits met defineProps/defineEmits”?
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
- TypeScript instellen in Vue-projecten
- Getypeerde props en emits met defineProps/defineEmits
- Composables en refs typeren
- Generieke Vue-components