window

Cette section fournit une brève référence pour toutes les méthodes, propriétés et évènements disponibles au travers de l'objet DOM window. L'objet window implémente l'interface Window, laquelle hérite à son tour de l'interface AbstractView.

L'objet window représente la fenêtre elle-même. La propriété document d'un objet window pointe vers le document DOM chargé dans cette fenêtre. L'objet window représentant la fenêtre correspondant à un document donné peut être obtenue à l'aide de la propriété document.defaultView.

Dans un navigateur utilisant des onglets, comme Firefox, chaque onglet contient son propre objet window (et si vous écrivez une extension, la fenêtre du navigateur elle-même est un objet window séparé — consultez Travailler avec des fenêtres dans du code chrome pour plus d'informations). C'est-à-dire que l'objet window n'est pas partagé entre les onglets faisant partie de la même fenêtre. Certaines méthodes, comme window.resizeTo et window.resizeBy s'appliquent à la fenêtre entière et non à l'onglet spécifique auquel l'objet window appartient. En général, ce qui ne peut pas raisonnablement être limité à un onglet se rapporte à la fenêtre à la place.

Propriétés

window.applicationCache

Un objet nsIDOMOfflineResourceList permettant d'accéder aux ressources hors ligne de la fenêtre.

window.Components

Le point d'entrée à de nombreuses fonctionnalités XPCOM. Certaines propriétés comme classes sont seulement disponibles pour du code suffisamment privilégié.

window.content et window._content

Renvoie une référence à l'élément content de la fenêtre courante. La variante soulignée n'est plus à utiliser

window.closed

Cette propriété indique si la fenêtre courante est fermée ou pas.

window.controllers

Renvoie les objets de contrôle XUL de la fenêtre chrome courante.

window.crypto

Renvoie l'objet de chiffrement du navigateur.

window.defaultStatus

Lit/définit le texte de la barre d'état d'une fenêtre donnée.

window.dialogArguments

Récupère les paramètres passés à la fenêtre (s'il s'agit d'une boîte de dialogue) au moment où window.showModalDialog() a été appelée. Il s'agit d'un nsIArray.

window.directories

Renvoie une référence à la barre d'outils personnelle dans le chrome courant.

window.document

Renvoie une référence du document contenu dans la fenêtre.

window.frameElement

Renvoie l'élément dans lequel l'élément window est intégré, ou null s'il n'est pas intégré dans un autre élément.

window.frames

Renvoie un tableau des sous cadres de la fenêtre courante.

window.fullScreen

Indique si la fenêtre est affichée en mode plein écran

window.globalStorage

Différents objets de stockage utilisés pour conserver des données d'une page à l'autre.

window.history

Renvoie une référence de l'objet historique.

window.innerHeight

Récupère la hauteur du contenu visible de la fenêtre de navigation en incluant, s'il est visible, l'ascenseur horizontal.

window.innerWidth

Récupère la largeur du contenu visible de la fenêtre de navigation en incluant, s'il est visible, l'ascenseur vertical.

window.length

Renvoie le nombre de cadres dans la fenêtre.

window.location

Lit/définit l'adresse ou l'URL courante de la fenêtre.

window.locationbar

Renvoie l'objet barre d'adresse, dont la visibilité peut être modifiée dans la fenêtre.

window.menubar

Renvoie l'objet barre de menu, dont la visibilité peut être modifiée dans la fenêtre.

window.name

Lit/définit le nom de la fenêtre.

window.navigator

Renvoie une référence de l'objet navigator.

window.opener

Renvoie une référence de la fenêtre qui a ouvert cette fenêtre courante.

window.outerHeight

Lit la hauteur de l'extérieur de la fenêtre de navigation.

window.outerWidth

Lit la largeur de l'extérieur de la fenêtre de navigation.

window.pageXOffset

Un alias pour window.scrollX.

window.pageYOffset

Un alias pour window.scrollY.

window.parent

Renvoie une référence à l'élément window parent de la fenêtre ou du cadre courant.

window.personalbar

Renvoie l'objet barre d'outils personnelle dont la visibilité peut être modifiée dans la fenêtre.

window.pkcs11

Renvoie l'objet pkcs11 servant à l'installation de pilotes et d'autres logiciels associés avec le protocole pkcs11.

window.returnValue

La valeur de retour à renvoyer à la fonction qui a appelé window.showModalDialog() pour afficher la fenêtre comme un dialogue modal.

window.screen

Renvoie une référence à l'objet écran associé avec la fenêtre.

window.screen.availTop

Spécifie l'ordonnée du premier pixel n'étant pas alloué de manière permanente ou semi-permanente aux besoins de l'interface utilisateur.

window.screen.availLeft

Renvoie le premier pixel disponible sur la gauche de l'écran.

window.screen.availHeight

Renvoie la hauteur de l'écran, en pixels, moins les besoins permanents ou semi-permanents de l'interface utilisateur affichée par le système d'exploitation, telle que la barre de tâches sous Windows.

window.screen.availWidth

Renvoie l'espace horizontal disponible en pixels de la fenêtre.

window.screen.colorDepth

Renvoie la profondeur de couleurs de l'écran.

window.screen.height

Renvoie la hauteur en pixels de l'écran.

window.screen.left

Renvoie la position courante en pixels depuis le bord gauche de l'écran.

window.screen.pixelDepth

Donne la profondeur binaire de l'écran.

window.screen.top

Renvoie la position courante depuis le haut de l'écran.

window.screen.width

Renvoie la largeur de l'écran.

window.screenX

Renvoie la distance horizontale entre le bord gauche du navigateur et le bord gauche de l'écran.

window.screenY

Renvoie la distance verticale entre le bord supérieur du navigateur et le haut de l'écran.

window.scrollbars

Renvoie l'objet représentant les ascenseurs dont la visibilité peut être modifiée dans la fenêtre.

window.scrollMaxX

Le décalage maximum dont la fenêtre peut défiler horizontalement.

(c'est-à-dire la largeur du document moins celle de la fenêtre de visualisation)

window.scrollMaxY

Le décalage maximum dont la fenêtre peut défiler verticalement.

(c'est-à-dire la hauteur du document moins celle de la fenêtre de visualisation)

window.scrollX

Renvoie le nombre de pixels de défilement horizontal du document.

window.scrollY

Renvoie le nombre de pixels de défilement vertical du document.

window.self

Renvoie une référence à l'objet fenêtre elle même.

window.sessionStorage

Un objet de stockage pour stocker des données au sein d'une session unique pour une page.

window.sidebar

Renvoie une référence à l'objet window du panneau latéral.

window.status

Lit/définit le texte dans la barre d'état en bas du navigateur.

window.statusbar

Renvoie l'objet barre d'état dont la visibilité peut être modifiée dans la fenêtre.

window.toolbar

Renvoie l'objet barre d'outils dont la visibilité peut être modifiée dans la fenêtre.

window.top

Renvoie une référence de la fenêtre la plus haute dans la hiérarchie des fenêtres.

window.window

Renvoie une référence de la fenêtre courante.

Méthodes

window.alert

Affiche une boîte de message d'alerte.

window.addEventListener

Enregistre un gestionnaire d'évènement pour un type d'évènement spécifique sur la fenêtre.

base64 func https://bugzilla.mozilla.org/show_bug.cgi?id=287112 (see last comments) https://bugzilla.mozilla.org/show_bug.cgi?id=123003 http://lxr.mozilla.org/seamonkey/sou...indow.cpp#4946

window.atob

Décode une chaîne de caractères encodée en base-64.

window.back

Recule d'une page dans l'historique de la fenêtre.

window.blur

Enlève le focus de la fenêtre.

window.btoa

Crée une chaîne ASCII encodée en base-64 à partir d'une chaîne de données binaires.

window.captureEvents

Indique à la fenêtre de capturer tous les évènements d'un type spécifié.

window.clearInterval

Annule l'exécution répétitive instaurée par setInterval.

window.clearTimeout

Annule le délai instauré par setTimeout.

window.close

Ferme la fenêtre courante.

window.confirm

Affiche une boîte de dialogue qui demande une confirmation à l'utilisateur.

window.dump

Écrit un message vers le terminal.

window.escape

Encode une chaîne de caractères.

window.find

Recherche une chaîne de caractères donnée dans une fenêtre.

window.focus

Donne le focus à la fenêtre courante.

window.forward

Avance la fenêtre d'un document dans l'historique.

window.getAttention

Fait flasher l'icône de l'application.

window.getComputedStyle

Lit un style calculé pour un élément donné. Un style calculé indique la valeur CSS de l'élément après l'application de toutes les propriétés CSS.

window.getSelection

Renvoie l'objet de sélection représentant les items sélectionnés.

window.home

Ouvre la page d'accueil dans le navigateur.

window.moveBy

Déplace la fenêtre courante d'un certain nombre de pixels.

window.moveTo

Déplace la fenêtre vers les coordonnées spécifiées.

window.open

Ouvre une nouvelle fenêtre.

window.openDialog

Ouvre une nouvelle fenêtre de dialogue.

window.postMessage

Fournit un moyen sécurisé pour une fenêtre d'envoyer une chaîne de données à une autre fenêtre, qui ne doit pas être dans le même domaine que la première.

window.print

Ouvre la boîte de dialogue d'impression du document courant.

window.prompt

Renvoie le texte saisi par l'utilisateur dans une boîte d'invite.

window.releaseEvents

Annule la capture des évènements d'un certain type pour la fenêtre.

window.removeEventListener

Retire un gestionnaire d'évènement de la fenêtre.

window.resizeBy

Redimensionne la fenêtre courante d'un certain nombre de pixels.

window.resizeTo

Redimensionne dynamiquement la fenêtre.

window.scroll

Fait défiler la fenêtre à un endroit particulier dans le document.

window.scrollBy

Fait défiler le document dans la fenêtre d'un certain nombre de pixels.

window.scrollByLines

Fait défiler le document du nombre de lignes indiqué.

window.scrollByPages

Fait défiler le document du nombre de pages indiqué.

window.scrollTo

Fait défiler le document jusqu'aux coordonnées indiquées.

window.setInterval

Exécute une fonction toutes les X millisecondes.

window.setTimeout

Définit un délai avant d'exécuter une fonction.

window.showModalDialog

Affiche un dialogue modal.

window.sizeToContent

Ajuste les dimensions de la fenêtre en fonction de son contenu.

window.stop

Interrompt le chargement dans la fenêtre.

window.unescape

Décode une valeur qui a été encodée en hexadécimal (par exemple un cookie).

window.updateCommands

Met à jour l'état des commandes de la fenêtre chrome courante (interface utilisateur).

Évènements

window.onabort

Propriété de gestion d'évènement pour les évènements d'annulation dans la fenêtre.

window.onbeforeunload

Propriété de gestion d'évènement pour les évènements d'avant déchargement sur la fenêtre.

window.onblur

Propriété de gestion d'évènement pour les évènements de perte de focus de la fenêtre.

window.onchange

Propriété de gestion d'évènement pour les évènements de modifications dans la fenêtre.

window.onclick

Propriété de gestion d'évènement pour les évènements de clic dans la fenêtre.

window.onclose

Propriété de gestion d'évènement pour les évènements de fermeture de la fenêtre.

window.oncontextmenu

Propriété de gestion d'évènement pour les évènements de clic droit dans la fenêtre.

window.ondragdrop

Propriété de gestion d'évènement pour les évènements de glisser-déposer dans la fenêtre.

window.onerror

Propriété de gestion d'évènement pour les erreurs dans la fenêtre.

window.onfocus

Propriété de gestion d'évènement pour les évènements de focus de la fenêtre.

window.onkeydown

Propriété de gestion d'évènement pour les évènements de touche enfoncée dans la fenêtre.

window.onkeypress

Propriété de gestion d'évènement pour les évènements de touche pressée la fenêtre.

window.onkeyup

Propriété de gestion d'évènement pour les évènements de touche relâchée la fenêtre.

window.onload

Propriété de gestion d'évènement pour le chargement de la fenêtre.

window.onmousedown

Propriété de gestion d'évènement pour les évènements de bouton de souris enfoncé dans la fenêtre.

window.onmousemove

Propriété de gestion d'évènement pour les évènements de mouvement de souris dans la fenêtre.

window.onmouseout

Propriété de gestion d'évènement pour les évènements de sortie de la souris de la fenêtre.

window.onmouseover

Propriété de gestion d'évènement pour les évènements de survol à la souris de la fenêtre.

window.onmouseup

Propriété de gestion d'évènement pour les évènements de relâchement du bouton de la souris dans la fenêtre.

window.onpaint

Propriété de gestion d'évènement pour les évènements de dessin de la fenêtre.

window.onreset

Propriété de gestion d'évènement pour les évènements de réinitialisation de la fenêtre.

window.onresize

Propriété de gestion d'évènement pour les évènements de redimensionnement de la fenêtre.

window.onscroll

Propriété de gestion d'évènement pour les évènements de défilement de la fenêtre.

window.onselect

Propriété de gestion d'évènement pour les évènements de sélection dans la fenêtre.

window.onsubmit

Propriété de gestion d'évènement pour les évènements de soumission de formulaires dans la fenêtre.

window.onunload

Propriété de gestion d'évènement pour les évènements de déchargement d'un document dans la fenêtre.