CKTIS / JavaScript
document.createDocumentFragment() — een DOM-fragment maken
document.createDocumentFragment() maakt een leeg DOM-fragment. Je kunt er knooppunten in verzamelen en ze daarna naar een bovenliggend element verplaatsen zonder een extra omhullend element toe te voegen.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const fragment = document.createDocumentFragment();document.createDocumentFragment() heeft geen argumenten en retourneert een nieuw, leeg DocumentFragment dat hoort bij het document waarop de methode wordt aangeroepen. Het is een DOM-knooppunt, geen element, en dient als tijdelijke container voor andere knooppunten.
Met target.appendChild(fragment) worden de kinderen van het fragment in hun bestaande volgorde aan target toegevoegd, niet het fragment zelf. De knooppunten worden verplaatst en niet gekopieerd, waardoor ze hun identiteit behouden. Het fragment wordt leeg en kan opnieuw worden gebruikt. appendChild() retourneert het doorgegeven fragment, niet de kinderen ervan.
Het voorbeeld gebruikt een niet-aangesloten target en verandert de zichtbare pagina dus niet. Voer het uit in een browser waarin document beschikbaar is; alleen een JavaScript-omgeving garandeert deze API niet.
Voorbeelden
{
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);
}Resultaat
AB 2 0 true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.