L'objet window représente la fenêtre du navigateur ou le cadre dans lequel s'affiche le contenu du document. L'objet window joue un rôle essentiel lorsque des scripts doivent communiquer avec des objets document situés dans d'autres cadres ou sous-fenêtres. La gestion de fenêtres multiples peut être difficile du fait de la nature transitoire des références entre fenêtres. L´interprétation stricte des normes HTML et XHTML n´apprécie pas les fenêtres multiples et de nombreux utilisateurs confus seraient probablement du même avis.

Ces propriétés sont associées aux services propriétaires xpconnect de Mozilla (connexion entre plates-formes). Ces services permettent aux scripts d´avoir l´autorisation de sécurité pour travailler avec les objets XPCOM (pas MS COM) pour élargir la fonctionnalité de l´application qui utilise le moteur Mozilla (comme le navigateur Netscape 6). L´accès à ces services nécessite l´activation des privilèges de sécurité (en général, par le biais de scripts signés), comme suit:

netscape.security.PrivilegeManager.enablePrivilege("UniversalXPConnect");
// your xpconnect access code here
netscape.security.PrivilegeManager.revertPrivilege("UniversalXPConnect");

Renvoie l'objet navigator. Le nom de l'objet navigator dépend de la marque du navigateur; la propriété clientInformation est une manière non orthodoxe d'accéder à d'importantes variables d'environnement précédemment accessibles via les propriétés et méthodes de l'objet navigator (abordé séparément précédemment dans ce chapitre). Dans Internet Explorer, vous pouvez substituer window.clientInformation à toute référence commençant par navigator .

Reportez-vous à l´objet clipboardData abordé séparément précédemment dans ce chapitre. L´objet (accessible en tant que propriété de l´objet window ou frame) est un conteneur temporaire que les scripts dans IE 5 et versions ultérieures pour Windows peuvent utiliser pour transférer des données de texte, en particulier pendant les opérations contrôlées par script simulant le découpage, la copie et le collage, ou contrôlant le glissement.

Valeur booléenne indiquant si la fenêtre référencée est fermée. Une valeur true indique que la fenêtre n'est plus disponible pour référencer ses objets ou composants de script. Le plus souvent, celle-ci est utilisée pour vérifier si un utilisateur a fermé une sous-fenêtre créée à l'aide de la méthode window.open().

Voir appCore.

Renvoie des références aux objets associés aux éléments internes de cryptographie de clé publique Mozilla. Pour plus de détails à ce sujet, visitez http://www.mozilla.org/projects/security/.

Spécifie le message qui s'affiche par défaut dans la barre d'état de la fenêtre du navigateur lorsque ce dernier n'est pas occupé à charger. Pour modifier temporairement ce message (par exemple, lorsque le curseur de la souris passe sur une image), utilisez la propriété status de la fenêtre. La plupart des navigateurs prenant en charge les scripts gèrent difficilement le paramétrage de la propriété defaultStatus. Attendez-vous donc à un comportement singulier.

Chaîne, ou autre type de données, transmise sous forme d'arguments supplémentaires à une fenêtre de dialogue modal créée avec la méthode window.showModalDialog() ou (dans IE 5 et versions ultérieures pour Windows uniquement) window.showModelessDialog(). Le meilleur moyen d'accéder à cette propriété consiste à utiliser un script dans le document affiché dans la fenêtre de dialogue, afin de récupérer toutes les données transférées à la nouvelle fenêtre sous forme d'arguments. Le script devra analyser les données si vous passez en une seule fois plusieurs arguments séparés par le séparateur de votre choix.

Spécifie les valeurs de hauteur et de largeur d'une fenêtre de dialogue modal créée avec la méthode showDialog() ou showModelessDialog(). Bien qu'Internet Explorer ne s'oppose pas à la modification de ces propriétés (dans un script exécuté dans la fenêtre de dialogue modal), les valeurs modifiées n'affectent généralement pas les dimensions de la boîte de dialogue. Des valeurs initiales sont définies comme paramètres de la méthode d´ouverture de boîte de dialogue.

Indique la distance séparant les côtés supérieur et gauche d'une fenêtre de dialogue modal (créée avec les méthodes showDialog() et showModelessDialog()) du coin supérieur gauche de l'écran. Bien qu'Internet Explorer ne s'oppose pas à la modification de ces propriétés (dans un script exécuté dans la fenêtre de dialogue modal), les valeurs modifiées n'affectent généralement pas le positionnement de la boîte de dialogue. Des valeurs initiales sont définies comme paramètres des méthode de boîte de dialogue.

Renvoient des références à la fonctionnalité de fenêtre du navigateur Navigator (la propriété directories est nouvelle dans Netscape 6). Consultez la section consacrée aux objets directories (et autres) précédemment dans ce chapitre pour savoir comment contrôler la visibilité de ces fonctionnalités de fenêtre avec des scripts signés.

Renvoie une référence à l'objet document contenu par la fenêtre. Dans les navigateurs qui offrent la prise en charge de l´arborescence de documents du DOM W3C, cette propriété pointe plus spécifiquement sur le noeud HTMLDocument racine pour l´arborescence de documents chargée dans la fenêtre. Le DOM W3C décrit même cette propriété comme un élément de l´un de ses objets View (identique à une fenêtre de navigateur). Il s´agit de la propriété qui permet aux références de scripts à des méthodes et du contenu de documents de commencer par le mot document.

Le modèle d'événement Internet Explorer génère un objet event pour chaque événement utilisateur ou système. Cet objet event est une propriété de l'objet window. Pour de plus amples détails sur l´objet événement IE, reportez-vous au chapitre 6 et à la liste des objets event dans le présent chapitre.

Renvoie une référence à l´objet external, qui fournit l´accès au fonctionnalité de bas niveau du moteur du navigateur (si les permissions de sécurité l´autorisent). Reportez-vous à la section consacrée à l'objet external précédemment dans ce chapitre.

Si la fenêtre actuelle est un élément d´un jeu de cadres ou d´un iframe, la propriété frameElement renvoie une référence à l´objet élément frame ou iframe (différent de l´objet de cadre en tant que fenêtre). Cependant, les restrictions de sécurité peuvent empêcher l´accès à cette propriété.

Renvoie une collection (tableau) d´objets window qui sont implémentés comme cadres ou iframes dans la fenêtre actuelle. Pour la fenêtre parent ou top d´un jeu de cadres, le tableau contient des références aux fenêtres frame de première génération. Les valeurs d´index peuvent être des nombres entiers à base zéro (dans l´ordre du code source) ou l´identificateur affecté à l´attribut name de l´élément frame.

Contient l'objet history pour la fenêtre ou le cadre actif. Pour plus de détails, voir la section présentant l'objet history.

Spécifie la mesure en pixels de la hauteur et de la largeur de la zone de contenu d'une fenêtre ou d'un cadre de navigateur. Cette zone affiche le contenu du document, à l'exception de l'habillage de la fenêtre. Pour des valeurs comparables dans IE, reportez-vous à l´objet élément body.

Spécifie le nombre de cadres (le cas échéant) imbriqués dans la fenêtre active. Cette valeur est identique à celle renvoyée par window.frames.length. Si aucun cadre n'est défini pour la fenêtre, la valeur est égale à zéro.

Renvoie un objet location contenant l´adresse URL du document actuellement chargé dans la fenêtre ou le cadre. Pour vous diriger vers une autre page, affectez une adresse URL à la propriété location.href (la méthode navigate() offre une alternative pour IE). Voir l'objet location.

Voir directories.

Voir directories.

Identifiant associé à un cadre ou à une sous-fenêtre, à utiliser comme valeur affectée aux attributs target ou comme instruction de script pour le cadre ou la sous-fenêtre. Pour un cadre, la valeur est généralement donnée par l'attribut name de la balise frame; toutefois, si nécessaire, un script peut la modifier. Le nom d'une sous-fenêtre est affecté en tant que paramètre à la méthode window.open(). La fenêtre de navigateur principale n´a pas de nom par défaut, mais vous pouvez lui en affecter un par script si vous avez besoin qu´un lien ou un formulaire dans une sous-fenêtre renvoie à la fenêtre principale.

Renvoie une référence à l'objet navigator. La référence window étant facultative, une syntaxe dépourvue de cette référence fonctionne dans toutes les versions prenant en charge les scripts de Microsoft Internet Explorer et Navigator. Voir l'objet navigator.

Détermine si le navigateur doit utiliser la mise en mémoire d'éléments qui ne sont pas encore affichés pour améliorer les performances d'une animation suivant un trajet. Bien que la propriété soit implémentée dans IE pour Mac, il n´est pas certain qu´elle offre une fonctionnalité quelconque. Les versions de Microsoft Internet Explorer pour Windows récentes connectent cette propriété au contrôle DirectX ActiveX. Durant le chargement du document, la propriété est définie sur auto. Ensuite, un script peut activer ou désactiver la mise en mémoire en affectant une valeur booléenne à cette propriété.

Référence d'objet à la fenêtre (ou au cadre) ayant utilisé une méthode window.open() pour générer la fenêtre active. Cette propriété permet à des sous-fenêtres de grouper des références à des objets, variables et fonctions de la fenêtre d'origine. Pour accéder à des objets document dans la fenêtre d'origine, une référence peut commencer par opener, puis se frayer un chemin, à partir de là, dans la hiérarchie d'objets documents, comme l'illustre la partie gauche de l'exemple d'instruction suivant. La relation entre la fenêtre qui ouvre et la fenêtre ouverte n'est pas à strictement parler une relation parent-enfant. Le terme “ parent ” a d'autres connotations dans les références à des fenêtres et des cadres définies par script. Les fenêtres de dialogue IE (les fenêtres showModalDialog() et showModelessDialog()) ne prennent pas cette propriété en charge. Les valeurs entre la fenêtre principale et les fenêtres de dialogue doivent être transmises au moment de la création et par le biais de la propriété returnValue de la fenêtre de dialogue à la fermeture.

Spécifie la mesure en pixels de la hauteur et de la largeur de la fenêtre ou du cadre du navigateur, y compris (pour la fenêtre du haut) toutes les barres d'outils, les barres de défilement et tout autre habillage visible. IE ne propose pas de propriété équivalente.

Spécifie la mesure en pixels du contenu de la page ayant défilé vers le haut et/ou vers la gauche. Par exemple, si vous avez fait défiler un document (page) jusqu'à ce que les 100 pixels supérieurs de celui-ci ne soient plus visibles, la valeur pageYOffset de la fenêtre indique 100. A défaut de défilement, les deux valeurs sont égales à zéro.

Renvoie une référence à l'objet window parent dont le document définit le jeu de cadres dans lequel est spécifié le cadre actif. Utilisez l'élément parent pour créer une référence, dans un cadre enfant, à des variables ou méthodes du document parent, ou à des variables, méthodes et objets d'un autre cadre enfant. Par exemple, si un script de cadre enfant doit faire référence au contexte d'un élément de formulaire de saisie dans un autre cadre enfant (appelé “ contenu ”), la référence sera:

Voir directories.

Voir crypto.

Voir appCore.

Valeur à renvoyer à la fenêtre principale lors de la fermeture d´une fenêtre de dialogue de Microsoft Internet Explorer (générée par la méthode showModalDialog() uniquement). La valeur affectée à cette propriété dans un script exécuté dans la fenêtre de dialogue devient la valeur renvoyée par la méthode showModalDialog() dans la fenêtre principale. Par exemple, le document affiché dans la fenêtre de dialogue modal peut contenir une instruction définissant la propriété returnValue à l'aide d'informations de la boîte de dialogue:

Renvoie une référence à l'objet screen. La référence window étant facultative, une syntaxe dépourvue de cette référence fonctionne dans toutes les versions prenant en charge les scripts de Microsoft Internet Explorer et Navigator.

Renvoie les coordonnées, en pixels, du coin supérieur gauche de la zone de contenu du navigateur par rapport au coin supérieur gauche de l´écran. Une fenêtre de navigateur agrandie renvoie une valeur screenLeft de 0, mais la valeur screenTop varie selon les barres d´outils que l´utilisateur choisit d´afficher. Utilisez window.moveTo() pour modifier la position de la fenêtre.

Renvoie les coordonnées, en pixels, du coin supérieur gauche de toute la fenêtre du navigateur (habillage inclus) par rapport au coin supérieur gauche de l´écran. Une fenêtre de navigateur agrandie sous Windows renvoie des valeurs screenX et screenY de -4 car l´habillage dépasse légèrement de l´affichage de l´écran. Vous pouvez modifier l´emplacement de la fenêtre par le biais de ces propriétés ou de la méthode window.moveTo().

Renvoie la distance, en pixels, sur laquelle la fenêtre défile le long de l´axe horizontal (scrollX) et de l´axe vertical (scrollY). Pour déterminer ces valeurs dans IE, vous devez prendre en compte les paramètres de mode de compatibilité dans IE 6 (reportez-vous à l´élément DOCTYPE dans le chapitre 8). En mode de compatibilité ascendante et dans IE pour Macintosh, utilisez les propriétés document.body.scrollLeft et document.body.scrollTop. En mode compatible avec les normes IE6 (où document.compatMode == "CSS1Compat"), utilisez document.body.parentNode.scrollLeft et document.body.parentNode.scrollTop pour obtenir les valeurs de défilement de l´élément HTML.

Voir directories.

Référence à la fenêtre ou au cadre actif. Synonyme de window, cette propriété est parfois utilisée pour clarifier un script complexe faisant référence à un grand nombre de fenêtres ou de cadres. N'utilisez jamais la référence window.self pour faire référence à la fenêtre ou au cadre actif car certains navigateurs ne comprennent pas cette référence.

Voir appCore.

Spécifie le texte de la barre d'état de la fenêtre du navigateur. Il est conseillé de ne définir pour la barre d'état que des messages temporaires s'affichant, par exemple, lorsque le curseur de la souris passe au-dessus d'une image, d'une zone ou d'un lien. Il convient de faire précéder les guillemets simples ou doubles, à l'intérieur des messages, d'une barre oblique inversée (\'). Comme la plupart des utilisateurs ne regardent pas la barre d'état, évitez d'y placer des informations essentielles. Les messages temporaires parasitent l'utilisation de la barre d'état par le navigateur, par exemple, pour l'affichage du progrès d'un chargement ou d'une autre action. Pour définir le message par défaut de la barre d'état (en état d'inactivité), voir la section présentant la propriété defaultStatus.

Voir directories.

Voir directories.

Référence d'objet à la fenêtre du navigateur. Les instructions de scripts provenant de cadres imbriqués peuvent faire référence aux propriétés et méthodes de la fenêtre du navigateur ou à des variables ou fonctions stockées dans le dernier document chargé. Ne commencez pas une référence par window.top, mais simplement par top. Pour remplacer un jeu de cadres par un nouveau document occupant toute la fenêtre du navigateur, affectez une adresse URL à la propriété top.location.href.

Référence d'objet à la fenêtre du navigateur.

Bien que l´objet window tel que nous le connaissons ne fasse pas officiellement partie du DOM W3C, Netscape 6 implémente cette méthode de modèle d´événement DOM W3C pour l´objet window. Reportez-vous à la section consacrée à l'objet addEventListener() parmi les méthodes partagées précédemment dans ce chapitre.

Affiche une boîte de dialogue d'alerte contenant le message de votre choix. L´exécution des scripts s´interrompt quand la boîte de dialogue apparaît. Un bouton permet à l'utilisateur de fermer la boîte de dialogue. Il n'est pas possible de modifier par script la barre de titre de la fenêtre (et la légende “ Alerte JavaScript ” dans les anciennes versions de navigateur).

Cette méthode de modèle d´événement IE, partagée par tous les éléments objets, est également un élément de l´objet window. Reportez-vous à la section consacrée à l'objet attachEvent() parmi les méthodes partagées précédemment dans ce chapitre.

Remonte d'une étape dans l'historique de la fenêtre ou du cadre. Vous préférerez peut-être la méthode history.back() compatible avec les divers navigateurs.

Désactive la fenêtre et déclenche un événement onBlur (dans IE). Cela n´entraîne pas nécessairement l´activation d´un autre élément, mais si une autre fenêtre IE est ouverte à ce moment-là, la fenêtre actuelle passe à l´arrière-plan.

Indique au navigateur d'intercepter des événements d'un type spécifique avant qu'ils n'atteignent leurs objets cibles. Pour traiter l'événement, l'objet appelant cette méthode doit disposer de gestionnaires d'événements définis pour ce type d'événement. Bien que cette méthode fasse partie du modèle d´événement Navigator 4, elle est encore prise en charge dans Netscape 6; elle y crée l´équivalent d´un auditeur d´événements en mode capture DOM W3C pour l´objet document. Continuez d´utiliser cette méthode si vous devez prendre Navigator 4 en charge, mais utilisez la syntaxe d´auditeur d´événements DOM W3C pour le nouveau code, comme expliqué dans le chapitre 6.

Arrête l'exécution de la boucle d'intervalle référencée par le paramètre IDintervalle. Voir setInterval() pour plus de détails sur le lancement de cette boucle.

Désactive le compteur de délai d'attente référencé par le paramètre IDdélai. Voir setTimeout() pour plus de détails sur la manière de lancer ce délai.

Ferme la fenêtre active. Un script ne peut pas fermer la fenêtre principale depuis une sous-fenêtre sans autorisation explicite de l'utilisateur à l'aide d'une boîte de dialogue de sécurité. Une fenêtre peut se fermer elle-même (c´est-à-dire à partir d´un script s´exécutant dans la même fenêtre) ou fermer une fenêtre qu´elle a générée par le biais de la méthode window.open().

Affiche une boîte de dialogue contenant un message et deux boutons sur lesquels l'utilisateur peut cliquer. L´exécution des scripts s´interrompt quand la boîte de dialogue apparaît. Un bouton indique une opération Annuler et l'autre indique l´accord de l´utilisateur (OK ou Oui). Le texte des boutons n'est pas modifiable par script. Le message doit poser une question pour laquelle les boutons constituent une réponse logique. Le bouton Annuler renvoie la valeur false, tandis que le bouton OK renvoie la valeur true.

Ouvre un espace rectangulaire contextuel vide qui peut être rempli avec du contenu HTML, mais l´espace peut dépasser les limites du cadre et même les bordures de la fenêtre. Les scripts doivent affecter du contenu (pas une URL externe) à l´objet popup renvoyé par la méthode. Voir l'objet popup pour plus de détails et un exemple de son utilisation.

Cette méthode de modèle d´événement IE, partagée par tous les éléments objets, est également un élément de l´objet window. Reportez-vous à la section consacrée à la méthode detachEvent() parmi les méthodes partagées précédemment dans ce chapitre.

Avec des script signés et l'autorisation de l'utilisateur, un script peut capturer des événements dans d'autres fenêtres ou cadres provenant de domaines autres que celui ayant fourni le document contenant les scripts de capture d'événement. Navigator 4 uniquement.

Bien que l´objet window ne fasse pas officiellement partie du DOM W3C, Netscape 6 implémente cette méthode de modèle d´événement DOM W3C pour l´objet window. Reportez-vous à la section consacrée à l'objet dispatchEvent() parmi les méthodes partagées précédemment dans ce chapitre.

Evalue une ou plusieurs expressions de script dans tout langage de script intégré au navigateur. Les expressions doivent se trouver dans une seule chaîne, séparées, le cas échéant, par des points-virgules:

Recherche une chaîne dans le corps du texte du document, et sélectionne la première occurrence. Vous pouvez demander que la recherche tienne compte de la casse des caractères de la chaîne ou s'effectue vers le haut du document. Dans Navigator 4 , vous pouvez utiliser la méthode document.getSelection() pour extraire une copie du texte trouvé. Toutefois, cette méthode est très loin d'offrir les fonctions de contenu dynamique qu'offre l'objet TextRange de Microsoft Internet Explorer 4 (pour Win32). Cette méthode est déconnectée dans Netscape 6 (elle renvoie toujours false), mais elle est reconnectée dans Netscape 7.

Place la fenêtre à l'avant-plan de toutes les fenêtres ordinaires et déclenche l'événement onFocus (dans IE). Si une autre fenêtre était active, elle reçoit un événement onBlur.

Avance d'une étape dans l'historique de la fenêtre ou du cadre. A défaut d'étape suivante dans l'historique, il ne se passe rien.

Présentée aux auteurs de scripts de façon erronée, cette méthode appelle la façon dont le système d´exploitation alerte un utilisateur que l´application a besoin de son attention. Dans Windows, la zone de la barre des t ches pour la fenêtre du navigateur clignote; dans Mac OS, le système émet un bip sonore et un point apparaît en regard de l´application dans le menu Application. Si la fenêtre du navigateur est déjà au premier plan, aucun signal n´apparaît. Supprimée de Netscape 7.

Renvoie un objet de style (spécifiquement, un objet CSSStyleDeclaration dans la terminologie du DOM W3C) montrant la cascade de styles qui affectent l´élément transmis en tant que premier paramètre. Pour récupérer une valeur particulière d´attribut de style (y compris une valeur héritée de la feuille de style du navigateur par défaut), utilisez la méthode getPropertyValue() de l´objet de style renvoyé par cette méthode:

Renvoie un objet selection, qui peut alors être transformé en objet de plage du DOM W3C. Cette méthode remplace l´ancienne méthode document.getSelection(), délaissée dans Netscape 6. L´opération IE correspondante est la propriété document.selection. Reportez-vous à l'objet selection pour plus de détails au sujet de l´utilisation d´une sélection.

Se dirige vers l'adresse URL définie comme page d'accueil du navigateur. Cela revient au même résultat qu'un clic sur le bouton de la part de l´utilisateur Accueil.

Méthode très pratique permettant de décaler l´emplacement de la fenêtre d'un certain nombre de pixels le long des deux axes. Pour décaler la fenêtre sur un seul axe, paramétrez l'autre valeur sur zéro. Une valeur de deltaX positive décale la fenêtre vers la droite, tandis qu'une valeur négative la décale vers la gauche. Une valeur de deltaY positive décale la fenêtre vers la bas, tandis qu'une valeur négative la décale vers le haut.

Méthode très pratique permettant de décaler l´emplacement de la fenêtre active vers un point de coordonnées spécifique. La méthode moveTo() utilise les coordonnées de l'écran.

Charge un nouveau document dans la fenêtre ou le cadre. C'est ainsi que IE affecte une valeur à la propriété window.location.href.

Ouvre une nouvelle fenêtre (sans fermer la fenêtre d'origine). Vous pouvez indiquer une adresse URL à charger dans la nouvelle fenêtre ou définir ce paramètre comme une chaîne vide afin de permettre aux scripts d'utiliser document.write() dans cette nouvelle fenêtre. Le paramètre windowName permet d'affecter un nom que les attributs target des éléments link et form pourront utiliser. Contrairement aux noms de cadres, ce nom ne doit pas être utilisé dans des instructions de script. Une référence par script à une sous-fenêtre doit désigner l'objet window renvoyé par la méthode window.open(). C'est pourquoi, si un script doit communiquer avec une fenêtre ouverte de cette manière, il est préférable de conserver la valeur renvoyée dans une variable globale, qui sera utilisable par de futures instructions.

Lance le processus d'impression pour la fenêtre ou le cadre. La boîte de dialogue d'impression demande confirmation à l'utilisateur avant d'imprimer le document. Cette méthode équivaut à cliquer sur le bouton role="bold">Imprimer ou à sélectionner la commande Imprimer dans le menu Fichier.

Affiche une boîte de dialogue contenant un message, un champ de saisie d'une ligne de texte, ainsi que deux boutons sur lesquels l'utilisateur peut cliquer. L´exécution des scripts s´interrompt quand la boîte de dialogue apparaît. Le message doit inviter l'utilisateur à entrer un type de réponse spécifique. L'un des boutons indique une opération Annuler, tandis que l'autre indique l´approbation de l´utilisateur quant au texte saisi dans le champ (OK ou Oui. Le texte des boutons n'est pas modifiable par script. Le bouton Annuler renvoie une valeur null, tandis que le bouton OK renvoie la chaîne figurant à ce moment dans le champ de saisie (y compris une chaîne vide). Les scripts doivent tester le type de réponse fournie par l'utilisateur.

A l'opposé de window.captureEvents(), cette méthode désactive la capture d'événement au niveau de la fenêtre pour un ou plusieurs événements spécifiques, nommés dans la liste de paramètres. Bien que cette méthode fasse partie du modèle d´événement Navigator 4, elle est encore prise en charge dans Netscape 6; elle y crée l´équivalent d´un auditeur d´événements en mode capture DOM W3C pour l´objet document. Continuez d´utiliser cette méthode si vous devez prendre Navigator 4 en charge, mais utilisez la syntaxe d´auditeur d´événements DOM W3C pour le nouveau code, comme expliqué dans le chapitre 6.

Bien que l´objet window tel que nous le connaissons ne fasse pas officiellement partie du DOM W3C, Netscape 6 implémente cette méthode de modèle d´événement DOM W3C pour l´objet window. Reportez-vous à la section consacrée à la méthode removeEventListener() parmi les méthodes partagées précédemment dans ce chapitre.

Méthode très pratique permettant de décaler la largeur et la hauteur de la fenêtre d'un certain nombre de pixels. Si vous souhaitez ajuster la fenêtre par rapport à un seul un axe, définissez l'autre valeur sur zéro. Une valeur deltaX positive élargit la fenêtre, tandis qu'une valeur négative la rétrécit. Une valeur deltaX positive allonge la fenêtre, tandis qu'une valeur négative la raccourcit. Les bords supérieur et gauche restent fixes; seuls bougent les bords droit et inférieur.

Méthode très pratique permettant d'ajuster la hauteur et la largeur de la fenêtre sur un nombre de pixels spécifique. Les bords supérieur et gauche de la fenêtre restent fixes; seuls bougent les bords inférieur et droit.

Utilisée dans une fonction de gestionnaire d'événements, cette méthode indique à Navigator 4 (uniquement) de transmettre l'événement à son objet cible.

Définit la position du document après défilement dans la fenêtre ou le cadre actuel. Pour retrouver la position du document avant défilement, définissez les deux paramètres sur zéro.

Fait défiler le document d'un nombre de pixels donné le long des deux axes. Si vous souhaitez ajuster la fenêtre par rapport à un seul un axe, définissez l'autre valeur sur zéro. Une valeur deltaX positive fait défiler le document vers la gauche (pour permettre à l'utilisateur de voir la partie droite), tandis qu'une valeur négative le fait défiler vers la droite. Une valeur deltaY positive fait défiler le document vers le haut (pour permettre à l'utilisateur de voir ce qu'il y a plus bas), tandis qu'une valeur négative le fait défiler vers le bas. Le défilement ne va pas au-delà des points de coordonnées zéro (sauf dans Navigator 4 pour Macintosh).

Fait défiler le document qui se trouve dans la fenêtre vers le bas (valeur positive) ou vers le haut (valeur négative) par incréments de lignes ou de pages. La méthode produit la même action que celle d´un utilisateur cliquant sur les flèches ou de part et d´autre du curseur, dans la barre de défilement vertical, respectivement.

Fait défiler le document jusqu'à une position spécifique définie en pixels.

Transforme le curseur selon le type choisi. Cette méthode est une solution alternative à l´attribut de curseur de la feuille de style. A partir de Netscape 6.2, un curseur modifié par cette méthode garde sa forme jusqu´à ce qu´elle soit explicitement remplacée par une autre forme ou, par défaut, le style auto.La forme précise du curseur est déterminée par le répertoire dont dispose le système d´exploitation. Supprimée de Netscape 7.

Démarre une horloge qui exécute l'expression toutes les millisecondes. D'autres scripts peuvent s'exécuter entre les appels à l'expression. Cette méthode est utile pour démarrer des séquences d'animation devant repositionner un élément le long d'un chemin à une vitesse fixe. Un appel répétitif à une fonction d´animation ressemblerait à ce qui suit:

Démarre une horloge unique qui appelle scriptExpression ou functionReference après un délai de msecs>. D'autres scripts peuvent s'exécuter en attendant que le navigateur appelle l'expression. Une instruction réglant l´horloge ressemblerait à ce qui suit:

Affiche une fenêtre WinHelp contenant le document .hlp spécifié par le paramètre URL.

Affiche une fenêtre spéciale qui reste au-dessus de toutes les fenêtres du navigateur jusqu'à ce que l'utilisateur ferme la boîte de dialogue. Ce type de fenêtre diffère des fenêtres de navigateur créées à l'aide de la méthode window.open(). Une fois ouverte, une boîte de dialogue modal n'a pas de relation gérable par script avec la fenêtre à partir de laquelle elle a été ouverte. Toutes les valeurs nécessaires à l'affichage du contenu doivent figurer dans le document HTML chargé dans la fenêtre, ou être passées sous forme de paramètres. Un script peut définir la propriété returnValue de la boîte de dialogue modale, qui devient la valeur renvoyée par la méthodeshowModalDialog(). Cette propriété est alors la valeur renvoyée à l'instruction de script qui est à l'origine de l'ouverture de la boîte de dialogue modale.

Affiche une fenêtre spéciale qui reste au-dessus de toutes les autres dans le navigateur, mais permet malgré tout à l´utilisateur d´interagir avec les autres fenêtres ouvertes et leur contenu. En-dehors des versions de navigateurs qui la prennent en charge, cette méthode a les mêmes paramètres et caractéristiques que la méthode showModalDialog(). Reportez-vous à cette méthode pour plus de détails.

Permet au navigateur de déterminer la taille de fenêtre optimale pour l´affichage du contenu de la fenêtre. Convient aux sous-fenêtres qui affichent une quantité limitée d´informations.

Arrête le téléchargement de données externes de tout type. Cette action a le même résultat qu'un clic sur le bouton Stop.

Coupe une liaison d'événements précédemment établie entre une fonction de gestionnaire d'événements et le noeud considéré. Cette méthode suppose qu'un auditeur d'événements a été ajouté au noeud à un moment donné. Pour assurer la suppression de l'auditeur d'événements désiré, utilisez les trois mêmes paramètres pour removeEventListener() que ceux que vous avez utilisés pour addEventListener() . Vous pouvez invoquer cette méthode plusieurs fois pour le même noeud, mais avec des valeurs de paramètres différentes afin de ne pas gêner les autres auditeurs d'événements affectés au même noeud. N'invoquez cette méthode que si les interactions de l'utilisateur avec le noeud s'améliorent quand ce gestionnaire d'événements particulier est désactivé.