CKTIS / JavaScript
Elemente scrollen und Kindknoten ersetzen: scrollTop, scrollHeight und replaceChildren()
Lies und setze die Scrollposition, unterscheide die gesamte scrollbare Höhe von der sichtbaren Innenhöhe und ersetze Kindknoten, ohne Zeichenketten als HTML zu parsen.
Version: Current web platform; runtime support varies
Syntax
const offset = el.scrollTop;
el.scrollTop = y;
const contentHeight = el.scrollHeight;
const visibleHeight = el.clientHeight;
el.replaceChildren();
el.replaceChildren(node, "text");
el.replaceChildren(...items);scrollTop ist der les- und schreibbare vertikale Abstand vom Scrollursprung in CSS-Pixeln. Der Wert kann Nachkommastellen haben. Eine Zuweisung fordert mit dem Scrollverhalten auto eine absolute Position an, keine relative Verschiebung. Bei flex-direction: column-reverse sind negative Werte möglich; der Rückfedereffekt in Safari kann kurzzeitig Werte außerhalb des üblichen Bereichs liefern.
scrollHeight ist die schreibgeschützte ganzzahlige Höhe des gesamten Scrollbereichs, einschließlich des nicht sichtbaren Teils. Sie umfasst den Innenabstand und kann Pseudoelemente einbeziehen, nicht aber Rahmen, Außenabstand oder die horizontale Bildlaufleiste. clientHeight misst die sichtbare Innenhöhe. Ohne vertikalen Überlauf sind beide Höhen gleich.
In einem gewöhnlichen, nach unten scrollbaren Container nähert el.scrollHeight - el.clientHeight den Wert von scrollTop am unteren Ende an. Prüfe dieses Ende mit Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1 statt mit ===: Die Höhen sind gerundet, die Position kann Nachkommastellen haben. Verwende den Test bei umgekehrtem Layout oder während des Rückfederns nicht unverändert.
replaceChildren() ersetzt alle direkten Kindknoten, nicht das Element selbst. Die Methode akzeptiert beliebig viele Node-Objekte oder Zeichenketten, verschiebt vorhandene Knoten statt sie zu klonen und erzeugt aus Zeichenketten Text-Knoten, ohne HTML zu parsen. Ohne Argumente leert sie das Element. Sie gibt undefined zurück; eine Einfügung, die die Baumhierarchie verletzt, kann HierarchyRequestError auslösen, eine DOMException.
Ersetze zuerst den Inhalt, miss dann das neue Layout und setze die Scrollposition, da sich der Scrollbereich ändern kann. ECMAScript 2024 ist die zugrunde gelegte JavaScript-Sprachversion, keine Versionsangabe für diese Webplattform-APIs. Der DOM-Standard definiert replaceChildren(), CSSOM View definiert scrollTop, scrollHeight und clientHeight. Die Unterstützung hängt von der Browserversion ab; für die Messungen ist eine Layout-Engine erforderlich.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element scrolling and child replacement</title>
</head>
<body>
<script>
(() => {
const box = document.createElement('div');
box.style.cssText = 'width:200px;height:100px;padding:0;border:0;overflow-x:hidden;overflow-y:auto;scroll-behavior:auto';
box.textContent = 'Old content';
document.body.append(box);
try {
const row = document.createElement('div');
row.style.height = '160px';
box.replaceChildren(row);
const end = box.scrollHeight - box.clientHeight;
box.scrollTop = end;
const atBottom = Math.abs(end - box.scrollTop) <= 1;
console.log(`${box.scrollHeight} ${box.clientHeight} ${atBottom}`);
box.replaceChildren('<b>Done</b>');
console.log(`${box.textContent} | ${box.children.length}`);
box.replaceChildren();
console.log(box.childNodes.length);
} finally {
box.remove();
}
})();
</script>
</body>
</html>Ergebnis
160 100 true <b>Done</b> | 0 0
Speichere das Beispiel als HTML-Datei, öffne sie im Browser und prüfe die Ausgabe in der Entwicklerkonsole. Die Höhen 160 und 100 ergeben einen Scrollbereich von 60 CSS-Pixeln. `true` zeigt an, dass die Position innerhalb der Toleranz für das untere Ende liegt. Das Markup erscheint als Text; die abschließende `0` zeigt, dass keine Kindknoten übrig sind.
Zugehörige Lektionen
- JavaScript · Lektion 42 · Fortgeschritten · Version: 4