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

CKTIS / JavaScript

Element.getBoundingClientRect(): rozmery a poloha DOMRect

Zmeraj ohraničujúci obdĺžnik prvku v pixeloch CSS a rozlíš súradnice vzhľadom na zobrazovanú oblasť od súradníc dokumentu.

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

Syntax

const rect = element.getBoundingClientRect();
const { x, y, width, height, top, right, bottom, left } = rect;

element.getBoundingClientRect() neprijíma žiadne argumenty a vracia objekt DOMRect. Je to webové API, nie súčasť ECMAScriptu. Na meranie potrebuješ prostredie, ktoré počíta rozloženie DOM; dostupnosť závisí od prostredia, v ktorom kód beží.

Pri prvku HTML meranie vychádza z obdĺžnikov so stranami rovnobežnými s osami, ktoré zodpovedajú jeho boxom CSS až po vonkajšiu hranu orámovania. Zahŕňa vnútorné odsadenie a orámovanie, zohľadňuje transformácie CSS a nezahŕňa vonkajšie okraje. Jednotlivé obdĺžniky získaš pomocou getClientRects(). Ak je zoznam prázdny, napríklad pri display: none, všetky hodnoty sú nulové. Ak má každý obdĺžnik nulovú šírku alebo nulovú výšku, metóda vráti prvý obdĺžnik v zozname. V opačnom prípade vráti najmenší obdĺžnik, ktorý obopína všetky obdĺžniky v zozname okrem tých, ktoré majú oba rozmery nulové. Pri riadkovom prvku na viacerých riadkoch môže výsledok pokrývať aj medzery medzi fragmentmi. Samotný obdĺžnik nedokazuje, že je prvok viditeľný.

width a height udávajú rozmery obdĺžnika. V tomto výsledku sa x a y rovnajú left a top; right je left + width a bottom je top + height. Súradnice sa merajú od ľavého horného rohu zobrazovanej oblasti, nie od jej najbližšej hrany, a môžu byť záporné. Všetky hodnoty sú v pixeloch CSS a môžu mať desatinnú časť.

V objekte DOMRect možno meniť x, y, width a height; súradnice hrán sa z nich vypočítavajú a sú len na čítanie. V ručne vytvorenom obdĺžniku so záporným width alebo height sa môže x líšiť od left alebo y od top. Zmena výsledku nezmení prvok. Výsledok zachytáva stav pri meraní: ak po zmene rozloženia alebo posunutí obsahu potrebuješ aktuálne hodnoty, zmeraj prvok znova.

Pre ľavý horný roh v súradniciach dokumentu použi rect.left + window.scrollX a rect.top + window.scrollY. Hodnoty posunu odčítaj v čase merania. Tým zmeníš začiatok súradníc, ale nezrušíš posun obsahu vo vnorenom kontajneri.

Príklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Measuring an element</title>
</head>
<body>
<script>
(() => {
  const box = document.createElement('div');
  box.style.cssText = 'position: fixed; left: 24.5px; top: 16px; margin: 0; box-sizing: content-box; width: 104px; height: 44px; padding: 8px; border: 0;';
  document.body.append(box);
  try {
    const rect = box.getBoundingClientRect();
    const { x, y, width, height, top, right, bottom, left } = rect;
    console.log(`x=${x}, y=${y}, width=${width}, height=${height}, top=${top}, right=${right}, bottom=${bottom}, left=${left}`);

    box.style.left = '44.5px';
    console.log(`previous x=${rect.x}, current x=${box.getBoundingClientRect().x}`);
  } finally {
    box.remove();
  }
})();
</script>
</body>
</html>

Výsledok

x=24.5, y=16, width=120, height=60, top=16, right=144.5, bottom=76, left=24.5
previous x=24.5, current x=44.5

Ulož príklad ako súbor HTML, otvor ho v prehliadači a pozri si výstup vo vývojárskej konzole. Rozmery zahŕňajú vnútorné odsadenie na oboch stranách každej osi; prvok nemá orámovanie. Po presunutí prvku si predchádzajúci obdĺžnik ponechá pôvodné `x`; novú hodnotu `x` vráti až ďalšie meranie.

Súvisiace lekcie

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

Zdroje