Formations — 1 037 leçons en français

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 :

  1. 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+).
  2. 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.
  3. 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 de titre en props.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.

Lire l'explication détaillée et faire le quiz →

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.