Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Výška prvku a poloha posunu: offsetHeight, clientHeight a scrollTop

Rozlíšte vonkajšiu výšku prvku, výšku jeho vnútornej oblasti a aktuálnu polohu zvislého posunu. Zistite, ako rozpoznať dolný koniec bez presnej číselnej rovnosti.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

element.offsetHeight       // HTMLElement, read-only
 element.clientHeight       // Element, read-only
 element.scrollTop          // Element, read
 element.scrollTop = y      // Element, write a vertical offset in CSS pixels

Ide o vlastnosti DOM prehliadača, nie o súčasť ECMAScriptu. offsetHeight patrí rozhraniu HTMLElement; clientHeight a scrollTop patria rozhraniu Element a prvky HTML ich dedia. Pristupujte k nim na inštancii prvku, napríklad cez el.clientHeight. Všetky hodnoty sú v pixeloch CSS.

offsetHeight je celočíselná výška v rozložení, dostupná iba na čítanie. Zvyčajne zahŕňa vnútorné odsadenie (padding), orámovanie a vykreslený vodorovný posuvník, ak je prítomný, ale nie vonkajšie okraje. Nezohľadňuje transformácie CSS; výšku ohraničujúceho obdĺžnika po transformácii zistíte pomocou el.getBoundingClientRect().height.

clientHeight je celočíselná vnútorná výška, dostupná iba na čítanie. Zahŕňa vnútorné odsadenie, ale nie orámovanie, vonkajšie okraje ani vodorovný posuvník. Obe výšky sú 0, ak prvok pre display: none na ňom alebo na jeho predkovi nemá v rozložení žiadny box. Na koreňovom prvku dokumentu (body v režime quirks) vracia clientHeight výšku zobrazovacej oblasti bez vodorovného posuvníka.

scrollTop číta alebo nastavuje zvislý posun vzhľadom na jeho počiatok. Hore má zvyčajne hodnotu 0, ale môže byť desatinný alebo záporný, napríklad pri flex-direction: column-reverse. Pružný odraz na hranici posunu môže v Safari dočasne vrátiť hodnoty mimo bežného rozsahu. Priradením el.scrollTop = y možno posunúť obsah pri overflow: hidden, nie však pri overflow: clip.

scrollHeight je celočíselná výška celého obsahu vrátane časti presahujúcej mimo viditeľnej oblasti a vnútorného odsadenia. V bežnom kontajneri s posunom nadol bez prekročenia hraníc zistíte dolný koniec pomocou Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1. Namiesto === použite toleranciu jedného pixela CSS, pretože scrollTop môže byť desatinný. Pri obrátenom rozložení nepoužívajte tento test bez úprav.

Príklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element height and scroll position</title>
</head>
<body>
  <script>
    (() => {
      const box = document.createElement('div');
      box.style.cssText = 'position:fixed;top:0;left:0;width:160px;height:100px;' +
        'box-sizing:content-box;padding:0;border:4px solid;overflow:hidden;' +
        'scroll-behavior:auto;writing-mode:horizontal-tb;';
      const content = document.createElement('div');
      content.style.height = '300px';
      box.append(content);
      document.body.append(box);

      try {
        box.scrollTop = 40;
        console.log(`offsetHeight=${box.offsetHeight} clientHeight=${box.clientHeight} scrollHeight=${box.scrollHeight} scrollTop=${box.scrollTop}`);

        box.scrollTop = 1000;
        const atBottom = Math.abs(box.scrollHeight - box.clientHeight - box.scrollTop) <= 1;
        console.log(`scrollTop=${box.scrollTop} atBottom=${atBottom}`);
      } finally {
        box.remove();
      }
    })();
  </script>
</body>
</html>

Výsledok

offsetHeight=108 clientHeight=100 scrollHeight=300 scrollTop=40
scrollTop=200 atBottom=true

Uložte príklad ako súbor HTML, otvorte ho v prehliadači a skontrolujte výstup vo vývojárskej konzole. Orámovanie pridá 8 px k `offsetHeight`, ale nie k `clientHeight`. Pokus o posun na 1000 sa zastaví na 200, teda na dolnej hranici.

Súvisiace lekcie

  • JavaScript · Lekcia 11 · Pokročilá · Verzia: 4

Zdroje