CKTIS / JavaScript
Rectangle englobant et décalages de la zone cliente
Mesurez la position et la taille d’un élément par rapport à la zone d’affichage et distinguez-les des décalages gauche et haut de sa zone cliente.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
element.getBoundingClientRect() // DOMRect
element.clientLeft // integer Number
element.clientTop // integer Numberelement.getBoundingClientRect() est une méthode sans argument de Element. Elle renvoie un DOMRect calculé à partir des rectangles que getClientRects() fournit pour les boîtes de bordure après application des transformations. Si la liste est vide, toutes les valeurs sont nulles. Si chaque rectangle de la liste a une largeur ou une hauteur nulle, la méthode renvoie le premier rectangle de la liste. Sinon, elle renvoie le plus petit rectangle aligné sur les axes qui englobe les rectangles dont la largeur ou la hauteur n’est pas nulle. La bordure et les marges intérieures sont incluses, pas les marges extérieures. left et top sont des coordonnées relatives au coin supérieur gauche de la zone d’affichage ; width et height sont des dimensions. Les valeurs sont exprimées en pixels CSS et peuvent être fractionnaires.
element.clientLeft et element.clientTop sont des propriétés en lecture seule, pas des méthodes. Elles donnent des décalages entiers en pixels CSS, sans tenir compte des transformations : l’épaisseur de la bordure gauche ou haute, respectivement, plus l’espace occupé par une barre de défilement du même côté. Une barre verticale peut se trouver à gauche, par exemple dans une mise en page de droite à gauche. Ni les marges intérieures ni les marges extérieures ne sont incluses. Les deux propriétés valent zéro pour une boîte en ligne ou en l’absence de boîte CSS.
Le DOMRect est un instantané. Reprenez la mesure après un défilement ou un changement de mise en page si vous avez besoin de coordonnées à jour. Pour obtenir les coordonnées dans le document, ajoutez window.scrollX à left et window.scrollY à top. clientLeft et clientTop ne sont ni des coordonnées dans la zone d’affichage ni un moyen général de convertir des coordonnées après une transformation. Ces API relèvent de la plateforme web (CSSOM View), et non d’ECMAScript 2024 ; leur disponibilité dépend de l’environnement d’exécution.
Exemples
<!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>Résultat
rect: 20, 30, 160, 80 client: 3, 5
Ouvrez le document HTML dans un navigateur avec un zoom de page de 100 % et un `devicePixelRatio` de `1`. Consultez le résultat dans la console du navigateur. La mise à l’échelle double les dimensions du rectangle sans déplacer son coin supérieur gauche ; les décalages restent `3` et `5`.
Leçons associées
- JavaScript · Leçon 35 · Avancé · Version : 4