CKTIS / JavaScript
Element — structure DOM, géométrie et défilement
Element représente un élément DOM, et non un nœud quelconque. Il fournit la navigation, la gestion des attributs et le remplacement du contenu ; dans un navigateur, il expose aussi les mesures de mise en page et le défilement. Distinguez la structure de l’arbre, les dimensions de la zone client et les rectangles relatifs à la fenêtre.
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
element.clientWidth; element.clientHeight; element.clientLeft; element.clientTop; element.scrollHeight; element.scrollTop; element.scrollTop = y; element.getBoundingClientRect(); element.getClientRects(); element.scrollIntoView({ block: "nearest", behavior: "instant" }); element.replaceChildren(...nodesOrStrings); element.children; element.tagName; element.parentElement; element.previousElementSibling; element.nextElementSibling; element.hasAttribute(name); element.toggleAttribute(name, force);Element représente un élément DOM. Element.children est une collection vivante des enfants directs qui sont des éléments ; elle exclut le texte et les commentaires. Element.parentElement, Element.previousElementSibling et Element.nextElementSibling renvoient un élément ou null. Element.tagName donne le nom qualifié ; dans les documents HTML, les noms des éléments HTML sont en majuscules.
Element.hasAttribute(name) vérifie la présence d’un attribut. Element.toggleAttribute(name, force) impose sa présence avec true et son absence avec false ; sans force, inverse l’état. La méthode renvoie l’état final de présence. Element.replaceChildren(...nodesOrStrings) remplace tous les enfants ; les chaînes deviennent du texte, et non du HTML. Sans argument, tous les enfants sont supprimés.
Pour un élément de bloc typique, Element.clientWidth et Element.clientHeight donnent la largeur et la hauteur intérieures, marge intérieure comprise, sans les bordures ni l’espace occupé par les barres de défilement. Pour un span en ligne ordinaire, les deux propriétés renvoient 0, même si l’élément a une marge intérieure et que son contenu est affiché. En mode standard, pour l’élément racine, elles renvoient les dimensions de la zone d’affichage hors barres de défilement, et non celles de sa propre boîte de marge intérieure. Element.clientLeft et Element.clientTop donnent le décalage de la zone client par rapport au bord de la bordure ; ils peuvent inclure une barre de défilement. Element.scrollHeight comprend le contenu qui dépasse verticalement. Ces mesures sont des nombres entiers. Element.scrollTop, qui peut être modifié, donne le décalage vertical de défilement et peut être fractionnaire, voire négatif dans des mises en page inversées.
Element.getBoundingClientRect() renvoie un rectangle englobant ; Element.getClientRects() renvoie les rectangles des fragments, par exemple ceux des différentes lignes d’un élément en ligne. Les coordonnées sont relatives à la fenêtre et tiennent compte des transformations CSS. Element.scrollIntoView({ block: "nearest", behavior: "instant" }) fait défiler les conteneurs pour rendre l’élément visible. La lecture de la géométrie peut forcer le calcul de la mise en page ; regroupez ces lectures avant les écritures de styles.
Il s’agit d’une API de l’environnement du navigateur, et non d’ECMAScript à lui seul ; Node 24 ne prouve pas sa disponibilité. La source DOM définit la structure et les attributs, pas les algorithmes de géométrie et de défilement de CSSOM View. Aucune version minimale de navigateur n’est indiquée ; vérifiez la présence des méthodes requises dans l’environnement cible. L’exemple évite volontairement les mesures de mise en page.
Exemples
(() => {
const box = document.createElement("div");
const first = document.createElement("span");
const last = document.createElement("span");
box.replaceChildren(first, "text", last);
box.toggleAttribute("data-ready", true);
console.log(box.children.length);
console.log(first.parentElement === box);
console.log(first.nextElementSibling === last);
console.log(last.previousElementSibling === first);
console.log(box.hasAttribute("data-ready"));
console.log(box.toggleAttribute("data-ready", false));
box.replaceChildren("done");
console.log(box.children.length, box.textContent);
})();Résultat
2 true true true true false 0 done
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.