WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

shadowrootslotassignment — Knoten Slots zuweisen

Das Attribut shadowrootslotassignment von template legt fest, wie Knoten Slots in einer deklarativen Shadow-Root zugewiesen werden: automatisch mit named oder ausdrücklich manuell mit manual.

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

Syntax

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

shadowrootslotassignment ist ein enumeriertes Attribut von template, das die Slot-Zuweisung beim Erstellen einer deklarativen Shadow-Root konfiguriert. Verwende es zusammen mit einem gültigen shadowrootmode; allein erstellt es keine Root. In der Syntax bedeutet named|manual, dass einer der Werte gewählt wird, nicht dass der Text wörtlich so lautet.

Der Wert named aktiviert den automatischen Abgleich zwischen dem slot-Attribut eines Host-Kindes und dem name-Attribut eines slot-Elements im Shadow Tree. Ein fehlendes Attribut, ein leerer Wert und ein ungültiger Wert wählen alle den Zustand named. Dies ist kein boolesches Attribut: Seine bloße Anwesenheit aktiviert nicht den manuellen Modus.

Der Wert manual deaktiviert die automatische namensbasierte Zuweisung. Ein Skript weist Knoten mit HTMLSlotElement.assign() zu. Solange einem Slot keine Knoten zugewiesen sind, wird sein eigener Fallback-Inhalt dargestellt. Im Beispiel weist assign(item) ein Element zu, das direktes Kind des Hosts ist.

Die Einstellung wird gelesen, wenn der Parser die Root erstellt; eine spätere Änderung des Attributs konfiguriert eine bestehende Root nicht neu. Das Beispiel setzt Unterstützung für dieses Attribut voraus, nicht nur für deklaratives Shadow DOM.

Beispiele

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

Ergebnis

0 -> 1: Hello

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen