Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources