Objet Window


Les propriétés "self" et "window" sont synonymes pour la fenêtre courante. Vous pouvez les utiliser pour faire référence à la fenêtre courante. Par exemple, il est possible de fermer la fenêtre courante en appelant soit window.close() ou self.close().

Les propriétés "top" et "parent" sont aussi synonymes et peuvent être utilisées à la place du nom de la fenêtre. top fait référence à la fenêtre principale du navigateur et parent fait référence à une fenêtre contenant une commande FRAMESET.

Syntaxe

Pour définir une fenêtre, il faut utiliser la méthode open:

varFenêtre = window.open("URL", "nomFenêtre" [,"caractérisiquesFenêtre"])

varFenêtre est le nom d'une nouvelle fenêtre. Il faut utiliser cette variable pour faire référence aux propriétés, aux méthodes et au contenu d'une fenêtre.
nomFenêtre est le nom d'une fenêtre qui est utile pour l'attribut TARGET d'un marqueur <FORM> ou <A>.

Pour utiliser les propriétés et les méthodes de l'objet "window":

  1. window.nomPropriété
  2. window.nomMéthode(paramètres)
  3. self.nomPropriété
  4. self.nomMéthode(paramètres)
  5. top.nomPropriété
  6. top.nomMéthode(paramètres)
  7. parent.nomPropriété
  8. parent.nomMéthode(paramètres)
  9. VarFenêtre.nomPropriété
  10. VarFenêtre.nomMéthode(paramètres)
  11. nomPropriété
  12. nomMéthode(paramètres)

nomPropriété est l'une des propriétés utilisées avec l'objet.
nomMéthodes est l'une des méthodes utilisées avec l'objet.
varFenêtre est une variable qui fait référence à un objet "window".

Propriétés

defaultStatus	(>JavaScript1.0, JScript1.0)
frames		(>JavaScript1.0, JScript1.0)
innerHeight	(>JavaScript1.2)
innerWidth	(>JavaScript1.2)
length		(>JavaScript1.0, JScript1.0)
name		(>JavaScript1.0, JScript1.0)
opener		(>JavaScript1.1)
outerHeight	(>JavaScript1.2)
outerWidth	(>JavaScript1.2)
pageXOffset	(>JavaScript1.2)
PageYOffset	(>JavaScript1.2)
parent		(>JavaScript1.0, JScript1.0)
self		(>JavaScript1.0, JScript1.0)
status		(>JavaScript1.0, JScript1.0)
top		(>JavaScript1.0, JScript1.0)
window		(>JavaScript1.0, JScript1.0)

Les objets suivants sont aussi des propriétés de l'objet "window":

document	(>JavaScript1.0, JScript1.0)
Frame		(>JavaScript1.0, JScript1.0)
History		(>JavaScript1.0, JScript1.0)
Location	(>JavaScript1.0, JScript1.0)
locationbar	(>JavaScript1.2)
menubar		(>JavaScript1.2)
personalbar	(>JavaScript1.2)
scrollbars	(>JavaScript1.2)
statusbar	(>JavaScript1.2)
tags		(>JavaScript1.2)
toolbar		(>JavaScript1.2)

Méthodes

alert(message)			(>JavaScript1.0, JScript1.0)
back()				(>JavaScript1.2)
blur()				(>JavaScript1.1)
captureEvents(typeEvénement)	(>JavaScript1.2)
clearInterval(intervalID)	(>JavaScript1.2)
clearTimeout(timeOutID)		(>JavaScript1.0, JScript1.0)
close()				(>JavaScript1.0, JScript1.0)
confirm(message)		(>JavaScript1.0, JScript1.0)
disableExternalCapture()	(>JavaScript1.2)
enableExternalCapture()		(>JavaScript1.2)
find(['chaine1'][,true|false][,true|false])	(>JavaScript1.2)
focus()				(>JavaScript1.1)
forward()			(>JavaScript1.2)
handleEvent(evénement)		(>JavaScript1.2)
home()				(>JavaScript1.2)
moveBy(horizontal,vertical)	(>JavaScript1.2)
moveTo(x,y)			(>JavaScript1.2)
open(URL, nomFenêtre, [toolbar[=yes|no]|[=1|0],
    location[=yes|no]|[=1|0], directories[=yes|no]|[=1|0], status[=yes|no]|[=1|0],
    menubar[=yes|no]|[=1|0], scrollbars[=yes|no]|[=1|0], resizable[=yes|no]|[=1|0],
    width=pixels, height=pixels])	(>JavaScript1.0, JScript1.0)
print()				(>JavaScript1.2)
prompt(message[, valeurParDefaut])	(>JavaScript1.0, JScript1.0)
releaseEvents(typeEvénement)	(>JavaScript1.2)
resizeBy(horizontal, vertical)	(>JavaScript1.2)
resizeTo(largeur, hauteur)	(>JavaScript1.2)
routeEvent(événement)		(>JavaScript1.2)
scroll(x,y)			(>JavaScript1.1)
scrollBy(horizontal, vertical)	(>JavaScript1.2)
scrollTo(x, y)			(>JavaScript1.2)
setInterval(fonction, msec[arg1,...,argn])	(>JavaScript1.2)
setTimeout('fonction', msec)	(>JavaScript1.0, JScript1.0)
stop()				(>JavaScript1.2)

Événements

onBlur				(>JavaScript1.1)
onDragDrop			(>JavaScript1.2)
onError				(>JavaScript1.1)
onFocus				(>JavaScript1.1)
onLoad				(>JavaScript1.0, JScript1.0)
onMove				(>JavaScript1.2)
onResize			(>JavaScript1.2)
onUnload			(>JavaScript1.0, JScript1.0)

Exemple

<FORM>
<INPUT TYPE="button" VALUE="Abonnement" NAME="bouton_abonnement"
	onClick="window.open('suscribe.htm', 'Abonnement',
	'scrollbars=yes,status=yes,width=500,height=300')">
</FORM>

defaultStatus

Cette propriété affiche un message dans la barre de statut (au bas de la fenêtre).
représente le message de défaut qui sera affiché dans la barre de statut

Syntaxe

JavaScript1.0 : réfFenêtre.defaultStatus

réfFenêtre est une façon de faire référence à une fenêtre, comme décrit dans l'objet "window".

Exemple

<SCRIPT LANGUAGE="JavaScript1.1">
window.defaultStatus = "Barre de status";
</SCRIPT>

frames

Cette propriété représente un tableau d'objets correspondant aux cadres (marqueur <FRAME>) présents dans un document. Voir l'objet "frame".
est un tableau représentant tous les cadres dans une fenêtre.

JavaScript1.0

Exemple

<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Le nombre de cadre de la fen&ecirc;tre parente est
parent.frames.length = "+parent.frames.length+"<BR>");
</SCRIPT>

innerHeight

Syntaxe

JavaScript1.2 :

innerWidth

Syntaxe

JavaScript1.2 :

length

Cette propriété est un entier qui spécifie la longueur d'un objet ou d'un tableau. Utiliser en lecture seulement.
représente le nombre de cadres dans la fenêtre parente.

La propriété "length" est utilisée pour spécifier:

Le nombre d'éléments d'un formulaire;
Le nombre de cadres dans un FRAMESET;
Le nombre d'entrées dans un objet "history";
Le nombre de boutons radio dans un objet "radio";
Le nombre d'options dans un objet "select";
La longueur d'un objet "string";
Le nombre de cadres dans une fenêtre parente;
Le nombre d'entrées dans l'une des propriétés d'un tableau.
Le nombre d'éléments dans un tableau.
Le nombre d'images dans un document.

Si la longueur est nulle, la valeur de "length" est zéro

Syntaxe

Lorsque utilisé avec un objet:
  1. nomFormulaire.length
  2. réfCadre.length
  3. history.length
  4. nomRadio.length
  5. nomSelect.length
  6. nomString.length
  7. RefFenêtre.length
  8. nomArray.length
  9. images.length
  10. navigator.plugins[index].length
  11. navigator.plugins[pluginName].length

Lorsque utilisé avec les propriétés d'un tableau :

  1. anchors.length
  2. elements.length
  3. forms.length
  4. réfCadre.frames.length
  5. RefFenêtre.frames.length
  6. links.length
  7. nomSelect.options.length

Objets

anchors, Array, elements, forms, frame, Image, history, links, Option, Plugin, radio, select, string, window

Exemple

<SCRIPT language="JavaScript1.1">
document.writeln("nombre d'entrées dans l'objet history :
"+history.length+"<BR>");
</SCRIPT>

name

Cette propriété représente une chaîne de caractères qui spécifie le nom d'un objet.
représente le nom de la fenêtre.

Syntaxe

  1. nomObjet.name
  2. réfCadre.name
  3. réfCadre.frames.name
  4. nomRadio[index].name
  5. nomSelect.options.name
  6. réfFenêtre.name
  7. réfFenêtre.frames.name
  8. nomFileUpload.name
  9. nomImage.name
  10. navigator.plugins[index].name
  11. navigator.plugins[nomPlugin].name

nomObjet est soit la valeur de l'attribut NAME d'un objet ci-dessous mentionné ou un élément dans le tableau d'éléments.
réfCadre est une façon valide de faire référence à un cadre, tel que décrit dans l'objet "frame".
nomRadio est la valeur de l'attribut NAME d'un objet "radio".
nomSelect est soit la valeur de l'attribut NAME d'un objet "select" ou un élément dans le tableau d'éléments.
réfFenêtre est une façon valide de faire référence à une fenêtre, tel que décrit dans l'objet "window".
nomFileUpload est soit la valeur de l'attribut NAME d'un objet "FileUpload" ou un élément dans le tableau d'éléments.
nomImage est soit la valeur de l'attribut NAME d'un objet "Image" ou un élément dans le tableau d'images.
index est un entier représentant un "plug-in" dans un document.
nomPlugin représente une chaîne de caractères contenant le nom d'un objet "Plugin".

Objet

Applet, button, checkbox, FileUpload, frame, hidden, Image, password, Plugin, radio, reset, select, submit, text, textarea, window

Exemple

<IMG SRC="badgirl.jpg" LOWSRC="ungi.gif"
NAME="ungi" width=120 height=80 BORDER=4>
<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.writeln("propriété NAME de la première image document.images[0].name
="+document.images[0].name);
</SCRIPT>

opener

Cette propriété spécifie la fenêtre du document appelé lorsque qu'une fenêtre est appelée en utilisant la méthode "open".
spécifie le nom d'une fenêtre du document appelé.

Syntaxe :

JavaScript1.1 : window.opener

Exemple

Source dans la première fenetre :
<SCRIPT LANGUAGE="JavaScript1.1">
this.name="principal"
window2=open("window2.htm","abonnement","scrollbars=no,width=250,height=400");
</SCRIPT>

Source dans la seconde fenetre 'window2.htm' :

Ceci est une fenêtre secondaire.<BR>
<SCRIPT LANGUAGE="JavaScript1.1">
document.writeln("Fenêtre ouverte par window.opener.name="+window.opener.name);
</SCRIPT>

outerHeight

Syntaxe

JavaScript1.2 :

outerWidth

Syntaxe

JavaScript1.2 :

pageXOffset

Syntaxe

JavaScript1.2 :

pageYOffset

Syntaxe

JavaScript1.2 :

parent

Cette propriété fait référence à la fenêtre <FRAMESET> d'un cadre (marqueur <FRAME>). Utilisée en lecture seulement.
est un synonyme pour le nom de la fenêtre.

Syntaxe

  1. parent.nomPropriété
  2. parent.nomMéthode
  3. parent.nomCadre
  4. parent.frames[index]

nomPropriété est soit la propriété defaultStatus, status, length, name ou parent lorsque l'appel fait référence à un objet "window".
nomPropriété est soit la propriété length, name ou parent lorsque l'appel fait référence à un objet "frame".
nomMéthode est n'importe quelle méthode associée à l'objet "window".
nomCadre et frames[index] sont des façons de faire référence à un cadre.

Objet

frame, window

Exemple :


<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Le nom de la fen&ecirc;tre parente est window.parent.name =
"+window.
parent.name+"<BR>");
</SCRIPT>

self

Cette propriété est un synonyme de la fenêtre ou du cadre courant.


est un synonyme pour le nom de la fenêtre et fait référence à la fenêtre courante.

Syntaxe:

  1. self.nomPropriété
  2. self.nomMéthode

nomPropriété est soit la propriété defaultStatus, status, length, name ou parent lorsque l'appel fait référence à un objet "window".
nomPropriété est soit la propriété length, name ou parent lorsque l'appel fait référence à un objet "frame".
nomMéthode est n'importe quelle méthode associée à l'objet "window".

Objet :

frame, window

Exemple :


<SCRIPT LANGUAGE="JavaScript1.1">
this.name="principal"
document.writeln("'self' est un synonyme de 'window' :<BR>");
document.writeln("Nom retourné par
window.name="+window.name+"<BR>");
document.writeln("Nom retourné par
self.name="+self.name+"<BR>");
</SCRIPT>

status

Cette propriété spécifie la priorité ou un message dans la barre de statut, tel que l'adresse URL qui apparaît lorsque l'usager passe la souris au-dessus d'un lien hypertexte.
spécifie la priorité du message dans la barre de statut

Syntaxe

JavaScript1.0 : réfFenêtre.status

réfFenêtre est une façon valide de faire référence à une fenêtre, tel que décrit dans l'objet "window".

Exemple


<SCRIPT LANGUAGE="JavaScript1.1">
function gozone() {
	this.status="Vous êtes sur l'image !";
	// la fonction doit retourner true car elle est appelée par onMouseOver
	return "true";
}
function outzone() {
	this.status="Vous êtes en dehors l'image !";
}
</SCRIPT>

<IMG SRC="ungi.gif" width=120 height=80 BORDER=0 USEMAP="#ungimap">
<MAP NAME="ungimap">
<AREA NAME="zone0" SHAPE="RECT" COORDS="0,0,118,78" TARGET="_top"
	HREF="http:\\www.galaxie.spc\soleil\terre\france.htm#normandie"
	onMouseOver="gozone()" onMouseOut="outzone()">
</MAP>

top

Cette propriété est un synonyme de la fenêtre principale du navigateur.
est un synonyme pour le nom de la fenêtre.

Syntaxe

JavaScript1.0 :

  1. top.nomPropriété
  2. top.nomMéthode
  3. top.nomCadre
  4. top.frames[index]

nomPropriété est soit la propriété defaultStatus, status ou length.
nomMéthode est n'importe quelle méthode associée à l'objet "window".
nomCadre et frames[index] sont des façons de faire référence à un cadre.

Exemple


<SCRIPT LANGUAGE="JavaScript1.1">
document.write("Le status de la fen&ecirc;tre principale est top.status = "+top
.status+"<BR>");
</SCRIPT>

window

Cette propriété est un synonyme de la fenêtre ou du cadre courant. Utilisée en lecture seulement.

Syntaxe:

  1. window.nomPropriété
  2. window.nomMéthode

nomPropriété est soit la propriété defaultStatus, status, length ou name lorsque l'appel fait référence à un objet "window".
nomPropriété est soit la propriété length ou name lorsque l'appel fait référence à un objet "frame".
nomMéthode est n'importe quelle méthode associée à l'objet "window".

Objet :

frame, window

Exemple :


<SCRIPT LANGUAGE="JavaScript1.1">
window.defaultStatus = "Barre de status";
</SCRIPT>


alert(message)

Affiche une boîte de dialogue avec un message d’avertissement et un bouton OK. Il faut utiliser cette méthode que pour avertir l’usager et que ce dernier n’a aucune décision à prendre.

Malgré que la méthode "alert" utilise l’objet "window", vous n’avez pas besoin de spécifier une fenêtre de référence lors de l’appel. Par exemple, windowReference.alert() n’est pas nécessaire.

Syntaxe

JavaScript1.0 : alert("unMessage")

unMessage est une chaîne de caractères ou une propriété d’un objet existant.

Exemple


<SCRIPT LANGUAGE="JavaScript1.1">
alert ('faire attention aux quotes dans l\'appel d\'alert');
</SCRIPT>

captureEvents(typeEvénement)

Syntaxe

JavaScript1.2

clearInterval(intervalID)

Syntaxe

JavaScript1.2

close()

Cette méthode ferme une fenêtre qui a été ouverte avec la méthode window.open(). Pour les autres fenêtres, un message de confirmation apparaîtra à l'écran. Si aucune fenêtre n’est spécifiée, le Javascript fermera la fenêtre courante.

Syntaxe

JavaScript1.0 : RéférenceFenêtre.close()

Exemple


<FORM>
<INPUT TYPE="button" VALUE="clickez ici" onClick="Window2.close();return true;">
</FORM>
<SCRIPT LANGUAGE="JavaScript1.1">
Window2 = open("","abonnement","scrollbars=no,width=150,height=200");
Window2.document.write("<HEAD><TITLE>fenêtre secondaire !</TITLE></HEAD>")
Window2.document.write("<CENTER><BIG><B>Je suis la 2e fenêtre !</B></BIG></CENTER>")
</SCRIPT>

confirm(message)

Affiche une boîte de dialogue avec un message de confirmation, un bouton OK et un bouton CANCEL. Il faut utiliser cette méthode lorsque l’usager doit prendre une décision. La méthode "confirm" retourne TRUE si l’usager appuie sur OK et retourne FALSE si l’usager appuie sur CANCEL.

Malgré que la méthode "confirm" utilise l’objet "window", vous n’avez pas besoin de spécifier une fenêtre de référence lors de l’appel. Par exemple, windowReference.confirm() n’est pas nécessaire.

Syntaxe

JavaScript1.0 : confirm("unMessage")

unMessage est une chaîne de caractères ou une propriété d’un objet existant.

Exemple


<FORM>
<INPUT TYPE="button" VALUE="clickez ici pour quitter." onClick="confirmation()">
</FORM>
<SCRIPT LANGUAGE="JavaScript1.1">
function confirmation() {
	resultat = confirm('voulez-vous quitter ?');
	if (resultat=="1")
		this.close();
}
</SCRIPT>

disableExternalCapture()

Syntaxe

JavaScript1.2

enableExternalCapture()

Syntaxe

JavaScript1.2

find(['chaine1'][,true|false][,true|false])

Syntaxe

JavaScript1.2

handleEvent(evénement)

Syntaxe

JavaScript1.2

home()

Syntaxe

JavaScript1.2

moveBy(horizontal,vertical)

Syntaxe

JavaScript1.2

moveTo(x,y)

Syntaxe

JavaScript1.2

open(URL, nomFenêtre, [toolbar[=yes|no]|[=1|0], location[=yes|no]|[=1|0], directories[=yes|no]|[=1|0], status[=yes|no]|[=1|0], menubar[=yes|no]|[=1|0], scrollbars[=yes|no]|[=1|0], resizable[=yes|no]|[=1|0], width=pixels, height=pixels])

Cette méthode ouvre une nouvelle fenêtre du navigateur.

Syntaxe

JavaScript1.0 : [variableFenêtre] [fenêtre].open(“URL”, “nomFenêtre”, [“caractéristiquesFenêtre”])

variableFenêtre est le nom de la nouvelle fenêtre. Il faut utiliser cette variable lorsque l’on fait référence aux propriétés, méthodes et contenus d’une fenêtre.
URL spécifie l’URL a ouvrir dans la nouvelle fenêtre. Voir l’objet "location" pour avoir plus de détails sur la description des composantes d’un URL.
nomFenêtre est le nom de la fenêtre à donner à l’attribut TARGET de la commande <FORM> ou <A>.
caractéristiquesFenêtre est la liste des éléments optionnels suivants:

Vous pouvez utiliser toutes ces options. Il faut les séparer d’une virgule et vous ne devez pas mettre d’espace entre les options.

Exemple


<FORM>
<INPUT TYPE="button" VALUE="clickez ici" onClick="Window2.close(); return true;">
</FORM>
<SCRIPT LANGUAGE="JavaScript1.1">
Window2=open("","abonnement","scrollbars=no,width=150,height=200");
Window2.document.write("<HEAD><TITLE>fenêtre secondaire !</TITLE></HEAD>")
Window2.document.write("<CENTER><BIG><B>Je suis la 2e fenêtre
!</B></BIG></CENTER>")
</SCRIPT>

print()

Syntaxe

JavaScript1.2

prompt(message[, valeurParDefaut])

Affiche une boîte de dialogue avec un message et un champ d’entrée.

Malgré que la méthode "prompt" utilise l’objet "window", vous n’avez pas besoin de spécifier une fenêtre de référence lors de l’appel. Par exemple, windowReference.prompt() n’est pas nécessaire.

Syntaxe

JavaScript1.0 : prompt(message, [valeurParDéfaut])

message est une chaîne de caractères ou une propriété d’un objet existant. La chaîne de caractères représente le message.
valeurParDéfaut est une chaîne de caractères, un entier ou une propriété d’un objet existant qui représente la valeur de défaut du champ d’entrée. Si vous ne donnez pas de valeur initiale pour valeurParDéfaut, la boîte de dialogue affichera la valeur: <undefined>.

Exemple


<FORM>
<INPUT TYPE="button" VALUE="ouvrir" onClick="lancequestion()">
</FORM>
<SCRIPT LANGUAGE="JavaScript1.1">
function lancequestion() {
	reponse = prompt('voulez vous ouvrir une fenêtre secondaire ?\n entrez
		le texte à afficher dans cette fenêtre :','votre texte');
	if (reponse) {
		Window2=open("","seconde","scrollbars=no,width=150,height=200");
		Window2.document.write("<HEAD><TITLE>fenêtre secondaire !</TITLE></HEAD>")
		Window2.document.write("<CENTER><BIG><B>"+reponse+"</B></BIG></CENTER>")
	}
}
</SCRIPT>

releaseEvents(typeEvénement)

Syntaxe

JavaScript1.2

resizeBy(horizontal, vertical)

Syntaxe

JavaScript1.2

resizeTo(largeur, hauteur)

Syntaxe

JavaScript1.2

routeEvent(événement)

Syntaxe

JavaScript1.2

scroll(x,y)

Cette méthode déroule une fenêtre aux coordonnées spécifiées. Les coordonnées d'une fenêtre au coin haut à gauche sont (0,0).

Syntaxe

JavaScript1.1 : réfFenêtre.scroll(x-coordonnée,y-coordonnée)

réfFenêtre est une façon valide de faire référence à une fenêtre, tel que décrit dans l'objet "window".
x-coordonnée est un entier représentant la coordonnée x en pixel (largeur).
y-coordonnée est un entier représentant la coordonnée y en pixel (hauteur).

Exemple


<CENTER>
Choisissez la direction :<BR>
<FORM NAME="formulaire">
<INPUT TYPE="button" VALUE="haut" onClick="haut()"><BR>
<INPUT TYPE="button" VALUE="gauche" onClick="gauche()">
<INPUT TYPE="button" VALUE="droite" onClick="droite()"><BR>
<INPUT TYPE="button" VALUE="bas" onClick="bas()"><BR>
<BR>
</FORM>
</CENTER>
<SCRIPT LANGUAGE="JavaScript1.1">
Window2 = open("badgirl.jpg","","scrollbars=yes,width=200,height=200");
maxx = Window2.document.images[0].width;
maxy = Window2.document.images[0].height;
x = maxx/2;
y = maxy/2;

Window2.scroll(x,y);

function haut() {
	y -= 10;
	if (y<0) y=0;
	Window2.scroll(x,y);
}
function gauche() {
	x-=10;
	if (x<0) x=0;
	Window2.scroll(x,y);
}
function droite() {
	x+=10;
	if (x>maxx) x=maxx;
	Window2.scroll(x,y);
}
function bas() {
	y+=10;
	if (y>maxy) y=maxy;
	Window2.scroll(x,y);
}
</SCRIPT>

scrollBy(horizontal, vertical)

Syntaxe

JavaScript1.2

scrollTo(x, y)

Syntaxe

JavaScript1.2

setInterval(fonction, msec[arg1,...,argn])

Syntaxe

JavaScript1.2

stop()

Syntaxe

JavaScript1.2


Christophe Merlet
redfox@redfoxcenter.org
©Tous droits réservés
21 novembre 1998