element.getClientRects

Cet article traite de fonctionnalités introduites dans Firefox 3

Résumé

Renvoie une collection de rectangles indiquant les limites de chaque ligne de texte dans le client.

Syntaxe

var rectCollection = object.getClientRects();

Valeur de retour

La valeur renvoyée est une collection d'objets TextRectangle, un pour chaque boîte-bordure associée avec l'élément. Chaque objet TextRectangle contient des propriétés en lecture seule left, top, right et bottom (respectivement gauche, haut, droite et bas) décrivant la boîte-bordure, en pixels, avec le coin en haut à gauche relatif au coin en haut à gauche du canevas CSS, à moins que l'élément soit à l'intérieur d'un élément SVG foreignobject, auquel cas le coin en haut à gauche est relatif à l'ancêtre le plus proche de foreignobject et dans le système de coordonnées de ce foreignobject.

Les éventuels défilements effectués dans la zone de visualisation sont pris en compte lors du calcul des rectangles.

Les rectangles renvoyés ne comprennent pas les limites des éventuels éléments enfants qui pourraient déborder.

Pour les éléments HTML AREA, les éléments SVG qui ne rendent rien de particulier pour eux-mêmes, les éléments avec display:none, et en général tous les éléments qui ne sont pas directement affichés, une liste vite est renvoyée.

Des rectangles sont renvoyés même pour les boîtes CSS qui ont des boîtes-bordures vides. Les coordonnées left, top, right et bottom peuvent toujours avoir une signification.

Il est possible d'obtenir des décalages fractionnels en pixels.

Exemple

var rects = obj.getClientRects();
var numLines = rects.length;

Spécification

Ne fait partie d'aucune spécification du W3C.

Notes

getClientRects() faisait initialement partie du modèle objet DHTML de Microsoft Internet Explorer.

Références

• getClientRects definition sur MSDN