CKTIS / JavaScript
document.createDocumentFragment() — créer un fragment DOM
document.createDocumentFragment() crée un fragment DOM vide. Vous pouvez y regrouper des nœuds, puis les déplacer dans un parent sans ajouter d’élément enveloppe supplémentaire.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const fragment = document.createDocumentFragment();document.createDocumentFragment() ne prend aucun argument et renvoie un nouveau DocumentFragment vide, associé au document appelant. C’est un nœud DOM, et non un élément ; il sert de conteneur temporaire pour d’autres nœuds.
Avec target.appendChild(fragment), les enfants du fragment sont ajoutés à target dans leur ordre actuel, et non le fragment lui-même. Les nœuds sont déplacés, pas copiés, et conservent donc leur identité. Le fragment devient vide et peut être réutilisé. appendChild() renvoie le fragment fourni, pas ses enfants.
L’exemple utilise un target détaché ; il ne modifie donc pas la page visible. Exécutez-le dans un navigateur où document est disponible ; un environnement JavaScript seul ne garantit pas la présence de cette API.
Exemples
{
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);
}Résultat
AB 2 0 true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.