CKTIS / HTML
shadowrootslotassignment — przypisywanie węzłów do slotów
Atrybut shadowrootslotassignment elementu template wybiera sposób przypisywania węzłów do slotów w deklaratywnym korzeniu cienia: automatyczny named albo ręczny manual.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<template shadowrootmode="open" shadowrootslotassignment="named|manual">…</template>shadowrootslotassignment jest atrybutem wyliczeniowym elementu template, który konfiguruje przypisywanie węzłów do slotów podczas tworzenia deklaratywnego korzenia cienia. Używaj go razem z poprawnym shadowrootmode; sam nie tworzy korzenia. W zapisie składni named|manual oznacza wybór jednej wartości, nie dosłowny tekst.
Wartość named włącza automatyczne dopasowanie atrybutu slot dziecka hosta do atrybutu name elementu slot w drzewie cienia. Brak atrybutu, pusta wartość i nieprawidłowa wartość wybierają stan named. To nie jest atrybut logiczny: sama jego obecność nie włącza trybu ręcznego.
Wartość manual wyłącza automatyczne przypisywanie według nazw. Skrypt przypisuje węzły metodą HTMLSlotElement.assign(). Dopóki slot nie ma przypisanych węzłów, reprezentuje własną zawartość zastępczą. W przykładzie assign(item) przypisuje element będący bezpośrednim dzieckiem hosta.
Ustawienie jest odczytywane przy tworzeniu korzenia przez parser; późniejsza zmiana atrybutu nie rekonfiguruje istniejącego korzenia. Przykład wymaga obsługi tego atrybutu, a nie tylko deklaratywnego Shadow DOM.
Przykłady
<!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>Wynik
0 -> 1: Hello
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.