window | NN 2 IE 3 DOM s.o.
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.
Bien que le DOM W3C niveau 2 ne fournisse pas de spécifications approfondies pour l´objet window (après tout, une fenêtre dépasse la portée du balisage de documents), il indique malgré tout des points d´accueil futurs possibles par l´intermédiaire de ce qu´il appelle objets « view ». Ainsi, la propriété document.defaultView Netscape 6 renvoie la fenêtre du document; l´objet window Netscape 6 adopte aussi la méthode de l´objet ViewCSS pour obtenir la méthode getComputedStyle() du DOM.
L´objet window est définissable par script depuis les tout débuts et dispose donc d´une très vaste gamme de propriétés et méthodes. Bon nombre de ces fonctionnalités sont spécifiques aux navigateurs et vous devez donc consulter les niveaux de compatibilité avant d´adopter une fonctionnalité d´objet particulière.
Référence de modèle d'objet
    window
    self
    top
    parent
Propriétés de gestionnaire d´événements spécifiques à l´objet
Gestionnaire | NN | IE pour Windows | IE/Mac | DOM
onafterprint | s.o | 5 | s.o | s.o
onbeforeprint | s.o | 5 | s.o | s.o
onbeforeunload | s.o | 4 | 4 | s.o
onblur | 3 | 4 | 4 | s.o
ondragdrop | 4 | s.o | s.o | s.o
onerror | 3 | 4 | 4 | s.o
onfocus | 3 | 4 | 4 | s.o
onhelp | s.o | 4 | 4 | s.o
onload | 2 | 3 | 3.01 | s.o
onmove | 4 | 5.5 | s.o | s.o
onresize | 4 | 4 | 4 | s.o
onscroll | s.o | 4 | 4 | s.o
onunload | 2 | 4 | 4 | s.o

clientInformation | NN s.o. IE 4 DOM s.o.
| Lecture seule
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 .
Exemple
    if (parseInt(window.clientInformation.appVersion) >= 4) {
        // process code for IE 4 or later
    }
Valeur
L'objet navigator.
Par défaut
L'objet navigator.

clipboardData | NN s.o. IE 5 (Win) DOM s.o.
| Lecture seule
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.
Exemple
    var rng = document.selection.createRange();
    clipboardData.setData("Text",rng.text);
Valeur
Objet clipboardData.
Par défaut
Objet clipboardData.

closed | NN 3 IE 4 DOM s.o.
| Lecture seule
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().
Exemple
    if (!newWindow.closed) {
        newWindow.document.close();
    }
Valeur
Valeur booléenne: true | false.
Par défaut
Aucune.

Components, content, controllers |
Voir appCore.

crypto, pkcs11 | NN 6 IE s.o. DOM s.o.
| Lecture seule
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/.

defaultStatus | NN 2 IE 3 DOM s.o.
| Lecture/écriture
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.
Exemple
    window.defaultStatus = "Make it a great day!";
Valeur
Toute chaîne de texte.
Par défaut
Aucune.

dialogArguments | NN s.o. IE 4 DOM s.o.
| Lecture seule
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.
Exemple
    // in dialog window
    var allArgs = window.dialogArguments;
    var firstArg = allArgs.substring(0, allArgs.indexOf(";"));
Valeur
Chaîne, nombre, tableau ou objet.
Par défaut
Aucune.

dialogHeight, dialogWidth | NN s.o. IE 4 (Win) DOM s.o.
| Lecture/écriture
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.
Exemple
    var outerWidth = window.dialogWidth;
Valeur
Chaîne incluant la valeur de l'unité (par exemple, 520px).
Par défaut
Aucune.

dialogLeft, dialogTop | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
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.
Exemple
    var outerLeft = window.dialogLeft;
Valeur
Chaîne incluant la valeur de l'unité (par exemple, 80px).
Par défaut
Aucune.

directories, locationbar, menubar, personalbar, scrollbars, statusbar, toolbar | NN 4 IE s.o. DOM s.o.
| Lecture seule
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.
Exemple
    netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserWrite")
    window.statusbar.visible = "false";
    netscape.security.PrivilegeManager.revertrivilege("UniversalBrowserWrite")
Valeur
Références d'objet correspondantes.
Par défaut
Aucune.

document | NN 2 IE 3 DOM 2
| Lecture seule
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.
Exemple
    var oneElem = document.getElementById("myP");
Valeur
Référence à un objet document racine.
Par défaut
Référence à un objet document racine.

_event | NN s.o. IE 4 DOM s.o.
| Lecture seule
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.
Exemple
    if (event.altKey) {
        // handle case of Alt key down
    }
Valeur
Référence de l'objet event.
Par défaut
Aucune.

external | NN s.o. IE 4 (Win) DOM s.o.
| Lecture seule
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.
Exemple
    external.AddFavorite("http://www.dannyg.com", "Danny Home Page");
Valeur
Référence de l'objet external.
Par défaut
Référence de l'objet external.

frameElement | NN s.o. IE 5,5 (Win) DOM s.o.
| Lecture seule
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é.
Exemple
    var frameID = window.frameElement.id;
Valeur
Référence de l'objet frame ou iframe; null.
Par défaut
null.

frames[] | NN 2 IE 3 DOM s.o.
| Lecture seule
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.
Exemple
    parent.frames[1].myFunc();
Valeur
Tableau des références des objets frame (window).
Par défaut
Tableau de longueur zéro.

history | NN 2 IE 3 DOM s.o.
| Lecture seule
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.
Exemple
    if (self.history.length > 4) {
        ...
    }
Valeur
Référence de l'objet history.
Par défaut
Objet history courant.

innerHeight, innerWidth | NN 4 IE s.o. DOM s.o.
| Lecture/écriture
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.
Exemple
    window.innerWidth = 600;
    window.innerHeight = 400;
Valeur
Nombre entier.
Par défaut
Aucune.

length | NN 6 IE 4 DOM s.o.
| Lecture seule
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.
Exemple
    if (window.length > 0) {
        ...
    }
Valeur
Nombre entier.
Par défaut
0

location | NN 2 IE 3 DOM s.o.
| Lecture/écriture
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.
Exemple
    top.location.href = "index.html";
Valeur
Adresse URL complète ou relative sous forme de chaîne.
Par défaut
Objet location courant.

locationbar |
Voir directories.

menubar |
Voir directories.

name | NN 2 IE 3 DOM s.o.
| Lecture/écriture
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.
Exemple
    if (parent.frames[1].name == "main") {
        ...
    }
Valeur
Identifiant sensible à la casse, conforme aux règles de dénomination des identifiants: il ne peut pas contenir d'espace blanc ni de signe de ponctuation, à l'exception du caractère de soulignement, et ne peut pas commencer par un chiffre.
Par défaut
Aucune.

navigator | NN 6 IE 4 DOM s.o.
| Lecture seule
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.
Exemple
    var theBrowser = navigator.appName;
Valeur
Référence de l´objet navigator.
Par défaut
Objet navigator.

offscreenBuffering | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
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é.
Exemple
    window.offscreenBuffering = "true";
Valeur
Valeur booléenne: true | false.
Par défaut
auto

opener | NN 3 IE 3 DOM s.o.
| Lecture/écriture
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.
Exemple
    opener.document.forms[0].importedData.value = document.forms[0].entry.value;
Valeur
Référence de l'objet window.
Par défaut
Aucune.

outerHeight, outerWidth | NN 4 IE s.o. DOM s.o.
| Lecture/écriture
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.
Exemple
    window.outerWidth = 80;
    window.outerHeight = 600;
Valeur
Nombre entier.
Par défaut
Aucune.

pageXOffset, pageYOffset | NN 4 IE s.o. DOM s.o.
| Lecture seule
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.
Exemple
    var vertScroll = self.pageYOffset;
Valeur
Nombre entier.
Par défaut
0

parent | NN 2 IE 3 DOM s.o.
| Lecture seule
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:
Pour créer des cadres plus profondément imbriqués, vous pouvez accéder au parent d'un parent en utilisant une syntaxe telle que: parent.parent.frameName.
Exemple
    parent.frames[1].document.forms[0].companyName.value = "MegaCorp";
Valeur
Référence de l'objet window.
Par défaut
Référence de l'objet window courant.

personalbar |
Voir directories.

pkcs11 |
Voir crypto.

prompter |
Voir appCore.

returnValue | NN s.o. IE 4(Win)/5(Mac) DOM s.o.
| Lecture/écriture
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:
La boîte de dialogue est créée dans le document principal avec une instruction telle que:
Toute valeur affectée à returnValue dans la boîte de dialogue est ensuite affectée à la variable userName lors de la fermeture de la boîte de dialogue, tandis que l'exécution du script se poursuit.
Valeur
Tout type de données gérable par script.
Par défaut
Aucune.

screen | NN 6 IE 4 DOM s.o.
| Lecture seule
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.
Exemple
    var howHigh = screen.availHeight;
Valeur
Référence à l´objet screen.
Par défaut
Objet screen.

screenLeft, screenTop | NN s.o. IE 5 (Win) DOM s.o.
| Lecture seule
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.
Exemple
    var fromTheTop = window.screenTop;
Valeur
Nombre entier.
Par défaut
Dépend de l´utilisateur.

screenX, screenY | NN 6 IE s.o. DOM s.o.
| Lecture/écriture
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().
Exemple
    var fromTheTop = window.screenY;
Valeur
Nombre entier.
Par défaut
Dépend de l´utilisateur.

scrollX, scrollY | NN 6 IE s.o. DOM s.o.
| Lecture seule
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.
Exemple
    var scrolledDown = window.scrollY;
Valeur
Nombre entier.
Par défaut
0

scrollbars |
Voir directories.

self | NN 2 IE 3 DOM s.o.
| Lecture seule
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.
Exemple
    self.focus();
Valeur
Référence de l'objet window.
Par défaut
Fenêtre active.

status | NN 2 IE 3 DOM s.o.
| Lecture/écriture
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.
Exemple
    <...onmouseover="window.status='Table of Contents';return true"
    onmouseout = "window.status = '';return true">
Valeur
Chaîne.
Par défaut
Une chaîne vide.

statusbar |
Voir directories.

toolbar |
Voir directories.

top | NN 2 IE 3 DOM s.o.
| Lecture seule
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.
Exemple
    top.location.href = "tableOfContents.html";
Valeur
Référence de l'objet window.
Par défaut
Fenêtre du navigateur.

window | NN 2 IE 3 DOM s.o.
| Lecture seule
Référence d'objet à la fenêtre du navigateur.
Exemple
    if (window == top) {
        // load a frameset
        location.href = "mainFrameset.html";
    }
Valeur
Référence de l'objet window.
Par défaut
Fenêtre du navigateur.

addEventListener() | NN 6 IE s.o. DOM s.o.
addEventListener("eventType", listenerFunction, useCapture) |
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.

alert() | NN 2 IE 3 DOM s.o.
alert("message") |
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).
Paramètres
Toute chaîne de texte.
Valeur renvoyée
Aucune.

attachEvent() | NN s.o. IE 5 (Win) DOM s.o.
attachEvent("eventName", functionReference) |
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.

back() | NN 4 IE s.o. DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

blur() | NN 3 IE 4 DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

captureEvents() | NN 4 IE s.o. DOM s.o.
captureEvents(eventTypeList) |
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.
Paramètres
Types d'événements non sensibles à la casse, séparés par des virgules dans une liste, dérivés des constantes d'objet Event disponibles, telles que Event.CLICK ou Event.MOUSEMOVE.
Valeur renvoyée
Aucune.

clearInterval() | NN 4 IE 4 DOM s.o.
clearInterval(IDintervalle) |
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.
Paramètres
Nombre entier généré comme valeur de renvoi par la méthode setInterval().
Valeur renvoyée
Aucune.

clearTimeout() | NN 2 IE 3 DOM s.o.
clearTimeout(IDdélai) |
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.
Paramètres
Nombre entier généré comme valeur de renvoi par la méthode setTimeout().
Valeur renvoyée
Aucune.

close() | NN 2 IE 3 DOM s.o.
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().
Paramètres
Aucune.
Valeur renvoyée
Aucune.

confirm() | NN 2 IE 3 DOM s.o.
confirm("message") |
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.
Etant donné que cette méthode renvoie une valeur booléenne, vous pouvez l'utiliser dans l'expression d'une condition:
Paramètres
Une chaîne quelconque, généralement sous forme de question.
Valeur renvoyée
Valeur booléenne: true | false.

createPopup() | NN s.o. IE 5,5 (Win) DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Référence de l'objet popup.

detachEvent() | NN s.o. IE 5 (Win) DOM s.o.
detachEvent("eventName", functionReference) |
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.

disableExternalCapture(), enableExternalCapture() | NN |4| IE s.o. DOM n/a
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.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

dispatchEvent() | NN 6 IE s.o DOM 2
dispatchEvent(eventObjectReference) |
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.

execScript() | NN s.o. IE 4 DOM s.o.
execScript(liste_expressions [, langage]) |
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:
Le langage de script par défaut est JavaScript. Si vous voulez voir les résultats de l'exécution du script, prévoyez leur affichage dans les expressions du script, comme le montre l´exemple. En elle-même, la méthode execScript() ne renvoie pas de valeur.
Paramètres
Valeur d'une (ou plusieurs) expression(s) de script séparée(s) par des points-virgules, sous forme de chaîne. Valeur d'un langage de script sous forme de chaîne: JavaScript | JScript | VBS | VBScript.
Valeur renvoyée
Aucune.

find() | NN 4 IE s.o. DOM s.o.
find("searchString"[, matchCase[, searchUpward]]) |
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.
Paramètres
Chaîne à rechercher dans le document. Valeur booléenne: true indique que la recherche ne doit porter que sur des correspondances exactes sensibles à la casse; false (par défaut) indique que la recherche est non sensible à la casse. Valeur booléenne: true indique que la recherche doit s'effectuer vers le haut, à partir de la position sélectionnée;false (par défaut) indique que la recherche doit s'effectuer vers le bas.
Valeur renvoyée
Valeur booléenne: true indique qu'une correspondance a été trouvée; false indique le contraire ou Netscape 6 uniquement.

focus() | NN 3 IE 4 DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

forward() | NN 4 IE s.o. DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

GetAttention() | NN |6| IE s.o. DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

getComputedStyle() | NN 6 IE s.o DOM 2
getComputedStyle(elementNodeReference, "pseudoElementName") |
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:
Voir l'objet style pour plus de détails.
Paramètres
Référence à un noeud élément dans l´arborescence de documents qui devient la sélection. Nom, sous la forme de chaîne, d´un pseudo-élément (par exemple :first-line) ou chaîne vide.
Valeur renvoyée
Référence de l'objet style (CSSStyleDeclaration).

getSelection() | NN 6 IE s.o. DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Référence de l´objet selection.

home() | NN 4 IE s.o. DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

moveBy() | NN 4 IE 4 DOM s.o.
moveBy(deltaX, deltaY) |
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.
Paramètres
Nombre positif ou négatif de pixels déterminant le déplacement horizontal de la fenêtre. Nombre positif ou négatif de pixels déterminant le déplacement vertical de la fenêtre.
Valeur renvoyée
Aucune.

moveTo() | NN 4 IE 4 DOM s.o.
moveTo(x, y) |
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.
Paramètres
Nombre positif ou négatif de pixels par rapport à la partie supérieure de l'écran. Nombre positif ou négatif de pixels par rapport au côté gauche de l'écran.
Valeur renvoyée
Aucune.

navigate() | NN s.o. IE 3 DOM s.o.
navigate(adresse_URL) |
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.
Paramètres
Adresse URL complète ou relative sous forme de chaîne.
Valeur renvoyée
Aucune.

open() | NN 2 IE 3 DOM s.o.
open("URL", "windowName"[, "windowFeatures"]) open("URL", "windowName"[, "windowFeatures"][, replaceFlag]) |
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.
Le problème, avec les sous-fenêtres, est qu'elles peuvent disparaître derrière la fenêtre principale si l'utilisateur clique dessus (ou si un script l'active). Tout script ouvrant une sous-fenêtre devrait inclure une méthode focus() (dans Navigator 3 et IE 4, ainsi que leurs versions postérieures) pour veiller à ce qu'elle apparaisse à l'avant-plan si elle est déjà ouverte. Tout appel ultérieur de la méthode window.open() dont le paramètre windowName est identique à celui d'un appel précédent pointe automatiquement sur la fenêtre préalablement ouverte, même si elle se trouve sous la fenêtre principale (et n´amène donc pas la fenêtre au premier plan).
Le troisième paramètre est facultatif et permet de contrôler divers attributs physiques de la sous-fenêtre. Le paramètre paramètres_fenêtre est une chaîne unique comprenant une liste séparée par des virgules (sans espaces entre les éléments) de paires attributs/valeurs:
Par défaut, tous les attributs de fenêtre sont activés et, à l'ouverture, la sous-fenêtre a la même taille que celle qu'utiliserait le navigateur pour ouvrir une nouvelle fenêtre à partir du menu Fichier. Toutefois, si le script spécifie ne serait-ce qu'un attribut, tous les paramètres sont désactivés. C'est pourquoi vous devez utiliser le paramètre paramètres_fenêtre pour spécifier les fonctions que vous souhaitez activer.
Si vous rencontrez des difficultés pour référencer une sous-fenêtre juste après sa création, il s´agit probablement d´un problème de synchronisation (IE pour Windows est plus affecté par ce problème que les autres navigateurs). Les instructions de script semblent vouloir référencer la fenêtre avant qu´elle n´existe complètement. Pour éviter ce problème, placez le code qui traite la sous-fenêtre dans une fonction indépendante et invoquez cette fonction par le biais de la méthode setTimeout(): il ne faut généralement pas plus de 50 millisecondes.
La gestion de plusieurs fenêtres par le biais des scripts peut être difficile. Les restrictions de sécurité des domaines viennent souvent à bout des meilleures intentions. Les utilisateurs aiment rarement que des fenêtres apparaissent et disparaissent d´elles-mêmes. Si votre public utilise des navigateurs récents, pensez à simuler des fenêtres avec éléments positionnés.
Paramètres
Attribut | NN | IE | Description
alwaysLowered | 4 | s.o | Toujours derrière toutes les autres fenêtres du navigateur. Script signé obligatoire.
alwaysRaised | 4 | s.o | Toujours devant toutes les autres fenêtres de navigateur. Script signé obligatoire.
channelMode | s.o | 4 | Affiché en mode cinéma avec la bande de canal.
copyhistory | 2 | 3 | Copie dans la nouvelle fenêtre l'historique de la fenêtre active.
dependent | 4 | s.o | La sous-fenêtre se ferme lorsque la fenêtre qui l'a ouverte se ferme.
directories | 2 | 3 | Affiche des boutons de répertoire.
fullscreen | s.o | 4 | N´affiche ni barre de titre ni menu
height | 2 | 3 | Hauteur de la fenêtre en pixels.
hotkeys | 4 | s.o | Désactive les raccourcis-clavier du menu (sauf Quitter et Informations relatives à la sécurité).
innerHeight | 4 | s.o | Hauteur de la zone de contenu. Script signé obligatoire pour les très petites mesures.
innerWidth | 4 | s.o | Largeur de la zone de contenu. Script signé obligatoire pour les très petites mesures.
left | 6 | 4 | Décalage entre le bord gauche de la fenêtre et le bord gauche de l'écran.
location | 2 | 3 | Affiche le champ texte d´emplacement (ou d'adresse).
menubar | 2 | 3 | Affiche la barre de menus (une barre de menus est toujours visible sur Macintosh).
outerHeight | 4 | s.o | Hauteur totale de la fenêtre. Script signé obligatoire pour les très petites mesures.
outerWidth | 4 | s.o | Largeur totale de la fenêtre. Script signé obligatoire pour les très petites mesures.
resizable | 2 | 3 | Permet de redimensionner la fenêtre (toujours autorisé sur Macintosh).
screenX | 4 | s.o | Décalage entre le bord gauche de la fenêtre et le bord gauche de l'écran. Script signé obligatoire pour déplacer une fenêtre hors écran.
screenY | 4 | s.o | Décalage entre le bord supérieur de la fenêtre et le bord supérieur de l'écran. Script signé obligatoire pour déplacer une fenêtre hors écran.
scrollbars | 2 | 3 | Affiche les barres de défilement si la taille du document dépasse la capacité d'affichage de la fenêtre.
status | 2 | 3 | Affiche la barre d'état.
titlebar | 4 | s.o | Affiche la barre de titre. Définissez cette valeur sur no pour masquer la barre de titre. Script signé obligatoire.
toolbar | 2 | 3 | Affiche la barre d'outils (avec les boutons Précédente, Suivante, etc.)
top | 6 | 4 | Décalage entre le bord supérieur de la fenêtre et le bord supérieur de l'écran.
width | 2 | 3 | Largeur de la fenêtre en pixels.
z-lock | 4 | s.o | Permet de fixer la nouvelle fenêtre sous les fenêtres du navigateur. Script signé obligatoire.
Adresse URL complète ou relative sous forme de chaîne. Si la chaîne est vide, aucun document ne se charge dans la fenêtre. Identifiant de la fenêtre devant être utilisé par les attributs target. Ce dernier diffère de l'attribut title du document chargé dans la fenêtre. Chaîne contenant les fonctionnalités, séparées par des virgules, à activer dans la nouvelle fenêtre. N'insérez pas d'espaces derrière les virgules de séparation. La liste des fonctionnalités possibles est longue, mais nombre d'entre elles sont spécifiques à Navigator 4 ou versions ultérieures et requièrent des scripts signés afin de garantir la confidentialité et la sécurité à des utilisateurs trop confiants. Ces fonctionnalités sont répertoriées ci-dessous. Pour activer une fonctionnalité, il suffit d'inclure son nom (sensible à la casse) dans la liste de fonctionnalités séparées par des virgules. Seuls les attributs spécifiant des dimensions requièrent l'affectation de valeurs.
Valeur booléenne (pour IE uniquement) qui contrôle l´effet de l´URL de la nouvelle fenêtre sur l´historique global du navigateur. Définissez-la comme true pour remplacer la page actuelle avec l´URL de la nouvelle fenêtre (de façon à ce que l´accès à la page actuelle avec le bouton Précédente ne se fasse pas); définissez-la comme false pour ajouter normalement l´URL de la nouvelle fenêtre à l´historique.
Valeur renvoyée
Référence de l'objet window.

print() | NN 4 IE 5 DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

prompt() | NN 2 IE 3 DOM s.o.
prompt("message", "defaultReply") |
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.
Paramètres
Toute chaîne de texte. Toute chaîne suggérant une réponse. Toujours fournir une valeur, même s'il s'agit d'une chaîne vide.
Valeur renvoyée
Si vous cliquez sur le bouton OK, la chaîne du champ de saisie de texte; si vous cliquez sur role="bold">Annuler, la valeur null.

releaseEvents() | NN 4 IE s.o. DOM s.o.
releaseEvents(liste_types_événements) |
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.
Paramètres
Types d'événements non sensibles à la casse, séparés par des virgules dans une liste, dérivés des constantes d'objet Event disponibles, telles que Event.CLICK ou Event.MOUSEMOVE.
Valeur renvoyée
Aucune.

removeEventListener() | NN 6 IE s.o. DOM s.o.
removeEventListener("eventType", listenerFunction, useCapture) |
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.

resizeBy() | NN 4 IE 4 DOM s.o.
resizeBy(deltaX, deltaY) |
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.
Paramètres
Nombre positif ou négatif de pixels déterminant le changement de dimension horizontale de la fenêtre. Nombre positif ou négatif de pixels déterminant le changement de dimension verticale de la fenêtre.
Valeur renvoyée
Aucune.

resizeTo() | NN 4 IE 4 DOM s.o.
resizeTo(x, y) |
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.
Paramètres
Largeur de la fenêtre en pixels. Hauteur de la fenêtre en pixels.
Valeur renvoyée
Aucune.

routeEvent() | NN |4| IE s.o. DOM n/a
routeEvent(événement) |
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.
Paramètres
Objet event de Navigator 4.
Valeur renvoyée
Aucune.

scroll() | NN 3 IE 4 DOM s.o.
scroll(x, y) |
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.
Paramètres
Mesure horizontale de défilement dans la fenêtre. Mesure verticale de défilement dans la fenêtre.
Valeur renvoyée
Aucune.

scrollBy() | NN 4 IE 4 DOM s.o.
scrollBy(deltaX, deltaY) |
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).
Paramètres
Nombre positif ou négatif de pixels exprimant le changement de position de défilement horizontal. Nombre positif ou négatif de pixels exprimant le changement de position de défilement vertical.
Valeur renvoyée
Aucune.

scrollByLines(), scrollByPages() | NN 6 IE s.o. DOM s.o.
scrollByLines(intervalCount) scrollByPages(intervalCount) |
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.
Paramètres
Nombre positif ou négatif exprimant le changement de position de défilement vertical. Les unités sont déterminées par la méthode choisie (lignes ou pages).
Valeur renvoyée
Aucune.

scrollTo() | NN 4 IE 4 DOM s.o.
scrollTo(x, y) |
Fait défiler le document jusqu'à une position spécifique définie en pixels.
Paramètres
Position horizontale de la fenêtre en pixels. Position verticale de la fenêtre en pixels.
Valeur renvoyée
Aucune.

setCursor() | NN |6| IE s.o. DOM s.o.
setCursor("cursorType") |
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.
Paramètres
alias | auto | cell | context-menu
copy | count-down | count-up | count-up-down
crosshair | default | e-resize | grab
grabbing | help | move | n-resize
ne-resize | nw-resize | pointer | s-resize
se-resize | spinning | sw-resize | text
w-resize | wait |  |
Nom, sous forme de chaîne, d´un style de curseur, tel que:
Valeur renvoyée
Aucune.

setInterval() | NN 4 IE 4 DOM s.o.
setInterval("scriptExpression", msecs[, language]) setInterval(functionReference, msecs[, arg1, ..., argN]) |
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:
La situation des paramètres peut être difficile à saisir. L´approche la plus simple et la plus adaptée à tous les navigateurs est d´invoquer une fonction de script (sous forme de chaîne), avec l´intervalle (en millisecondes) comme deuxième paramètre. Toute expression de script s´exécutera, mais l´expression est évaluée au moment de l´invocation de la méthode setInterval(). Ainsi, si vous concaténez des variables dans cette expression, leurs valeurs doivent être prêtes lors de l´exécution de la méthode setInterval(), même si ces variables ne sont utilisées que quelques millisecondes plus tard.
IE autorise un troisième paramètre à spécifier un langage de script différent dans lequel l´expression est exécutée. Sauf dans le cas d´une expression VBScript, vous pouvez omettre ce paramètre. Cependant, Navigator vous permet de substituer une référence de fonction (pas une chaîne) comme premier paramètre et de transmettre une liste de paramètres délimitée par des virgules à l´appel de fonction. Ces paramètres se placent après le temps en msecs et ils peuvent comporter n´importe quel type de données.
Cette méthode renvoie un ID qui doit être enregistré comme variable globale et être disponible comme paramètre pour la méthode clearInterval(), qui arrête l'exécution en boucle. A moins que vous n´effaciez explicitement le processus d´intervalle, il continue de s´exécuter jusqu´au déchargement de la page.
Paramètres
Toute expression de script sous forme de chaîne, généralement une fonction. Le nom de la fonction, avec ses parenthèses, est placé dans la chaîne de paramètre, entre guillemets. Référence à une fonction autre qu´une chaîne (nom de fonction sans les parenthèses). Temps en millisecondes entre les appels de expression ou functionReference. Liste facultative de paramètres, séparés par des virgules, à transmettre à une fonction utilisée comme paramètre de functionReference. Navigator uniquement. Spécification facultative du langage de script du paramètre expression (par défaut JavaScript). IE pour Windows uniquement.
Valeur renvoyée
Nombre entier faisant office d'identifiant pour ce processus répétitif.

setTimeout() | NN 2 IE 3 DOM s.o.
setTimeout("scriptExpression", msecs[, language]) setTimeout(functionReference, msecs[, arg1, ..., argN]) |
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:
La situation des paramètres peut être difficile à saisir. L´approche la plus simple et la plus adaptée à tous les navigateurs est d´invoquer une fonction de script (sous forme de chaîne), avec l´intervalle (en millisecondes) comme deuxième paramètre. Toute expression de script s´exécutera, mais l´expression est évaluée au moment de l´invocation de la méthode setTimeout(). Ainsi, si vous concaténez des variables dans cette expression, leurs valeurs doivent être prêtes lors de l´exécution de la méthode setTimeout(), même si ces variables ne sont utilisées que quelques millisecondes plus tard.
IE autorise un troisième paramètre à spécifier un langage de script différent dans lequel l´expression est exécutée. Sauf dans le cas d´une expression VBScript, vous pouvez omettre ce paramètre. Cependant, Navigator vous permet de substituer une référence de fonction (pas une chaîne) comme premier paramètre et de transmettre une liste de paramètres délimitée par des virgules à l´appel de fonction. Ces paramètres se placent après le temps en msecs et ils peuvent être de n´importe quel type de données.
Cette méthode renvoie un ID qui doit être enregistré comme variable globale et être disponible comme paramètre pour la méthode clearTimeout afin d'arrêter l'horloge avant qu'elle n´expire et appelle l´action retardée.
La méthode setTimeout() peut être paramétrée pour réagir comme la méthode setInterval() dans certaines constructions. Si vous placez une méthode setTimeout() comme dernière instruction d'une fonction et indiquez à la méthode d'appeler cette même fonction (récursivité), vous pouvez créer une exécution en boucle avec un délai défini entre les différentes exécutions. Avant l'existence de cette méthode setInterval(), les navigateurs agissaient de la sorte pour les scripts de t ches répétitives, par exemple pour l'affichage d'une horloge numérique actualisée dans des champs de formulaire ou dans la barre d'état.
Paramètres
Toute expression de script sous forme de chaîne, généralement une fonction. Le nom de la fonction, avec ses parenthèses, est placé dans la chaîne de paramètre, entre guillemets. Référence à une fonction autre qu´une chaîne (nom de fonction sans les parenthèses). Temps en millisecondes pendant lequel le navigateur doit attendre avant d'appeler l'expression. Liste facultative de paramètres, séparés par des virgules, à transmettre à une fonction utilisée comme paramètre de functionReference. Navigator uniquement. Spécification facultative du langage de script du paramètre expression (par défaut JavaScript). IE pour Windows uniquement.
Valeur renvoyée
Nombre entier faisant office d'identifiant.

showHelp() | NN s.o. IE 4 (Win) DOM s.o.
showHelp("URL") |
Affiche une fenêtre WinHelp contenant le document .hlp spécifié par le paramètre URL.
Paramètres
Adresse URL complète ou relative, sous forme de chaîne, d´un fichier formaté WinHelp.
Valeur renvoyée
Aucune.

showModalDialog() | NN s.o. IE 4 DOM s.o.
showModalDialog("URL"[, arguments[, "features"]]) |
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.
Vous pouvez passer des arguments à la boîte de dialogue modal en créant une structure de données appropriée aux données. Pour une valeur unique, une chaîne suffit. En revanche, pour des valeurs multiples, vous pouvez créer soit une chaîne avec un séparateur unique entre les valeurs, soit un tableau que vous spécifiez comme deuxième paramètre pour la méthode showModalDialog(). Un script dans le document chargé dans la boîte de dialogue modale peut alors examiner la propriété window.dialogArguments et analyser les arguments en fonction des besoins. Voir la propriété dialogArguments à titre d'exemple.
Le troisième paramètre facultatif permet de définir les caractéristiques physiques de la boîte de dialogue. Ces caractéristiques sont spécifiées dans une syntaxe de style CSS. Les dimensions de dialogWidth, dialogHeight, dialogLeft et dialogTop doivent être indiquées en pixels. Voici un exemple d'appel à une boîte de dialogue modale:
Aucune caractéristique de troisième paramètre n'étant reconnue par Internet Explorer 4 pour Macintosh, la boîte de dialogue modale est maximisée.
Les boîtes de dialogue modales peuvent poser des problèmes aux scripts si la page charge un jeu de cadres. Il est probable qu´un script à l´intérieur d´un cadre ne soit pas capable de référencer la fenêtre parent ou supérieure afin d´accéder à la méthode close() de la fenêtre ou au contenu d´un autre cadre.
Paramètres
Fonctionnalité | Valeur | Description
center | yes | no | 1 | 0 | on | off | Centrent la boîte de dialogue
dialogHeight | Longueur/unités | Hauteur extérieure de la boîte de dialogue
dialogLeft | Nombre entier | Décalage gauche en pixels (prend le pas sur le centre)
dialogTop | Nombre entier | Décalage supérieur en pixels (prend le pas sur le centre)
dialogWidth | Longueur/unités | Largeur extérieure de la boîte de dialogue
edge | raised | sunken | Style de la transition entre la bordure et la zone du contenu
help | yes | no | 1 | 0 | on | off | Affichent l´icône d´aide dans la barre de titre
resizable | yes | no | 1 | 0 | on | off | La boîte de dialogue peut être redimensionnée
status | yes | no | 1 | 0 | on | off | Affiche la barre d'état
Adresse URL complète ou relative sous forme de chaîne. Données sous forme de nombre, de chaîne ou de tableau à passer aux scripts du document chargé dans la boîte de dialogue modal. Chaîne d'attributs et de valeurs, séparés par des points-virgules, définissant les caractéristiques physiques de la boîte de dialogue modal. Les attributs disponibles sont indiqués dans le tableau suivant.
Valeur renvoyée
Valeur affectée à la propriété window.returnValue, le cas échéant, dans le document chargé dans la boîte de dialogue modale.

showModelessDialog() | NN s.o. IE 5 (Win) DOM s.o.
showModelessDialog("URL"[, arguments[, "features"]]) |
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.

sizeToContent() | NN 6 IE s.o. DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

stop() | NN 4 IE s.o. DOM s.o.
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.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

removeEventListener() | NN 6 IE s.o. DOM 2
removeEventListener("eventType", listenerFunction, useCapture) |
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é.
Paramètres
abort | blur | change
click | DOMActivate | DOMAttrModified
DOMCharacterDataModified | DOMFocusIn | DOMFocusOut
DOMNodeInserted | DOMNodeInsertedIntoDocument | DOMNodeRemoved
DOMNodeRemovedFromDocument | DOMSubtreeModified | error
focus | load | mousedown
mousemove | mouseout | mouseover
mouseup | reset | resize
scroll | select | submit
unload |  |
Une chaîne d'un type d'événement (sans le préfixe "on") connu du modèle d'objet du navigateur. Le DOM W3C connaît les types d'événements suivants (et Netscape 6 implémente la plupart d'entre eux):
Une référence à la fonction qui est exécutée lorsque le noeud entend le type d'événement dans le mode de propagation spécifié. Comme il s'agit d'une référence à un objet de fonction, n'utilisez pas de guillemets autour du nom et n'incluez pas les parenthèses de la fonction. Au moment de l'exécution, le navigateur transmet automatiquement l'objet event considéré, comme paramètre, à la fonction d'auditeur. Une valeur booléenne. Si la valeur est true , le noeud « écoute » pour repérer le type d'événement uniquement pendant que l'événement se propage vers le noeud cible (en mode de capture d'événements). Si la valeur est false , le noeud « écoute » seulement lorsque l'événement se propage vers l'extérieur à partir de la cible de l'événement. Si le noeud considéré est la cible de l'événement, les deux valeurs booléennes peuvent être utilisées.
Valeur renvoyée
Aucune.