База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

shadowrootslotassignment — присвояване на възли към слотове

Атрибутът shadowrootslotassignment на template избира как да се присвояват възли към слотовете в декларативен shadow root: автоматично с named или изрично ръчно с manual.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

<template shadowrootmode="open" shadowrootslotassignment="named|manual">…</template>

shadowrootslotassignment е изброим атрибут на template, който задава присвояването към слотове при създаване на декларативен shadow root. Използвайте го с валиден shadowrootmode; сам по себе си не създава root. В синтаксиса named|manual означава да се избере една стойност, а не този текст да се въвежда буквално.

Стойността named включва автоматично съпоставяне между атрибута slot на дете на хоста и атрибута name на елемент slot в shadow дървото. Ако атрибутът липсва, стойността му е празна или невалидна, се избира състоянието named. Това не е булев атрибут: самото му наличие не включва ръчния режим.

Стойността manual изключва автоматичното присвояване по имена. Скрипт присвоява възли чрез HTMLSlotElement.assign(). Докато на даден слот няма присвоени възли, той представя собственото си резервно съдържание. В примера assign(item) присвоява елемент, който е пряко дете на хоста.

Настройката се прочита, когато парсерът създава root; последваща промяна на атрибута не преконфигурира съществуващ root. Примерът изисква поддръжка на този атрибут, а не само на декларативния Shadow DOM.

Примери

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

Резултат

0 -> 1: Hello

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници