Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori