Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

ShadowRoot.append — přidávání uzlů a textu do stínového stromu

ShadowRoot.append přidává uzly a text na konec stínového stromu. Metoda je zděděná z DocumentFragment, nejde o samostatnou implementaci. Zjistěte, jak se uzly přesouvají, jak se fragment vyprázdní a v čem se appendChild() liší.

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

Syntaxe

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

ShadowRoot.append je zděděná metoda DocumentFragment.append: ShadowRoot dědí z DocumentFragment. Volání root.append(...) přidá obsah za poslední dítě stínového kořene, nikoli mezi běžné děti hostitelského elementu. Běžný fragment naopak slouží k sestavení podstromu před jeho vložením na cílové místo.

Metoda přijímá více uzlů a řetězců v pořadí argumentů. Řetězce se stanou uzly Text; neparsují se jako HTML. Existující uzel se přesune, nezkopíruje. Předání běžného DocumentFragment přesune jeho děti a fragment zůstane prázdný; samotný fragment se dítětem kořene nestane.

Výsledkem je undefined. Na rozdíl od append() přijímá appendChild() jeden uzel, přímo nepodporuje řetězcové argumenty a vrací přidaný uzel nebo vyprázdněný fragment. Neplatné vložení, například takové, které vytvoří cyklus, může vyvolat DOMException HierarchyRequestError.

Jde o DOM API, nikoli o funkci konkrétní edice ECMAScriptu. MDN označuje DocumentFragment.append() za široce dostupné napříč prohlížeči od dubna 2018; použití na stínovém kořeni vyžaduje také podporu Shadow DOM. Samotná přítomnost Node 24 v repozitáři nedokládá podporu těchto API prohlížeče.

Příklady

(() => {
  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);
})();

Výsledek

Hello DOM!
3
0
true
0
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje