WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

shadowrootclonable — Klonen einer deklarativen Shadow Root

Das boolesche Attribut shadowrootclonable eines template-Elements kennzeichnet eine deklarative Shadow Root als klonbar. Dadurch kann beim Kopieren des Host-Elements auch dessen Shadow Tree übernommen werden.

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

Syntax

<template shadowrootmode="open" shadowrootclonable>…</template>

shadowrootclonable ist ein boolesches Attribut von template, das zusammen mit shadowrootmode verwendet wird. Beim Erstellen einer deklarativen Shadow Root setzt der Parser anhand des Vorhandenseins des Attributs deren Klon-Flag. Ohne das Attribut ist das Flag false; das Attribut allein erstellt keine Shadow Root.

Ist die Root klonbar, kopiert host.cloneNode(true) auch ihren Shadow Tree. Das ist nicht dasselbe wie das gewöhnliche Kopieren des Template-Inhalts mit template.content.cloneNode(true): Hier wird der Host mit seiner bereits erstellten Shadow Root kopiert.

Das Vorhandensein aktiviert die Option: shadowrootclonable="false" aktiviert sie ebenfalls und ist keine gültige Möglichkeit, ein boolesches Attribut zu deaktivieren. Um die Option in der Deklaration auszuschalten, lasse das Attribut weg. shadowrootclonable ersetzt shadowrootserializable nicht: Das Klonen von Knoten und die HTML-Serialisierung sind getrennte Mechanismen.

Das Beispiel erfordert einen Browser, der deklarative Shadow Roots und dieses Attribut unterstützt. Öffne das vollständige HTML-Dokument, statt das Markup über innerHTML einzufügen. Der Modus open ermöglicht die Prüfung über copy.shadowRoot; der kopierte Host muss nicht in das Dokument eingefügt werden.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Shadow root cloning</title>
<div id="host"><template shadowrootmode="open" shadowrootclonable><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
  const host = document.getElementById('host');
  const copy = host.cloneNode(true);
  document.getElementById('result').textContent =
    copy.shadowRoot?.textContent ?? 'No shadow root';
</script>
</html>

Ergebnis

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