aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/htmlelement/offsetleft/index.html
blob: f4bf76cb37edbbecd61e2b09e86f2dea9351a73a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
---
title: element.offsetLeft
slug: Web/API/HTMLElement/offsetLeft
tags:
  - Référence_du_DOM_Gecko
translation_of: Web/API/HTMLElement/offsetLeft
---
<p>{{ ApiRef() }}</p>
<h3 id="R.C3.A9sum.C3.A9">Résumé</h3>
<p>Renvoie le nombre de pixels dont le
 <i>
  coin supérieur gauche</i>
 de l'élément courant est décalé vers là gauche au sein du nœud <code><a href="fr/DOM/element.offsetParent">offsetParent</a></code>.</p>
<h3 id="Syntaxe">Syntaxe</h3>
<pre class="eval"><i>left</i> =<i>element</i>.offsetLeft;
</pre>
<p><code>left</code> est un entier représentant le décalage vers la gauche en pixels.</p>
<h3 id="Note">Note</h3>
<p><code>offsetLeft</code> renvoie la position du coin supérieur gauche de l'élément ; pas nécessairement du « vrai » bord gauche de l'élément. C'est important pour les éléments <b>span</b> dans les textes continus qui s'étendent sur plusieurs lignes. Le span peut commencer au milieu de la page et continuer au début de la ligne suivante. La propriété <code>offsetLeft</code> fera référence au coin gauche de départ du span, pas le bord gauche du texte au début de la seconde ligne. Par conséquent, une boîte avec les valeurs left, top, width et height correspondant à <code>offsetLeft, offsetTop, offsetWidth</code> et <code>offsetHeight</code> ne contiendra pas forcément un span avec débordement de texte.</p>
<h3 id="Exemple">Exemple</h3>
<pre>var colorTable = document.getElementById("t1");
var tOLeft = colorTable.offsetLeft;

if (tOLeft &gt; 5) {
  // grand décalage à gauche : faire quelque chose ici
}
</pre>
<h3 id="Exemple_2">Exemple</h3>
<p>Comme noté plus haut, cet exemple montre une « longue » phrase qui déborde dans un div avec une bordure bleue, et une boîte rouge dont on pourrait croire qu'elle décrit les limites du span.</p>

<p><img src="offsetleft.jpg"></p>

<p><small>Note : il s'agit d'une image de l'exemple, pas d'un rendu direct dans le navigateur. En effet, il n'est pas possible d'intégrer des scripts dans la page du wiki.</small></p>
<pre class="brush: html">&lt;div style="width: 300px; border-color:blue;
  border-style:solid; border-width:1;"&gt;
  &lt;span&gt;Short span. &lt;/span&gt;
  &lt;span id="long"&gt;Long span that wraps withing this div.&lt;/span&gt;
&lt;/div&gt;

&lt;div id="box" style="position: absolute; border-color: red;
  border-width: 1; border-style: solid; z-index: 10"&gt;
&lt;/div&gt;

&lt;script&gt;
  var box = document.getElementById("box");
  var long = document.getElementById("long");
  box.style.left = long.offsetLeft + document.body.scrollLeft;
  box.style.top = long.offsetTop + document.body.scrollTop;
  box.style.width = long.offsetWidth;
  box.style.height = long.offsetHeight;
&lt;/script&gt;
</pre>
<h3 id="Voir_aussi">Voir aussi</h3>
<p><code><a href="fr/DOM/element.offsetParent">offsetParent</a></code>, <code><a href="fr/DOM/element.offsetTop">offsetTop</a></code>, <code><a href="fr/DOM/element.offsetWidth">offsetWidth</a></code>, <code><a href="fr/DOM/element.offsetHeight">offsetHeight</a></code></p>
<h3 id="Sp.C3.A9cification">Spécification</h3>
<p>Cette propriété ne fait partie d'aucun standard ou recommandation technique du W3C.</p>
<p><a href="http://msdn.microsoft.com/workshop/author/dhtml/reference/properties/offsetleft.asp">MSDN: offsetLeft</a></p>