CKTIS / JavaScript
Posúvanie a nahrádzanie potomkov prvku: scrollTop, scrollHeight a replaceChildren()
Čítaj a nastavuj polohu posunu, rozlišuj celkovú výšku posúvateľnej oblasti od viditeľnej vnútornej výšky a nahrádzaj uzly potomkov bez spracovania reťazcov ako HTML.
Verzia: 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 je zvislý posun od začiatku posúvateľnej oblasti v CSS pixeloch. Vlastnosť možno čítať aj zapisovať a hodnota môže mať desatinnú časť. Priradenie požaduje absolútnu polohu, nie relatívny posun, so správaním auto. Pri flex-direction: column-reverse môže byť hodnota záporná a pružný efekt na hranici posunu ju v Safari môže dočasne dostať mimo obvyklého rozsahu.
scrollHeight je celočíselná výška celej posúvateľnej oblasti vrátane neviditeľnej časti. Je len na čítanie. Zahŕňa vnútorné odsadenie (padding) a môže zahŕňať pseudoprvky, ale nie rámček (border), vonkajší okraj (margin) ani vodorovný posúvač. clientHeight meria viditeľnú vnútornú výšku. Bez zvislého pretečenia sa obe výšky rovnajú.
V bežnom kontajneri s posunom nadol je el.scrollHeight - el.clientHeight približná hodnota scrollTop na dolnom konci. Ten over pomocou Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1 namiesto ===: výšky sú zaokrúhlené, no posun môže byť desatinný. Test nepoužívaj bez úprav pri obrátenom rozložení ani počas pružného efektu po prekročení hranice posunu.
replaceChildren() nahrádza všetky priame uzly potomkov, nie samotný prvok. Prijíma ľubovoľný počet objektov Node alebo reťazcov, existujúce uzly presúva namiesto klonovania a z reťazcov vytvára uzly Text bez spracovania HTML. Bez argumentov prvok vyprázdni. Vracia undefined; vloženie porušujúce hierarchiu stromu môže vyvolať HierarchyRequestError (výnimku typu DOMException).
Najprv nahraď obsah, potom zmeraj nové rozloženie a nastav polohu posunu, pretože rozsah sa môže zmeniť. ECMAScript 2024 je referenčná verzia jazyka JavaScript, nie verzia týchto API webovej platformy. Štandard DOM definuje replaceChildren() a CSSOM View definuje scrollTop, scrollHeight a clientHeight. Podpora závisí od verzie prehliadača; meranie vyžaduje mechanizmus na výpočet rozloženia stránky.
Príklady
<!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>Výsledok
160 100 true <b>Done</b> | 0 0
Ulož príklad ako súbor HTML, otvor ho v prehliadači a skontroluj výstup vo vývojárskej konzole. Výšky 160 a 100 dávajú rozsah posunu 60 CSS pixelov. `true` znamená dosiahnutie dolného konca v rámci tolerancie. Značky sa zobrazia ako doslovný text a posledná `0` znamená, že nezostal žiadny uzol potomka.
Súvisiace lekcie
- JavaScript · Lekcia 42 · Pokročilá · Verzia: 4