Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

slot — affecter un élément à un slot du Shadow DOM

L’attribut global slot sélectionne un slot nommé du Shadow DOM où un élément est présenté. Sa valeur correspond à la valeur name de l’élément slot ; l’attribut et l’élément ont des rôles différents.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

slot="name"

L’attribut slot est autorisé sur tous les éléments HTML. Dans une affectation ordinaire fondée sur le nom, il sélectionne l’emplacement où un élément est présenté dans le Shadow DOM de son parent. À lui seul, l’attribut ne crée ni arbre d’ombre ni point d’insertion de contenu.

Ne confondez pas l’attribut slot de l’élément fourni avec l’élément slot à l’intérieur de l’arbre d’ombre. Le premier sélectionne un nom ; le second définit une destination portant ce nom au moyen de name. Les valeurs doivent correspondre exactement, y compris pour la casse. L’élément affecté doit être un enfant direct de l’hôte ; placer l’attribut sur un descendant plus éloigné ne suffit pas.

L’absence de l’attribut ou slot="" sélectionne le slot par défaut, qui est un slot sans nom. Un nom sans correspondance ne bascule pas vers le slot par défaut. Le contenu de remplacement à l’intérieur d’un élément slot est présenté lorsqu’aucun nœud ne lui est affecté. L’affectation ne déplace pas l’élément dans l’arbre DOM.

Dans l’exemple, span reste un enfant de host, mais est présenté à l’emplacement du slot dont name="label". Le texte attendu sur la page est Label: Hello. Après avoir remplacé la valeur par slot="other", le texte attendu est Label: Fallback.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>slot demo</title>
<div id="host"><span slot="label">Hello</span></div>
<script>
  const host = document.getElementById('host');
  const root = host.attachShadow({ mode: 'open' });
  root.innerHTML = '<p>Label: <slot name="label">Fallback</slot></p>';
</script>

Résultat

Label: Hello

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources