CKTIS / JavaScript
Przewijanie i zastępowanie dzieci elementu: scrollTop, scrollHeight i replaceChildren()
Odczytuj i ustawiaj pozycję przewijania, odróżniaj wysokość całej przewijanej zawartości od wysokości widocznego obszaru i zastępuj węzły potomne bez parsowania tekstu jako HTML.
Wersja: Current web platform; runtime support varies
Składnia
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 to właściwość do odczytu i zapisu: podaje pionowe przesunięcie od początku obszaru przewijania w pikselach CSS. Wynik może być ułamkowy. Przypisanie ustawia docelową pozycję bezwzględną, a nie przesunięcie względem bieżącej pozycji; obowiązuje zachowanie przewijania auto. Przy flex-direction: column-reverse wartości mogą być ujemne, a efekt odbicia w Safari może chwilowo wyprowadzić je poza zwykły zakres.
scrollHeight to całkowita, dostępna tylko do odczytu wysokość obszaru przewijania, także jego niewidocznej części. Uwzględnia padding i może uwzględniać pseudoelementy, ale nie obejmuje obramowania, marginesu ani poziomego paska przewijania. clientHeight podaje wysokość widocznego obszaru wewnętrznego. Bez pionowego przepełnienia te wysokości są równe.
W zwykłym kontenerze przewijanym w dół el.scrollHeight - el.clientHeight przybliża końcową wartość scrollTop. Sprawdzaj dół wyrażeniem Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1, nie przez ===: wysokości są zaokrąglone, a pozycja może być ułamkowa. Nie stosuj tego testu bez zmian do odwróconego układu ani podczas efektu odbicia.
replaceChildren() zastępuje wszystkie bezpośrednie węzły potomne, nie sam element. Przyjmuje dowolną liczbę argumentów typu Node lub łańcuchów znaków; istniejące węzły przenosi, zamiast je klonować, a z łańcuchów tworzy węzły Text bez parsowania HTML. Bez argumentów opróżnia element. Zwraca undefined; próba wstawienia naruszająca hierarchię drzewa może zgłosić HierarchyRequestError (DOMException).
Najpierw zastąp zawartość, potem zmierz nowy układ i ustaw przewinięcie, ponieważ zakres przewijania może się zmienić. ECMAScript 2024 to wersja odniesienia dla języka JavaScript, a nie wersja tych interfejsów platformy webowej. Standard DOM definiuje replaceChildren(), a CSSOM View definiuje scrollTop, scrollHeight i clientHeight. Obsługa zależy od wersji przeglądarki; do pomiarów potrzebny jest także mechanizm układu strony.
Przykłady
<!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>Wynik
160 100 true <b>Done</b> | 0 0
Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź komunikaty w konsoli deweloperskiej. Wysokości 160 i 100 dają zakres przewijania 60 pikseli CSS. `true` oznacza osiągnięcie dołu w granicach tolerancji. Znaczniki pojawiają się jako tekst, a ostatnie `0` oznacza, że nie pozostał żaden węzeł potomny.
Powiązane lekcje
- JavaScript · Lekcja 42 · Zaawansowany · Wersja: 4