Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

shadowrootclonable — kloniranje deklarativnega senčnega korena

Logični atribut shadowrootclonable na elementu template označi deklarativni senčni koren kot klonljiv. Kopiranje gostiteljskega elementa lahko tako vključuje tudi njegovo senčno drevo.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

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

shadowrootclonable je logični atribut elementa template, ki se uporablja skupaj z shadowrootmode. Ob ustvarjanju deklarativnega senčnega korena razčlenjevalnik nastavi njegovo zastavico klonljivosti glede na prisotnost atributa. Če atributa ni, je zastavica false; sam atribut ne ustvari senčnega korena.

Če je koren klonljiv, host.cloneNode(true) kopira tudi njegovo senčno drevo. To ni običajno kopiranje vsebine predloge z template.content.cloneNode(true): kopira se gostitelj z že ustvarjenim senčnim korenom.

Prisotnost atributa možnost vklopi: shadowrootclonable="false" jo prav tako vklopi in ni veljaven način za izklop logičnega atributa. Če želite to možnost v deklaraciji izklopiti, atribut izpustite. shadowrootclonable ne nadomešča shadowrootserializable: kloniranje vozlišč in serializacija HTML sta ločena mehanizma.

Primer zahteva brskalnik, ki podpira deklarativne senčne korene in ta atribut. Odprite celoten dokument HTML, namesto da bi oznake vstavili prek innerHTML. Način open omogoča pregled kopije prek copy.shadowRoot; kopiranega gostitelja ni treba dodati v dokument.

Primeri

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

Rezultat

Hello

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri