Accueil › Vue.js › Distribuer du contenu avec les slots
Distribuer du contenu avec les slots
Composants et propsdebutant
Une prop transmet une donnée. Un slot transmet du balisage. Le composant réserve un emplacement, le parent le remplit.
<!-- Panneau.vue -->
<template>
<section class="panneau">
<header><slot name="entete">Sans titre</slot></header>
<div class="corps"><slot /></div>
<footer v-if="$slots.pied"><slot name="pied" /></footer>
</section>
</template>
<Panneau>
<template #entete><h2>Facture 2024-18</h2></template>
<p>Montant dû : 1 240 €</p>
<template #pied><button>Payer</button></template>
</Panneau>
Trois mécanismes suffisent :
- Le slot par défaut reçoit tout le contenu non placé dans un
<template #nom>. - Un slot nommé est déclaré par
<slot name="entete">et rempli par<template #entete>. - Le contenu de repli est ce qui est écrit entre
<slot>et</slot>: il n'apparaît que si le parent ne fournit rien.
Le contenu d'un slot est compilé dans la portée du parent. Il voit les variables du parent, jamais celles de l'enfant — sauf si l'enfant les lui transmet explicitement par un slot avec portée.
Les termes à connaître
- Slot
Un emplacement qu'un composant réserve dans son template pour du contenu fourni par le parent. Une prop transmet une donnée ; un slot transmet du balisage.
- Slot par défaut
L'emplacement qui reçoit tout le contenu non nommé passé au composant. Son nom interne est
default.- Slot nommé
Un emplacement identifié par
<slot name="entete">, que le parent remplit avec<template #entete>.- Contenu de repli
Le balisage écrit entre
<slot>et</slot>. Il s'affiche seulement si le parent ne fournit rien pour ce slot.- Slot avec portée
Un slot qui passe des données au parent en les liant sur la balise
<slot>. Le parent les récupère avec#nom="{ … }".- `$slots`
L'objet qui liste les slots réellement fournis par le parent, utile pour n'afficher une zone que si elle a du contenu.
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.