Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Drsenje in zamenjava otrok elementa: scrollTop, scrollHeight in replaceChildren()

Preberi in nastavi položaj drsenja, razlikuj celotno višino drsnega območja od vidne notranje višine in zamenjaj otroška vozlišča, ne da bi nize razčlenil kot HTML.

Različica: 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 navpični odmik od izhodišča drsenja v slikovnih pikah CSS. Lastnost lahko bereš in zapisuješ, vrednost pa je lahko decimalna. Prireditev zahteva absolutni položaj, ne relativnega premika, z načinom drsenja auto. Pri flex-direction: column-reverse so možne negativne vrednosti, učinek odboja v Safariju pa lahko vrednost začasno potisne iz običajnega območja.

scrollHeight je celoštevilska višina celotnega območja drsenja, vključno z nevidnim delom. Lastnost je samo za branje. Vključuje notranji odmik (padding) in lahko vključuje psevdoelemente, ne pa roba (border), zunanjega odmika (margin) ali vodoravnega drsnika. clientHeight meri vidno notranjo višino. Če vsebina navpično ne sega čez rob, sta višini enaki.

V običajnem vsebniku, ki drsi navzdol, je el.scrollHeight - el.clientHeight približek za scrollTop na dnu. Dno preveri z Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1 namesto z ===: višini sta zaokroženi, odmik pa je lahko decimalen. Preizkusa ne uporabi brez prilagoditve pri obrnjeni postavitvi ali med odbojem.

replaceChildren() zamenja vsa neposredna otroška vozlišča, ne samega elementa. Sprejme poljubno število objektov Node ali nizov, obstoječa vozlišča premakne, namesto da bi jih klonirala, in iz nizov ustvari vozlišča Text brez razčlenjevanja HTML-ja. Brez argumentov izprazni element. Vrne undefined; vstavljanje, ki krši hierarhijo drevesa, lahko sproži HierarchyRequestError (izjemo vrste DOMException).

Najprej zamenjaj vsebino, nato izmeri novo postavitev in nastavi položaj drsenja, saj se lahko njegov razpon spremeni. ECMAScript 2024 je referenčna različica jezika JavaScript, ne različica teh API-jev spletne platforme. Standard DOM določa replaceChildren(), CSSOM View pa določa scrollTop, scrollHeight in clientHeight. Podpora je odvisna od različice brskalnika; za meritve je potreben pogon za izračun postavitve.

Primeri

<!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

Shrani primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v konzoli za razvijalce. Višini 160 in 100 dasta razpon 60 slikovnih pik CSS. `true` pomeni, da je položaj znotraj tolerance za dno. Oznake se izpišejo kot dobesedno besedilo, zadnja `0` pa pomeni, da ni ostalo nobeno otroško vozlišče.

Povezane lekcije

  • JavaScript · Lekcija 42 · Napredna · Različica: 4

Viri