Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

slot — miejsce na treść w Shadow DOM

Element slot wyznacza w drzewie Shadow DOM miejsce na przypisane węzły. Gdy ich nie ma, reprezentuje własną treść zastępczą.

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

Składnia

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

slot zwykle znajduje się w drzewie Shadow DOM. Reprezentuje przypisane węzły albo, gdy ich nie ma, własną treść zastępczą. Wymaga znacznika otwierającego i zamykającego.

Przy przypisywaniu według nazw name="title" na slot odpowiada slot="title" na elemencie będącym dzieckiem hosta. To różne atrybuty: name nazywa miejsce, a slot wskazuje miejsce docelowe. Slot bez nazwy jest miejscem domyślnym dla nieprzypisanej do nazwanego slotu treści o pustej nazwie slotu, w tym tekstu.

assignedElements() zwraca przypisane elementy, a assignedNodes() uwzględnia też węzły tekstowe. Bez opcji flatten metody te nie zwracają treści zastępczej jako przypisanych węzłów.

Przykłady

<!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>

Wynik

Hello
Fallback content

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła