DOM:element.getBoundingClientRect
Un article de MDC.
Cet article traite de fonctionnalités introduites dans Firefox 3
Sommaire |
[modifier] Résumé
Renvoie un objet de rectangle texte qui entoure un groupe de rectangles de texte.
[modifier] Syntaxe
var rectObject = object.getBoundingClientRect();
[modifier] Valeur de retour
La valeur renvoyée est un objet TextRectangle qui est l'union des rectangles renvoyés par getClientRects() pour l'élément, c'est-à-dire, les boîtes-bordures CSS associées avec l'élément.
Les boîtes-bordures vides sont complètement ignorées. Si toutes les boîtes-bordures de l'élément sont vides, un rectangle avec une largeur et une hauteur de zéro est renvoyé et ses propriétés top et left correspondent au coin supérieur gauche de la boîte-bordure de la première boîte CSS (dans l'ordre du contenu) pour l'élément.
Les éventuels défilements effectués dans la zone de visualisation sont pris en compte lors du calcul des rectangles.
[modifier] Exemple
var rect = obj.getBoundingClientRect();
[modifier] Spécification
Ne fait partie d'aucune spécification du W3C.
[modifier] Notes
getBoundingClientRect() faisait initialement partie du modèle objet DHTML de Microsoft Internet Explorer.