Window est un objet qui correspond à la fenêtre qui affiche une page Web. Une telle fenêtre peut être créée dynamiquement.
Ce n’est pas un objet JavaScript, et il n’est pas défini par la spécification DOM du W3C. C’est un standard de fait.
Les attributs et les méthodes de la fenêtre d’interface sont reconnus par Internet Explorer 4, Firefox 1, Opera 9, les versions plus récentes et Safari. Ce document est basé sur ce qui est pris en charge par les navigateurs en l’absence de norme officielle, voir les références.
La fenêtre courante est référencée par le mot clé window, et les fenêtres créées dynamiquement par le nom donné à l’objet affecté par la valeur de retour de la méthode open.
Définition et test des attributs et des objets internes de la fenêtre
Définitions des attributs et des objets internes
Ces attributs ne peuvent être lus que pour certains, leur valeur peut être assignée autrement.
frames Les frames de la fenêtre. En lecture seule. length Nombre de cadres. En lecture seule. name Nom de la fenêtre. status Texte de la barre d’état
Sous Firefox, la modification du texte est une option. Allez dans Options, Contenu, JavaScript et cliquez sur le bouton Avancé. Puis cochez la case à côté de « Modifier le texte de la barre d’état ». defaultStatus Texte par défaut dans la barre d’état. closed État fermé ou non. opener Référence sur la fenêtre qui a ouvert cette fenêtre. Exemple :
x = window.opener;parent Le parent de la fenêtre. Exemple :
x = mywin.parent;top Le parent du niveau le plus élevé.
Objets de la fenêtre
Ces objets ont leurs propres attributs et méthodes qui ne sont pas détaillés ici mais ils ont leur propre page.
document Fait référence à une page, qui est contenue dans la fenêtre. Document. historique Liste des pages précédemment consultées dans la même fenêtre. Historique. location Désigne l’URL d’une page qui contient la fenêtre. Emplacement. écran L’écran et ses propriétés : largeur, hauteur, availWidth, availHeight, colorDepth.
Voir aussi les propriétés de création de fenêtre dans le chapitre : Ouverture d’une nouvelle fenêtre en JavaScript.
Vérification des propriétés de l’objet Windows dans le navigateur
Les propriétés non prises en charge par un navigateur sont indéfinies.
Certaines propriétés sont utilisées comme paramètres du constructeur de la fenêtre mais elles ne sont pas directement accessibles et ne sont pas listées ici.
innerWidth innerHeight
outerWidth outerHeight
barre d’emplacement menubar personalbar statusbar toolbar scrollbars
pageXOffset pageYOffset
screenX screenY
directories
status. defaultStatus
opener
parent
top
name
length
Ne fonctionne pas avec Firefox 7
offscreenBuffering
On peut obtenir des valeurs équivalentes dans Internet Explorer et avec tous les navigateurs :
document.body.clientHeight
document.body.clientWidth
document.body.offsetHeight
document.body.offsetWidth
document.documentElement.offsetHeight
document.documentElement.offsetWidth
Autres
Crypto
Avertissement : La déclaration DOCTYPE pourrait avoir un effet sur ces valeurs.
Méthodes de fenêtre et démos
Les méthodes pour ouvrir ou fermer une fenêtre sont décrites dans le chapitre : Ouverture d’une nouvelle fenêtre en JavaScript.
Définitions des méthodes alert(message) Affiche un message. x = prompt(message) Présente une boîte de dialogue demandant une réponse de l’utilisateur et renvoie la réponse. x = confirm(message) Affiche un message, une question normalement, avec deux boutons pour confirmer ou annuler. Retourne true ou false. resizeTo(w, h) Redimensionne la largeur et la hauteur. scrollTo(x, y) Le défilement doit être activé pour la fenêtre selon l’indicateur scrollbars, c’est le cas par défaut. moveTo(x, y) Se déplace à la position donnée. id = setInterval(expression, millisecondes) Evalue une expression de manière répétée selon le temps de l’intervalle. clearInterval(id) Efface l’intervalle. id = setTimeout(expression, milliseconde) Evalue une expression après le délai. clearTimeout(id) Efface le délai. focus() Passe le focus à la fenêtre. blur() Supprime le focus à la fenêtre courante/donnée. createPopup() Crée une sous-fenêtre. print() Lance l’impression du contenu de la fenêtre. Démonstration des méthodes de l’objet fenêtre HTML Cliquez sur un bouton pour voir comment une méthode fonctionne. Le code correspondant est affiché à droite.
See also
Un exemple d’utilisation de setTimeout est inclus dans la démo de la lightbox avec effet de fondu.