CKTIS / JavaScript
Element — DOM-Struktur, Geometrie und Scrollen
Element repräsentiert ein DOM-Element, nicht einen beliebigen Knoten. Es bietet Navigation, Attribute und den Austausch von Inhalten; im Browser außerdem Layoutmessungen und Scrollen. Unterscheide die Baumstruktur, die Abmessungen des Client-Bereichs und Rechtecke relativ zum Viewport.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
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äsentiert ein DOM-Element. Element.children ist eine Live-Sammlung direkter Element-Kinder und schließt Text und Kommentare aus. Element.parentElement, Element.previousElementSibling und Element.nextElementSibling geben ein Element oder null zurück. Element.tagName liefert den qualifizierten Namen; HTML-Elementnamen in HTML-Dokumenten werden großgeschrieben.
Element.hasAttribute(name) prüft, ob ein Attribut vorhanden ist. Element.toggleAttribute(name, force) erzwingt mit true das Vorhandensein und mit false das Fehlen; ohne force wird der Zustand umgeschaltet. Die Methode gibt das endgültige Vorhandensein zurück. Element.replaceChildren(...nodesOrStrings) ersetzt alle Kinder; Zeichenfolgen werden als Text, nicht als HTML behandelt. Ohne Argumente werden alle Kinder entfernt.
Bei einem typischen Blockelement liefern Element.clientWidth und Element.clientHeight die innere Breite und Höhe einschließlich Padding, aber ohne Rahmen und den von Scrollleisten belegten Platz. Bei einem gewöhnlichen Inline-span liefern beide Eigenschaften 0, selbst wenn es Padding und sichtbaren Inhalt hat. Im Standardmodus geben sie für das Wurzelelement die Abmessungen des Viewports ohne Scrollleisten zurück, nicht die seiner eigenen Padding-Box. Element.clientLeft und Element.clientTop geben den Abstand des Client-Bereichs von der Rahmenkante an; sie können eine Scrollleiste einschließen. Element.scrollHeight umfasst auch vertikal überlaufende Inhalte. Diese Messwerte sind Ganzzahlen. Das beschreibbare Element.scrollTop gibt den vertikalen Scrollversatz an und kann einen Bruchwert oder bei umgekehrten Layouts einen negativen Wert haben.
Element.getBoundingClientRect() gibt ein umschließendes Rechteck zurück; Element.getClientRects() liefert Rechtecke einzelner Fragmente, etwa für die einzelnen Zeilen eines Inline-Elements. Die Koordinaten beziehen sich auf den Viewport und berücksichtigen CSS-Transformationen. Element.scrollIntoView({ block: "nearest", behavior: "instant" }) scrollt Container, damit das Element sichtbar wird. Das Auslesen der Geometrie kann eine Layoutberechnung erzwingen; fasse solche Lesezugriffe vor Schreibzugriffen auf Stile zusammen.
Dies ist eine API der Browserumgebung, nicht von ECMAScript allein; Node 24 belegt nicht, dass sie verfügbar ist. Die DOM-Quelle definiert Struktur und Attribute, nicht die Geometrie- und Scrollalgorithmen von CSSOM View. Es werden keine Mindestversionen von Browsern angegeben; prüfe die benötigten Methoden in der Zielumgebung. Das Beispiel vermeidet bewusst Layoutmessungen.
Beispiele
(() => {
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);
})();Ergebnis
2 true true true true false 0 done
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.