Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DocumentFragment — grupowanie węzłów DOM

DocumentFragment grupuje węzły DOM bez elementu opakowującego. Wstawienie fragmentu przenosi jego dzieci i pozostawia go pustym.

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 = new DocumentFragment();
// Alternative:
const otherFragment = document.createDocumentFragment();
fragment.append(node);
parent.appendChild(fragment);

DocumentFragment to węzeł DOM, nie element. Utwórz go przez new DocumentFragment() lub document.createDocumentFragment(), aby przygotować grupę dzieci poza drzewem dokumentu.

parent.appendChild(fragment) przenosi dzieci w kolejności, bez klonowania i bez opakowania. Fragment pozostaje pusty i można użyć go ponownie. Przykład sprawdza również zachowanie tożsamości węzła.

To Web API, nie funkcja ECMAScript. Przykład wymaga dokumentu przeglądarki; Node 24 nie dowodzi obsługi. Nie zakładaj gwarantowanego przyspieszenia.

Przykłady

(() => {
  const fragment = new DocumentFragment();
  const list = document.createElement('ul');
  const first = document.createElement('li');
  first.textContent = 'A';
  fragment.append(first);
  const second = document.createElement('li');
  second.textContent = 'B';
  fragment.append(second);

  list.appendChild(fragment);
  console.log(list.textContent);
  console.log(list.children.length);
  console.log(fragment.childNodes.length);
  console.log(list.firstChild === first);
})();

Wynik

AB
2
0
true

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

Źródła