Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

document.createDocumentFragment() — tworzenie fragmentu DOM

document.createDocumentFragment() tworzy pusty fragment DOM. Możesz zgromadzić w nim węzły, a następnie przenieść je do rodzica bez dodawania dodatkowego elementu opakowującego.

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

Składnia

const fragment = document.createDocumentFragment();

document.createDocumentFragment() nie przyjmuje argumentów i zwraca nowy, pusty DocumentFragment powiązany z dokumentem wywołania. To węzeł DOM, nie element; służy jako tymczasowy pojemnik na inne węzły.

Przy target.appendChild(fragment) do target trafiają dzieci fragmentu w dotychczasowej kolejności, nie sam fragment. Węzły są przenoszone, nie kopiowane, więc zachowują tożsamość. Fragment pozostaje pusty i można użyć go ponownie. appendChild() zwraca przekazany fragment, a nie jego dzieci.

Przykład używa odłączonego target, więc nie zmienia widocznej strony. Uruchom go w przeglądarce z dostępnym document; samo środowisko JavaScript nie gwarantuje tego API.

Przykłady

{
  const fragment = document.createDocumentFragment();
  const target = document.createElement('ul');

  for (const label of ['A', 'B']) {
    const item = document.createElement('li');
    item.textContent = label;
    fragment.appendChild(item);
  }

  const first = fragment.firstChild;
  const returned = target.appendChild(fragment);

  console.log(target.textContent);
  console.log(target.childNodes.length);
  console.log(fragment.childNodes.length);
  console.log(target.firstChild === first);
  console.log(returned === fragment);
}

Wynik

AB
2
0
true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła