aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/htmlelement/offsetheight/index.html
blob: 5ceee19bcc3be1c6fd753ce327694ce4eb89fb84 (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
---
title: element.offsetHeight
slug: Web/API/HTMLElement/offsetHeight
tags:
  - Référence_du_DOM_Gecko
translation_of: Web/API/HTMLElement/offsetHeight
---
<p>{{ ApiRef() }}</p>

<h3 id="R.C3.A9sum.C3.A9">Résumé</h3>

<p>Propriété <abbr>DHTML</abbr> permettant d'obtenir la hauteur d'un élément par rapport à la mise en page.</p>

<h3 id="Syntaxe">Syntaxe</h3>

<pre class="eval">var <em>hauteurTotaleElem</em> = document.getElementById(<em>id</em>).offsetHeight;
</pre>

<p><em>hauteurTotalElem</em> est une variable stockant un entier correspondant à la valeur en pixels de la hauteur totale de l'élément identifé par <code>id</code>. <code>offsetHeight</code> est une propriété en lecture seule.</p>

<h3 id="Description">Description</h3>

<p>Typiquement, la propriété <strong>offsetHeight</strong> d'un élément est une mesure qui comprend les bordures de l'élément, ses marges internes verticales (padding), la barre de défilement horizontale si présente et affichée, et la hauteur CSS de l'élément.</p>

<h3 id="Exemple">Exemple</h3>

<h2 id="Example">Example</h2>

<p><img src="dimensions-offset.png"></p>

<p>L'exemple d'image ci-avant montre une barre de défilement et un décalage <code>offsetHeight</code> qui rentre dans la fenêtre. Toutefois, les éléments non-défilables peuvent avoir des valeurs <code>offsetHeight</code> élevées, voire plus élevéesque le contenu visible. Ces éléments sont généralement contenu au sein d'éléments défilables et, de fait, les éléments non-défilables peuvent être partiellement ou complètement invisible, selon la valeur de <code>scrollTop</code> pour le conteneur.</p>

<h3 id="Sp.C3.A9cification">Spécification</h3>

<p><code>offsetHeight</code> fait partie du modèle objet DHTML de Microsoft Internet Explorer. Elle ne fait partie d'aucune spécification ou recommandation technique du W3C.</p>

<h3 id="Notes">Notes</h3>

<p><code>offsetHeight</code> est une propriété du modèle objet DHTML introduite par Microsoft Internet Explorer. On l'appelle parfois la hauteur physique ou graphique d'un élément, ou sa hauteur « border-box » (bordure et boîte).</p>

<h3 id="R.C3.A9f.C3.A9rences">Références</h3>

<ul>
 <li><a href="http://msdn.microsoft.com/workshop/author/dhtml/reference/properties/offsetheight.asp?frame=true"><em>offsetHeight definition</em> sur MSDN</a></li>
 <li><a href="http://msdn.microsoft.com/workshop/author/om/measuring.asp"><em>Measuring Element Dimension and Location</em> sur MSDN</a></li>
</ul>

<h3 id="Voir_aussi">Voir aussi</h3>

<ul>
 <li><a href="/fr/DOM/element.clientHeight"><code>element.clientHeight</code></a></li>
 <li><a href="/fr/DOM/element.scrollHeight"><code>element.scrollHeight</code></a></li>
 <li><a href="/fr/DOM/element.offsetWidth"><code>element.offsetWidth</code></a></li>
</ul>