CKTIS / JavaScript
Превъртане и замяна на дъщерни възли: scrollTop, scrollHeight и replaceChildren()
Чети и задавай позицията на превъртане, различавай пълната височина на областта за превъртане от видимата вътрешна височина и заменяй дъщерни възли, без да обработваш низовете като HTML.
Версия: Current web platform; runtime support varies
Синтаксис
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 е вертикалното отместване от началната точка на превъртане, в CSS пиксели. Свойството е достъпно за четене и запис, а стойността може да е дробна. Присвояването задава абсолютна целева позиция, а не относително преместване, с поведение auto. При flex-direction: column-reverse стойността може да е отрицателна, а отскачането в Safari може временно да я изведе извън обичайния диапазон.
scrollHeight е целочислената височина на цялата област за превъртане, включително невидимата част. Свойството е само за четене. Включва вътрешния отстъп (padding) и може да включва псевдоелементи, но изключва рамката, външния отстъп и хоризонталната лента за превъртане. clientHeight измерва видимата вътрешна височина. Без вертикално препълване двете височини са равни.
В обикновен контейнер с превъртане надолу el.scrollHeight - el.clientHeight е приблизителната стойност на scrollTop в долния край. Провери дали си там с Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1, а не с ===: височините са закръглени, но отместването може да е дробно. Не използвай теста без промени при обърната подредба или по време на отскачане.
replaceChildren() заменя всички преки дъщерни възли, а не самия елемент. Приема произволен брой обекти Node или низове, премества съществуващите възли, вместо да ги клонира, и превръща низовете във възли Text, без да ги анализира като HTML. Без аргументи изпразва елемента. Връща undefined; вмъкване, което нарушава йерархията на дървото, може да предизвика HierarchyRequestError (изключение от тип DOMException).
Първо замени съдържанието, после измери новата подредба и задай позицията на превъртане, защото диапазонът може да се промени. ECMAScript 2024 е референтната версия на езика JavaScript, а не версия на тези програмни интерфейси на уеб платформата. Стандартът DOM определя replaceChildren(), а CSSOM View определя scrollTop, scrollHeight и clientHeight. Поддръжката зависи от версията на браузъра, а измерванията изискват механизъм за изчисляване на оформлението.
Примери
<!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>Резултат
160 100 true <b>Done</b> | 0 0
Запази примера като HTML файл, отвори го в браузър и провери съобщенията в конзолата за разработчици. Височините 160 и 100 дават диапазон на превъртане от 60 CSS пиксела. `true` означава, че позицията е в рамките на допуска за долния край. Таговете се извеждат като буквален текст, а последната `0` показва, че няма останали дъщерни възли.
Свързани уроци
- JavaScript · Урок 42 · Напреднало · Версия: 4