CKTIS / HTML
shadowrootslotassignment — affectation des nœuds aux slots
L’attribut shadowrootslotassignment de template choisit la manière d’affecter les nœuds aux slots d’une racine fantôme déclarative : automatiquement avec named ou explicitement avec manual.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<template shadowrootmode="open" shadowrootslotassignment="named|manual">…</template>shadowrootslotassignment est un attribut à valeurs énumérées de template qui configure l’affectation aux slots lors de la création d’une racine fantôme déclarative. Utilisez-le avec un shadowrootmode valide ; à lui seul, il ne crée pas de racine. Dans la syntaxe, named|manual signifie qu’il faut choisir une valeur, et non saisir littéralement ce texte.
La valeur named active la correspondance automatique entre l’attribut slot d’un enfant de l’hôte et l’attribut name d’un élément slot dans l’arbre fantôme. L’absence de l’attribut, une valeur vide ou une valeur non valide sélectionnent toutes l’état named. Ce n’est pas un attribut booléen : sa seule présence n’active pas le mode manuel.
La valeur manual désactive l’affectation automatique fondée sur les noms. Un script affecte les nœuds avec HTMLSlotElement.assign(). Tant qu’un slot n’a pas de nœuds affectés, il représente son propre contenu de remplacement. Dans l’exemple, assign(item) affecte un élément qui est un enfant direct de l’hôte.
Le réglage est lu lorsque l’analyseur crée la racine ; modifier l’attribut par la suite ne reconfigure pas une racine existante. L’exemple nécessite la prise en charge de cet attribut, et pas seulement celle du Shadow DOM déclaratif.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>Manual slot assignment</title>
<div id="host">
<template shadowrootmode="open" shadowrootslotassignment="manual">
<slot>Fallback</slot>
</template>
<span id="item">Hello</span>
</div>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
const item = document.getElementById('item');
const slot = host.shadowRoot.querySelector('slot');
const before = slot.assignedNodes().length;
slot.assign(item);
const after = slot.assignedNodes().length;
document.getElementById('result').textContent =
`${before} -> ${after}: ${slot.assignedNodes()[0].textContent}`;
</script>Résultat
0 -> 1: 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.