Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Posouvání a nahrazení potomků prvku: scrollTop, scrollHeight a replaceChildren()

Čti a nastavuj pozici posunu, rozlišuj celkovou výšku posuvné oblasti od viditelné vnitřní výšky a nahrazuj podřízené uzly bez interpretace řetězců jako HTML.

Verze: Current web platform; runtime support varies

Syntaxe

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 svislý posun od počátku posuvné oblasti v CSS pixelech. Vlastnost lze číst i zapisovat a hodnota může mít desetinnou část. Přiřazení požaduje absolutní pozici, nikoli relativní posun, s chováním auto. Při flex-direction: column-reverse může být hodnota záporná; pružný efekt na hranici posuvu ji v Safari může dočasně dostat mimo obvyklý rozsah.

scrollHeight je celočíselná výška celé posuvné oblasti včetně neviditelné části. Je jen pro čtení. Zahrnuje vnitřní odsazení (padding) a může zahrnovat pseudoprvky, ale ne okraj rámečku (border), vnější okraj (margin) ani vodorovný posuvník. clientHeight měří viditelnou vnitřní výšku. Bez svislého přetečení se obě výšky rovnají.

V běžném kontejneru s posuvem dolů je el.scrollHeight - el.clientHeight přibližná hodnota scrollTop na dolním konci. Ten ověřuj pomocí Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1 místo ===: výšky jsou zaokrouhlené, ale posun může být desetinný. Nepoužívej test beze změny u obráceného rozložení ani během pružného efektu při překročení hranice posuvu.

replaceChildren() nahrazuje všechny přímé podřízené uzly, nikoli samotný prvek. Přijímá libovolný počet objektů Node nebo řetězců, existující uzly přesouvá místo klonování a z řetězců tvoří uzly Text bez interpretace HTML. Bez argumentů prvek vyprázdní. Vrací undefined; vložení porušující hierarchii stromu může vyvolat HierarchyRequestError (výjimku typu DOMException).

Nejprve nahraď obsah, potom změř nové rozložení a nastav pozici posunu, protože rozsah se může změnit. ECMAScript 2024 je referenční verze jazyka JavaScript, nikoli verze těchto API webové platformy. Standard DOM definuje replaceChildren() a CSSOM View definuje scrollTop, scrollHeight a clientHeight. Podpora závisí na verzi prohlížeče; měření vyžaduje mechanismus pro výpočet rozložení.

Pří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ýsledek

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

Ulož příklad jako soubor HTML, otevři ho v prohlížeči a zkontroluj výstup ve vývojářské konzoli. Výšky 160 a 100 dávají rozsah posuvu 60 CSS pixelů. `true` označuje dosažení dolního konce v rámci tolerance. Značky se vypíšou jako doslovný text a poslední `0` ukazuje, že nezůstal žádný podřízený uzel.

Související lekce

  • JavaScript · Lekce 42 · Pokročilá · Verze: 4

Zdroje