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.