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