KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Scrollen en kindknopen vervangen: scrollTop, scrollHeight en replaceChildren()

Lees en wijzig de scrollpositie, onderscheid de totale hoogte van het scrollgebied van de zichtbare binnenhoogte en vervang kindknopen zonder tekenreeksen als HTML te verwerken.

Versie: 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 is de verticale afstand vanaf het scrollbeginpunt in CSS-pixels. Je kunt de eigenschap lezen en schrijven; de waarde kan een fractie bevatten. Een toewijzing vraagt om een absolute positie, niet om een relatieve verplaatsing, met scrollgedrag auto. Bij flex-direction: column-reverse zijn negatieve waarden mogelijk. Door het terugveereffect van Safari kan de waarde tijdelijk buiten het gebruikelijke bereik komen.

scrollHeight is de alleen-lezen hoogte van het volledige scrollgebied als geheel getal, inclusief het deel buiten beeld. De hoogte omvat padding en kan pseudo-elementen meetellen, maar niet de rand, marge of horizontale schuifbalk. clientHeight meet de zichtbare binnenhoogte. Zonder verticale overflow zijn beide hoogtes gelijk.

In een gewone container die omlaag scrolt, benadert el.scrollHeight - el.clientHeight de waarde van scrollTop onderaan. Controleer met Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1 in plaats van === of je onderaan bent: de hoogtes zijn afgerond, maar de positie kan een fractie bevatten. Gebruik deze test niet ongewijzigd bij een omgekeerde lay-out of tijdens het terugveren.

replaceChildren() vervangt alle directe kindknopen, niet het element zelf. De methode accepteert een willekeurig aantal Node-objecten of tekenreeksen, verplaatst bestaande knopen in plaats van ze te klonen en zet tekenreeksen om in Text-knopen zonder HTML te verwerken. Zonder argumenten maakt de methode het element leeg. Ze retourneert undefined; invoegen in strijd met de boomhiërarchie kan leiden tot HierarchyRequestError (een DOMException).

Vervang eerst de inhoud, meet daarna de nieuwe lay-out en stel de scrollpositie in, want het scrollbereik kan veranderen. ECMAScript 2024 is de referentieversie van de taal JavaScript, geen versie van deze webplatform-API’s. De DOM-standaard definieert replaceChildren() en CSSOM View definieert scrollTop, scrollHeight en clientHeight. De ondersteuning hangt af van de browserversie; voor de metingen is een lay-outengine nodig.

Voorbeelden

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

Resultaat

160 100 true
<b>Done</b> | 0
0

Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de ontwikkelaarsconsole. De hoogtes 160 en 100 geven een scrollbereik van 60 CSS-pixels. `true` betekent dat de positie binnen de tolerantie voor de onderkant valt. De markup verschijnt als letterlijke tekst en de laatste `0` laat zien dat er geen kindknopen meer zijn.

Gerelateerde lessen

  • JavaScript · Les 42 · Gevorderd · Versie: 4

Bronnen