Formations — 1 037 leçons en français

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 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.

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.