Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

element.getClientRects

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.

Note concernant Firefox 3.5

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

 

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : Mr21, fscholz, teoli, khalid32, BenoitL, Mgjbot
 Dernière mise à jour par : Mr21,