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

CKTIS / JavaScript

ShadowRoot.append — dodajanje vozlišč in besedila v senčno drevo

ShadowRoot.append doda vozlišča in besedilo na konec senčnega drevesa. Metodo podeduje od DocumentFragment; ne gre za ločeno implementacijo. Spoznajte premikanje vozlišč, praznjenje fragmenta in razliko v primerjavi z appendChild().

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

shadowRoot.append(...nodesOrStrings);
fragment.append(...nodesOrStrings);

ShadowRoot.append je podedovana metoda DocumentFragment.append: ShadowRoot deduje od DocumentFragment. Klic root.append(...) doda vsebino za zadnjim otrokom senčnega korena, ne pa med običajne otroke gostiteljskega elementa. Običajni fragment pa služi za sestavljanje poddrevesa, preden ga vstavimo na cilj.

Metoda sprejme več vozlišč in nizov v vrstnem redu argumentov. Nizi postanejo vozlišča Text; ne razčlenijo se kot HTML. Obstoječe vozlišče se premakne, ne kopira. Če podate običajni DocumentFragment, se njegovi otroci premaknejo, fragment pa ostane prazen; sam fragment ne postane otrok korena.

Rezultat je undefined. V nasprotju z append() metoda appendChild() sprejme eno vozlišče, ne podpira neposredno nizov kot argumentov in vrne dodano vozlišče ali izpraznjeni fragment. Neveljaven vstavek, na primer tak, ki ustvari cikel, lahko sproži DOMException HierarchyRequestError.

To je API DOM, ne funkcija določene izdaje ECMAScripta. MDN označuje DocumentFragment.append() kot široko dostopen v brskalnikih od aprila 2018; uporaba na senčnem korenu zahteva tudi podporo za Shadow DOM. Sama prisotnost Node 24 v repozitoriju ne dokazuje podpore za te API-je brskalnika.

Primeri

(() => {
  const host = document.createElement("div");
  const root = host.attachShadow({ mode: "open" });
  const fragment = document.createDocumentFragment();
  const label = document.createElement("strong");
  label.textContent = "DOM";

  fragment.append("Hello ", label);
  const result = root.append(fragment, "!");

  console.log(root.textContent);
  console.log(root.childNodes.length);
  console.log(fragment.childNodes.length);
  console.log(label.parentNode === root);
  console.log(host.childNodes.length);
  console.log(result === undefined);
})();

Rezultat

Hello DOM!
3
0
true
0
true

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

Viri