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

CKTIS / JavaScript

Document.getElementById() et documentElement : recherche par ID et élément racine

`getElementById()` recherche un élément par son ID exact, tandis que `documentElement` donne l’élément racine du document. Les deux peuvent donner `null`, mais pour des raisons différentes.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

doc.getElementById(id) // Element or null
doc.documentElement    // Element or null; read-only

doc.getElementById(id) parcourt l’arbre actuel de doc. Passez l’ID lui-même, par exemple 'Panel', sans lui ajouter le préfixe # d’un sélecteur CSS. La méthode respecte la casse et renvoie un Element ou null si rien ne correspond. Les ID des éléments HTML doivent être uniques au sein de leur arbre. En cas de doublon, la méthode renvoie le premier élément correspondant dans l’ordre de l’arbre.

La recherche ignore les éléments qui n’ont pas été insérés dans cet arbre et ceux qui se trouvent dans des arbres shadow DOM. Si le script s’exécute avant l’insertion, le résultat peut être null : vérifiez-le avant d’accéder à l’une de ses propriétés. Un nouvel appel relance la recherche, mais une référence déjà conservée ne change pas si l’élément est retiré.

doc.documentElement est une propriété en lecture seule, pas une méthode. Elle donne l’élément racine quel que soit son ID : html dans un document HTML typique, ou l’élément qui sert de racine en XML. Ce n’est ni le nœud Document lui-même ni body. Si aucun élément racine n’existe, la valeur est null.

Ces deux membres relèvent de l’API DOM du Web, et non d’ECMAScript 2024. La prise en charge de JavaScript ne garantit pas à elle seule la présence de document.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document ID lookup and root element</title>
</head>
<body>
  <script>
    (() => {
      const doc = document.implementation.createHTMLDocument('Demo');
      const panel = doc.createElement('div');
      panel.id = 'Panel';

      console.log(doc.documentElement.localName);
      console.log(doc.getElementById('Panel'));
      doc.body.appendChild(panel);
      console.log(doc.getElementById('Panel') === panel);
      console.log(doc.getElementById('panel'));
      console.log(new Document().documentElement);
    })();
  </script>
</body>
</html>

Résultat

html
null
true
null
null

Enregistrez l’exemple dans un fichier `.html`, ouvrez-le dans un navigateur et consultez les résultats dans la console de développement. L’exemple crée un document HTML séparé sans modifier la page courante. `'Panel'` n’est trouvé qu’après son insertion, `'panel'` ne correspond pas et un nouveau `Document` vide n’a pas d’élément racine.

Leçons associées

  • JavaScript · Leçon 19 · Avancé · Version : 4
  • JavaScript · Leçon 33 · Avancé · Version : 4

Sources