CKTIS / JavaScript
Pomicanje sadržaja i zamjena djece elementa: scrollTop, scrollHeight i replaceChildren()
Očitaj i postavi položaj pomicanja, razlikuj ukupnu visinu područja pomicanja od vidljive unutarnje visine i zamijeni čvorove djecu bez raščlanjivanja nizova kao HTML-a.
Verzija: Current web platform; runtime support varies
Sintaksa
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 okomiti pomak od početne točke pomicanja u CSS pikselima. Svojstvo se može čitati i zapisivati, a vrijednost može imati decimalni dio. Dodjela traži apsolutni položaj, a ne relativni pomak, uz ponašanje auto. Uz flex-direction: column-reverse vrijednost može biti negativna; efekt odskoka u Safariju može je privremeno izvesti iz uobičajenog raspona.
scrollHeight je cjelobrojna visina cijelog područja pomicanja, uključujući nevidljivi dio. Svojstvo je samo za čitanje. Uključuje unutarnji razmak (padding) i može uključivati pseudoelemente, ali ne i obrub, vanjsku marginu ni vodoravnu traku za pomicanje. clientHeight mjeri vidljivu unutarnju visinu. Ako nema okomitog prelijevanja, visine su jednake.
U uobičajenom spremniku koji se pomiče prema dolje, el.scrollHeight - el.clientHeight približna je vrijednost scrollTop na dnu. Provjeri dno izrazom Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1 umjesto operatorom ===: visine su zaokružene, a pomak može imati decimalni dio. Ne primjenjuj test bez prilagodbe na obrnuti raspored ni tijekom odskoka.
replaceChildren() zamjenjuje sve izravne čvorove djecu, a ne sam element. Prima proizvoljan broj objekata Node ili znakovnih nizova, premješta postojeće čvorove umjesto da ih klonira i pretvara nizove u čvorove Text bez raščlanjivanja HTML-a. Bez argumenata prazni element. Vraća undefined; umetanje koje krši hijerarhiju stabla može izazvati HierarchyRequestError (iznimku vrste DOMException).
Najprije zamijeni sadržaj, zatim izmjeri novi raspored i postavi položaj pomicanja jer se raspon može promijeniti. ECMAScript 2024 referentna je verzija jezika JavaScript, a ne verzija tih API-ja web-platforme. Standard DOM definira replaceChildren(), a CSSOM View definira scrollTop, scrollHeight i clientHeight. Podrška ovisi o verziji preglednika; za mjerenja je potreban mehanizam za izračun rasporeda.
Primjeri
<!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>Rezultat
160 100 true <b>Done</b> | 0 0
Spremi primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u konzoli za razvojne programere. Visine 160 i 100 daju raspon pomicanja od 60 CSS piksela. `true` znači da je položaj unutar tolerancije za dno. Oznake se ispisuju kao doslovan tekst, a posljednja `0` znači da nije ostao nijedan čvor dijete.
Povezane lekcije
- JavaScript · Lekcija 42 · Napredno · Verzija: 4