<slot>

Un emplacement dans un composant web où arrive le contenu écrit entre ses balises.

Affichage
contents
Balise fermante
Obligatoire
Contenu autorisé
Contenu transparent, affiché comme contenu par défaut lorsqu’aucun contenu n’est attribué au slot
Sur cette page

Exemple

#
HTML
<template id="course-card-template">
  <style>
    :host { display: block; margin-bottom: 12px; }
    .card { max-width: 280px; padding: 12px 16px; border: 1px solid #8886; border-radius: 12px; }
    h3, ::slotted(h3) { margin: 0 0 6px; }
  </style>
  <article class="card">
    <slot name="title"><h3>Formation sans titre</h3></slot>
    <slot>La description arrive bientôt.</slot>
  </article>
</template>

<course-card>
  <h3 slot="title">HTML à partir de zéro</h3>
  Construisez votre première page en une semaine.
</course-card>
<course-card></course-card>

<script>
  customElements.define('course-card', class extends HTMLElement {
    constructor() {
      super()
      const template = document.getElementById('course-card-template')
      this.attachShadow({ mode: 'open' }).append(template.content.cloneNode(true))
    }
  })
</script>
Aperçu

La deuxième carte n’a aucun contenu, donc les slots affichent leur contenu par défaut.

Définition et utilisation

#

L’élément <slot> fonctionne à l’intérieur du Shadow DOM, la structure interne et isolée d’un composant web. Il marque l’endroit où doit apparaître le contenu écrit dans la page entre les balises du composant. Ainsi, un même composant, par exemple une carte de formation, peut afficher différents titres et descriptions.

Un slot nommé (<slot name="title">) accepte les éléments portant l’attribut slot="title", tandis qu’un slot sans nom reçoit tout le reste du contenu. Ce que vous écrivez à l’intérieur du <slot> lui-même est le contenu par défaut, visible lorsqu’aucun contenu n’est attribué au slot.

Les éléments insérés appartiennent toujours au DOM ordinaire de la page, vous les stylez donc avec du CSS normal. Depuis l’intérieur du composant, vous pouvez aussi les styler avec le sélecteur ::slotted(), et réagir aux changements de contenu avec l’événement slotchange.

Syntaxe

#
Syntaxe
<slot name="nom">Contenu par défaut</slot>

Attributs

#
  • name

    texte

    Le nom du slot. Les éléments du composant ayant un attribut slot de même valeur y sont placés. Un slot sans nom reçoit tout le reste du contenu.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Plus d’exemples

#
Sans JavaScript : Shadow DOM déclaratif
HTML
<user-badge>
  <template shadowrootmode="open">
    <style>
      .badge { display: inline-flex; gap: 8px; padding: 4px 12px; border-radius: 999px; background: #8b5cf633; }
    </style>
    <span class="badge">
      <slot name="level">Niveau 1</slot>
      <slot>Anonyme</slot>
    </span>
  </template>
  <b slot="level">Niveau 7</b>
  Anna
</user-badge>
Aperçu

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
slot {
  display: contents;
}

Compatibilité des navigateurs

#

Largement disponible · depuis 2020

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Ne confondez pas l’élément <slot> avec l’attribut slot. L’élément se trouve dans le Shadow DOM du composant, et l’attribut sur le contenu que vous y dirigez.
  • ::slotted() ne permet de styler que les éléments insérés directement, pas leurs descendants. Définissez les styles plus profonds dans le CSS ordinaire de la page.
  • <slot> n’a de sens qu’à l’intérieur d’un Shadow DOM. Placé dans le HTML ordinaire de la page, il ne fait rien de particulier.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.