aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/window/innerheight/index.html
blob: 19e63c1f5438a83f0e2b5f6ed4724635f6719189 (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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
---
title: window.innerHeight
slug: Web/API/Window/innerHeight
tags:
  - API
  - CSSOM View
  - Property
  - Propriété
  - Reference
  - Window
translation_of: Web/API/Window/innerHeight
---
<p>{{ ApiRef() }}</p>

<p>Récupère la hauteur (en pixels) de la partie visible de la fenêtre de navigation en incluant, si elle est affichée, la barre de défilement horizontale.</p>

<div class="note">
<p><strong>Note :</strong> La valeur retournée par cette propriété correspond le cas échéant à la hauteur de la fenêtre définie par {{ifmethod("nsIDOMWindowUtils", "setCSSViewport")}}, dans le cas où vous utilisez cette méthode pour définir les dimensions de la fenêtre virtuelle dans le but d'agencer la page.</p>
</div>

<h2 id="Syntaxe">Syntaxe</h2>

<pre>var hauteur = window.innerHeight;
</pre>

<h3 id="Valeur_renvoy.C3.A9e">Valeur</h3>

<p>Renvoie la hauteur de la partie visible de la fenêtre de navigation. La propriété <code>window.innerHeight</code> est accessible en lecture seulement ; elle n'a pas de valeur par défaut.</p>

<h2 id="Notes">Notes</h2>

<ul>
 <li>La propriété <code>window.innerHeight</code> est supportée par tout objet assimilé à une fenêtre <em>{{domxref("window")}}</em>, un cadre <em>frame </em>, un ensemble de cadres <em>frameset</em>, ou une fenêtre secondaire.</li>
 <li>Il existe un <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=189112#c7">algorithme</a> pour calculer la hauteur de la partie visible de la fenêtre en excluant la barre de défilement horizontale si est elle affichée.</li>
</ul>

<h2 id="Attention">Exemples</h2>

<h3 id="Code">Sur un <em>frameset</em></h3>

<pre class="brush:js">var intFrameHeight = window.innerHeight; // ou

var intFrameHeight = self.innerHeight;
// retournera la hauteur de la partie visible du cadre dans frameset

var intFramesetHeight = parent.innerHeight;
// retournera la hauteur de la partie visible du frameset le plus proche

var intOuterFramesetHeight = top.innerHeight;
// retournera la hauteur de la partie visible du frameset le plus éloigné
</pre>

<p>{{todo("ajouter ici un lien vers une démo interactive")}}</p>

<ul>
 <li>Pour modifier les dimensions d'une fenêtre, voir {{domxref("window.resizeBy()")}} et {{domxref("window.resizeTo()")}}.</li>
 <li>Pour récupérer la hauteur extérieure d'une fenêtre, c'est-à-dire la hauteur de la fenêtre du navigateur dans sa totalité, voir {{domxref("window.outerHeight")}}.</li>
</ul>

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

<p>L'illustration suivante montre la différence entre <code>outerHeight</code> et <code>innerHeight</code>.</p>

<p><img alt="Illustration de la différence entre innerHeight et outerHeight" src="firefoxinnervsouterheight2.png"></p>

<h2 id="Spécification">Spécification</h2>

<table>
 <thead>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">Statut</th>
   <th scope="col">Commentaire</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('CSSOM View', '#dom-window-innerheight', 'window.innerHeight')}}</td>
   <td>{{Spec2('CSSOM View')}}</td>
   <td>Définition initiale</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<p>{{Compat("api.Window.innerHeight")}}</p>

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

<ul>
 <li>{{domxref("window.innerWidth")}}</li>
 <li>{{domxref("window.outerHeight")}}</li>
 <li>{{domxref("window.outerWidth")}}</li>
</ul>