CKTIS / JavaScript
Ohraničujúci obdĺžnik a odsadenia klientskej oblasti
Zmeraj polohu a veľkosť prvku vzhľadom na oblasť zobrazenia a odlíš tieto hodnoty od ľavého a horného odsadenia jeho klientskej oblasti.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.getBoundingClientRect() // DOMRect
element.clientLeft // integer Number
element.clientTop // integer Numberelement.getBoundingClientRect() je metóda rozhrania Element bez argumentov. Vracia DOMRect určený podľa obdĺžnikov, ktoré getClientRects() vracia pre rámčekové boxy po uplatnení transformácií. Ak je zoznam prázdny, všetky hodnoty sú nulové. Ak má každý obdĺžnik v zozname nulovú šírku alebo výšku, metóda vráti prvý obdĺžnik zo zoznamu. Inak vráti najmenší obdĺžnik rovnobežný s osami, ktorý obopína obdĺžniky s nenulovou šírkou alebo výškou. Zahŕňa rámček aj vnútorné odsadenie, nie však vonkajšie okraje. left a top sú súradnice vzhľadom na ľavý horný roh oblasti zobrazenia; width a height sú rozmery. Hodnoty sú v pixeloch CSS a nemusia byť celé.
element.clientLeft a element.clientTop sú vlastnosti iba na čítanie, nie metódy. Udávajú celočíselné odsadenia v pixeloch CSS bez vplyvu transformácií: hrúbku ľavého, respektíve horného rámčeka, plus priestor, ktorý zaberá prípadný posuvník na tej istej strane. Zvislý posuvník môže byť vľavo, napríklad pri rozložení sprava doľava. Vnútorné odsadenie ani vonkajší okraj sa nezapočítavajú. Pre riadkový box alebo bez boxu CSS obe vlastnosti vracajú nulu.
DOMRect zachytáva stav v okamihu merania. Ak potrebuješ aktuálne súradnice, po posunutí stránky alebo zmene rozloženia meraj znova. Pre súradnice vzhľadom na dokument pripočítaj window.scrollX k left a window.scrollY k top. clientLeft a clientTop nepoužívaj ako súradnice oblasti zobrazenia ani na všeobecný prevod súradníc po transformácii. Sú to rozhrania webovej platformy (CSSOM View), nie súčasť ECMAScriptu 2024; dostupnosť závisí od vykonávacieho prostredia.
Príklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element geometry</title>
</head>
<body>
<script>
(() => {
// Use a 1:1 ratio so the borders need no device-pixel rounding.
if (window.devicePixelRatio !== 1) {
throw new Error('Run at 100% page zoom with devicePixelRatio set to 1.');
}
const box = document.createElement('div');
box.style.cssText = `
position: fixed; left: 20px; top: 30px;
box-sizing: border-box; width: 80px; height: 40px;
border: solid black; border-width: 5px 2px 2px 3px;
overflow: hidden; transform-origin: top left; transform: scale(2);
`;
document.body.append(box);
try {
const { left, top, width, height } = box.getBoundingClientRect();
console.log(`rect: ${left}, ${top}, ${width}, ${height}`);
console.log(`client: ${box.clientLeft}, ${box.clientTop}`);
} finally {
box.remove();
}
})();
</script>
</body>
</html>Výsledok
rect: 20, 30, 160, 80 client: 3, 5
Otvor dokument HTML v prehliadači pri priblížení stránky na 100 % a s hodnotou `devicePixelRatio` rovnou `1`. Výsledok nájdeš v konzole prehliadača. Zmena mierky zdvojnásobí rozmery obdĺžnika bez posunutia jeho ľavého horného rohu; odsadenia zostanú `3` a `5`.
Súvisiace lekcie
- JavaScript · Lekcia 35 · Pokročilá · Verzia: 4