CKTIS / JavaScript
Omsluitende rechthoek en afstanden tot het clientgebied
Meet de positie en grootte van een element ten opzichte van de viewport en onderscheid die waarden van de linker- en bovenafstand tot het clientgebied.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.getBoundingClientRect() // DOMRect
element.clientLeft // integer Number
element.clientTop // integer Numberelement.getBoundingClientRect() is een methode van Element zonder argumenten. De methode geeft een DOMRect terug op basis van de rechthoeken die getClientRects() na transformaties voor de randvakken geeft. Als de lijst leeg is, zijn alle waarden nul. Als elke rechthoek in de lijst een breedte of hoogte van nul heeft, geeft de methode de eerste rechthoek in de lijst terug. Anders geeft de methode de kleinste rechthoek terug die evenwijdig loopt aan de assen en alle rechthoeken met een breedte of hoogte ongelijk aan nul omsluit. Binnenruimte (padding) en randen tellen mee, marges niet. left en top zijn coördinaten ten opzichte van de linkerbovenhoek van de viewport; width en height zijn afmetingen. De waarden zijn in CSS-pixels en hoeven niet geheel te zijn.
element.clientLeft en element.clientTop zijn alleen-lezen eigenschappen, geen methoden. Ze geven gehele afstanden in CSS-pixels, zonder invloed van transformaties: de dikte van respectievelijk de linker- en bovenrand, plus eventuele ruimte die een schuifbalk aan dezelfde kant inneemt. Een verticale schuifbalk kan bijvoorbeeld links staan in een indeling van rechts naar links. Binnenruimte en marges tellen niet mee. Beide eigenschappen geven nul voor een inlinevak of als er geen CSS-vak is.
Het DOMRect is een momentopname. Meet opnieuw na het scrollen of na een wijziging in de lay-out als je actuele coördinaten nodig hebt. Tel voor documentcoördinaten window.scrollX op bij left en window.scrollY bij top. Gebruik clientLeft en clientTop niet als viewportcoördinaten of als algemene manier om coördinaten na een transformatie om te rekenen. Dit zijn API’s van het webplatform (CSSOM View), geen onderdelen van ECMAScript 2024; de beschikbaarheid hangt af van de uitvoeromgeving.
Voorbeelden
<!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>Resultaat
rect: 20, 30, 160, 80 client: 3, 5
Open het HTML-document in een browser met de paginazoom op 100% en `devicePixelRatio` op `1`. Bekijk de uitvoer in de browserconsole. De schaaltransformatie verdubbelt de afmetingen zonder de linkerbovenhoek te verplaatsen; de afstanden blijven `3` en `5`.
Gerelateerde lessen
- JavaScript · Les 35 · Gevorderd · Versie: 4