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

CKTIS / HTML

slot — emplacement de contenu dans le Shadow DOM

L’élément slot marque, dans un arbre Shadow DOM, un emplacement destiné aux nœuds assignés. Si aucun n’est assigné, il représente son propre contenu de repli.

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

Syntaxe

<slot name="title">Fallback title</slot>
<slot>Fallback content</slot>

slot se trouve généralement dans un arbre Shadow DOM. Il représente les nœuds assignés ou, si aucun n’est assigné, son propre contenu de repli. Les balises ouvrante et fermante sont toutes deux nécessaires.

Avec l’assignation par nom, name="title" sur slot correspond à slot="title" sur un élément enfant de l’hôte. Ce sont deux attributs différents : name nomme l’emplacement, tandis que slot sélectionne sa destination. Un slot sans nom est la destination par défaut du contenu dont le nom de slot est vide, y compris le texte, et non du contenu assigné à un slot nommé.

assignedElements() renvoie les éléments assignés, tandis que assignedNodes() inclut également les nœuds texte. Sans l’option flatten, ces méthodes ne renvoient pas le contenu de repli comme des nœuds assignés.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Slot example</title>
<div id="host"><span slot="title">Hello</span></div>
<script>
  const host = document.getElementById('host');
  const root = host.attachShadow({ mode: 'open' });
  root.innerHTML = '<p><slot name="title">Fallback title</slot></p><p><slot>Fallback content</slot></p>';
  const titleSlot = root.querySelector('slot[name="title"]');
  console.log(titleSlot.assignedElements()[0].textContent);
</script>
</html>

Résultat

Hello
Fallback content

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