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 avecv-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()oudefineSlots()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.
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.