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 de la zone de visualisation, à 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
.
Firefox 3.5 ajoute les propriétés width
et height
à l'objet TextRectangle.
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 vide 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
CSSOM Views: The getClientRects() and getBoundingClientRect() methods
Notes
getClientRects()
faisait initialement partie du modèle objet DHTML de Microsoft Internet Explorer.
Références
Voir également