<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
Exemple
#<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>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
#<slot name="nom">Contenu par défaut</slot>Attributs
#name
texte
Le nom du slot. Les éléments du composant ayant un attributslotde 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
#<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>CSS par défaut
#La plupart des navigateurs affichent cet élément avec ces styles par défaut :
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’attributslot. 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.