window.innerHeight

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.

Note : La valeur retournée par cette propriété correspond le cas échéant à la hauteur de la fenêtre définie par 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.

Syntaxe

var hauteur = window.innerHeight;

Valeur

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

Notes

  • La propriété window.innerHeight est supportée par tout objet assimilé à une fenêtre window, un cadre frame , un ensemble de cadres frameset, ou une fenêtre secondaire.
  • Il existe un algorithme 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.

Exemples

Sur un frameset

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é

FIXME: ajouter ici un lien vers une démo interactive

Exemple graphique

L'illustration suivante montre la différence entre outerHeight et innerHeight.
outerHeight vs innerHeight

Spécification

Spécification Statut Commentaire
CSS Object Model (CSSOM) View Module
La définition de 'window.innerHeight' dans cette spécification.
Version de travail Définition initiale

Compatibilité des navigateurs

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 1 1.0 (1.7 ou moins)[1] 9 9 3
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 1 1.0 (1.0)[1] 9 9 3

[1] Cette propriété était mal gérée dans Firefox versions 4 à 24, et pouvait dans certains cas renvoyer une valeur erronée avant le chargement de la page, voir bug 641188.

Voir aussi

 

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : Copen, fscholz, teoli, khalid32, BenoitL, Mgjbot, Druss
 Dernière mise à jour par : Copen,