CKTIS / JavaScript
Document DOM : recherche par ID, élément racine et titre
Recherchez un élément par son ID exact, accédez à l’élément racine et lisez ou modifiez le titre du document. Distinguez un nœud absent d’une chaîne vide.
Version : Current web platform; runtime support varies
Syntaxe
document.getElementById(id)
document.documentElement
document.title
document.title = valuedocument.getElementById(id) recherche dans l’arbre du document un élément dont l’id correspond exactement à la valeur fournie, en respectant la casse. Passez l’ID seul, sans ajouter # : l’argument n’est pas un sélecteur CSS. La méthode renvoie un Element ou null ; vérifiez le résultat avant d’accéder aux propriétés de l’élément. Les ID doivent être uniques dans l’arbre. En cas de doublons, la méthode renvoie le premier élément correspondant dans l’ordre de l’arbre.
La recherche utilise l’arbre tel qu’il est au moment de l’appel. Elle ne trouve ni les éléments qui ne sont pas encore insérés dans le document ni ceux d’un arbre shadow distinct. document.documentElement est en lecture seule : cette propriété renvoie l’élément racine, normalement html dans un document HTML, ou null s’il n’y a pas de racine. Ce n’est pas document.body.
document.title est une propriété de type chaîne, accessible en lecture et en écriture. Ce n’est ni le nœud title, ni l’attribut title d’un élément, ni un titre visible dans la page. Dans un document HTML typique, la lecture supprime les blancs ASCII aux extrémités et remplace chaque suite interne par une seule espace. Sans élément title, elle renvoie "". L’affectation remplace le contenu du titre par du texte, sans l’interpréter comme du HTML. Si title manque, elle le crée dans head s’il existe ; sinon, elle reste sans effet. Si la racine est un svg dans l’espace de noms SVG, l’affectation met à jour ou crée un enfant direct title dans cet espace de noms, à partir duquel le titre est lu.
Ces API de la plateforme web sont définies par les standards DOM et HTML. Leur utilisation ne nécessite pas ECMAScript 2024. Pour un document affiché dans un onglet, le titre figure normalement sur cet onglet. Un environnement sans DOM n’est pas tenu de fournir document.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM document example</title>
</head>
<body>
<script>
{
const doc = document.implementation.createHTMLDocument("Draft");
const item = doc.createElement("p");
item.id = "status";
console.log(doc.title);
console.log(doc.getElementById("status") === null);
doc.body.append(item);
console.log(doc.getElementById("status") === item);
console.log(doc.getElementById("Status") === null);
console.log(doc.documentElement.localName);
doc.title = " Ready to publish ";
console.log(doc.title);
}
</script>
</body>
</html>Résultat
Draft true true true html Ready to publish
Enregistrez l’exemple complet dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console des outils de développement. L’exemple crée un document HTML distinct, sans changer la page courante ni le titre de l’onglet. Les trois valeurs `true` montrent, dans l’ordre, l’absence de résultat avant l’insertion, l’identité de l’objet après l’insertion et le respect de la casse.
Leçons associées
- JavaScript · Leçon 38 · Avancé · Version : 4