Accueil › Vue.js › Déclarer et typer des props
Déclarer et typer des props
Composants et propsdebutant
Un composant déclare ce qu'il accepte de l'extérieur avec defineProps. En
TypeScript, on décrit la forme attendue, et le compilateur en déduit la
déclaration que Vue utilise à l'exécution.
<!-- Carte.vue -->
<script setup lang="ts">
const { titre, lignes = 2, actif = false } = defineProps<{
titre: string
lignes?: number
actif?: boolean
}>()
</script>
<template>
<article :class="{ actif }">
<h2>{{ titre }}</h2>
<p>{{ lignes }} ligne(s)</p>
</article>
</template>
Le parent fournit les valeurs comme des attributs. Sans deux-points, la valeur
est une chaîne littérale ; avec :, c'est une expression JavaScript.
<Carte titre="Facture" :lignes="12" actif />
Trois règles tiennent tout le reste :
- Une prop optionnelle se marque par
?dans le type, et sa valeur par défaut s'écrit directement dans la déstructuration (Vue 3.5+). - Une prop est en lecture seule. L'enfant ne la réassigne pas. S'il doit faire changer la valeur, il émet un événement.
- Les données descendent. Le parent est propriétaire de la donnée ; l'enfant n'en reçoit qu'une vue.
Un attribut que le parent passe sans que l'enfant l'ait déclaré n'est pas
perdu : Vue l'applique sur l'élément racine. C'est ce qui permet d'écrire
<Carte titre="X" class="large" id="a" /> sans déclarer ni class ni id.
Les termes à connaître
- Prop
Une donnée qu'un composant parent transmet à son enfant. Déclarée par l'enfant, fournie par le parent, et en lecture seule dans l'enfant.
- `defineProps`
La macro de compilation qui déclare les props d'un composant
<script setup>. Elle n'est ni importée ni appelée à l'exécution : le compilateur la remplace.- Flux unidirectionnel
Les données descendent du parent vers l'enfant. L'enfant ne réassigne jamais une prop ; il émet un événement et laisse le parent décider.
- `withDefaults`
L'ancien moyen de donner des valeurs par défaut à des props typées. Depuis Vue 3.5, les valeurs par défaut s'écrivent directement dans la déstructuration.
- Déstructuration réactive
Depuis Vue 3.5,
const { titre } = defineProps<…>()conserve la réactivité : le compilateur réécrit chaque lecture detitreenprops.titre.- Attribut de repli
Un attribut passé par le parent mais non déclaré comme prop. Vue l'applique automatiquement sur l'élément racine du composant.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.