Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła