element.getBoundingClientRect

  • Raccourci de la révision : DOM/element.getBoundingClientRect
  • Titre de la révision : element.getBoundingClientRect
  • ID de la révision : 113985
  • Créé :
  • Créateur : Mgjbot
  • Version actuelle ? Non
  • Commentaire robot Ajoute: [[es:DOM:element.getBoundingClientRect]] <<langbot>>

Contenu de la révision

{{ Fx_minversion_header("3") }} {{ DomRef() }}

Résumé

Renvoie un objet de rectangle texte qui entoure un groupe de rectangles de texte.

Syntaxe

var rectObject = object.getBoundingClientRect();

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.

Exemple

var rect = obj.getBoundingClientRect();

Spécification

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

Notes

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

Références


{{ languages( { "en": "en/DOM/element.getBoundingClientRect", "es": "es/DOM/element.getBoundingClientRect", "ja": "ja/DOM/element.getBoundingClientRect" } ) }}

Source de la révision

<p>{{ Fx_minversion_header("3") }} {{ DomRef() }}
</p>
<h3 name="R.C3.A9sum.C3.A9"> Résumé </h3>
<p>Renvoie un objet de rectangle texte qui entoure un groupe de rectangles de texte.
</p>
<h3 name="Syntaxe"> Syntaxe </h3>
<pre class="eval">var <i>rectObject</i> = <var>object</var>.getBoundingClientRect();
</pre>
<h3 name="Valeur_de_retour"> Valeur de retour </h3>
<p>La valeur renvoyée est un objet TextRectangle qui est l'union des rectangles renvoyés par <code>getClientRects()</code> pour l'élément, c'est-à-dire, les boîtes-bordures CSS associées avec l'élément.
</p><p>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 <code>top</code> et <code>left</code> 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.
</p><p>Les éventuels défilements effectués dans la zone de visualisation sont pris en compte lors du calcul des rectangles.
</p>
<h3 name="Exemple"> Exemple </h3>
<pre class="eval">var rect = obj.getBoundingClientRect();
</pre>
<h3 name="Sp.C3.A9cification"> Spécification </h3>
<p>Ne fait partie d'aucune spécification du W3C.
</p>
<h3 name="Notes"> Notes </h3>
<p><code>getBoundingClientRect()</code> faisait initialement partie du modèle objet DHTML de Microsoft Internet Explorer.
</p>
<h3 name="R.C3.A9f.C3.A9rences"> Références</h3>
<ul><li> <a class="external" href="http://msdn2.microsoft.com/en-us/library/ms536433.aspx"><i>getBoundingClientRect definition</i> sur MSDN</a>
</li></ul>
<p><br>
</p>
<div class="noinclude">
</div>
{{ languages( { "en": "en/DOM/element.getBoundingClientRect", "es": "es/DOM/element.getBoundingClientRect", "ja": "ja/DOM/element.getBoundingClientRect" } ) }}
Revenir à cette révision