Formations — 1 037 leçons en français

Accueil › Vue.js › Slots à portée et inversion de contrôle

Slots à portée et inversion de contrôle

Patterns de compositionavance

Un slot ordinaire laisse le parent insérer du balisage. Un slot à portée laisse en plus l'enfant passer des données à ce balisage. C'est ce retournement qui transforme un composant rigide en composant réutilisable.

Un composant qui charge une liste et l'affiche impose son rendu. Le même composant qui charge la liste et la rend à son appelant n'impose plus rien.

<!-- ListeProduits.vue -->
<script setup>
const props = defineProps({ produits: Array })
</script>

<template>
  <ul>
    <li v-for="p in produits" :key="p.id">
      <slot name="ligne" :produit="p" :promo="p.remise > 0">
        {{ p.nom }}
      </slot>
    </li>
  </ul>
</template>
<ListeProduits :produits="produits">
  <template #ligne="{ produit, promo }">
    <strong v-if="promo">{{ produit.nom }} — soldé</strong>
    <span v-else>{{ produit.nom }}</span>
  </template>
</ListeProduits>

L'enfant garde la boucle, les clés, la structure. Le parent garde l'apparence d'une ligne. Aucun des deux n'a besoin de connaître l'autre en détail.

Trois règles suffisent. Le contenu du slot est compilé dans la portée du parent : il ne voit que les variables du parent, plus celles que l'enfant lui passe. Les attributs posés sur <slot> forment l'objet de portée que v-slot déstructure. Et le contenu entre <slot> et </slot> est le repli, utilisé seulement si le parent ne fournit rien.

Les termes à connaître

Slot à portée

Un slot auquel l'enfant passe des données, via <slot :x="...">. Le parent les reçoit avec v-slot="{ x }" et décide seul de leur rendu.

Inversion de contrôle

Le composant garde la logique et rend le rendu à son appelant. Il ne devine plus ce que l'appelant veut afficher : il lui donne la matière.

Portée de compilation

Le contenu d'un slot est compilé dans la portée du parent. Il accède aux variables du parent, jamais à celles de l'enfant — sauf celles que l'enfant expose explicitement.

$slots

Objet exposant les slots reçus. En <script setup>, useSlots() ou defineSlots() y donnent accès pour tester la présence d'un slot ou le typer.

defineSlots

Macro de compilation qui déclare la signature des slots d'un composant. Elle n'ajoute aucun code à l'exécution : elle sert au typage et à l'autocomplétion.

Slot de repli

Le contenu placé entre <slot> et </slot>. Il s'affiche quand le parent ne fournit rien pour ce slot.

Slot nommé dynamique

<template #[nom]> choisit le slot cible à l'exécution, à partir d'une expression du parent.

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.