SELFHTML: JavaScript / Référence objet JavaScript / frames

SELFHTML/Quickbar JavaScript Référence objet

frames

frames: généralités sur l'utilisation

Propriété:

length (nombre de frames)

Sous-objets:

document
event
history
location

frames: généralités sur l'utilisation

Avec l'objet frames vous avez accès aux frames, à savoir à un jeu de frames et à ses fenêtres frames définis dans un fichier HTML.

Étant donné que chaque fenêtre frame représente une fenêtre distincte pour le navigateur, l'objet frames est en fin de compte une variante de l'objet window, l'objet fenêtre plus général. Toutes les propriétés et méthodes qui font partie de l'objet window, peuvent être aussi utilisées sur l'objet frames, donc sur des fenêtres frames distinctes. L'objet frames ne représente un objet distinct que parce qu'il comprend une propriété supplémentaire et qu'un certain nombre de particularités pour l'adressage de fenêtres frames en JavaScript sont à observer:

Schéma 1 / exemple 1:

parent.frames[#].propriete/methode();

parent.frames[1].location.href = "sport.html";

Schéma 2 / exemple 2:

parent.nomdeframe.propriete/methode();

parent.fenetredroite.close();

Explication:

parent est un nom de fenêtre réservé que vous pouvez utiliser pour adresser les fenêtres d'un jeu de frames. À la place de parent vous pouvez également utiliser top. Avec parent vous adressez la fenêtre mère de la fenêtre frame actuelle, avec top dans chaque cas la fenêtre d'affichage du navigateur la plus élevée dans la hiérarchie.

Vous pouvez adresser les fenêtres frames de deux façons:

avec un numéro d'index (comme dans le schéma 1 / exemple 1)
Si vous utilisez des numéros d'index, mentionnez frames suivi entre crochets du numéro d'ordre de la fenêtre frame désirée dans le jeu de frames. Veillez que le comptage commence par 0, c'est à dire vous adressez la première fenêtre frame avec frames[0], la deuxième fenêtre frame avec frames[1] etc. Pour le comptage prévaut l'ordre dans lequel les commandes <frame> sont définies dans le jeu de frames.
avec le nom de la fenêtre frame (comme dans le schéma 2 / exemple 2)
Pour cela, mentionnez le nom défini dans la définition HTML de la fenêtre frame <frame...> avec l'attribut name=.

Étant donné que l'objet frames est à vrai dire une variante de l'objet window, vous pouvez non seulement utiliser toutes les propriétés et méthodes de l'objet window sur l'objet frames, mais aussi toutes les autres qui dans la hiérarchie sont sous l'objet window. De la même façon que vous pouvez par exemple modifier grâce à window.document.forms[0].elements[0].value = "Serge" le contenu d'un champ de saisie d'un formulaire dans un fichier HTML normal, vous pouvez obtenir la même chose dans un jeu de frames avec parent.frames[1].document.forms[0].elements[0].value = "Serge".

Un exemple d'application typique pour l'utilisation de l'objet frame se trouve dans cette documentation: changer simultanément deux frames.

length

sauvegarde combien de fenêtres frames sont contenues dans une fenêtre mère.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
for(i=0; i < parent.frames.length; ++i)
 alert(parent.frames[i].name);
</script>
</head><body>
</body></html>

Explication:

Avec parent.frames.length ou top.frames.length, vous pouvez rechercher le nombre de fenêtres frames. Dans l'exemple il est supposé que le fichier HTML est appelé dans un jeu de frames. À la lecture du fichier, celui-ci donne à la suite avec la méthode alert() les noms de toutes les fenêtres frames du jeu de frames. Pour cela a été définie la boucle for. La propriété parent.frames.length sert de condition pour interrompre la boucle. Étant donné que le compteur de boucles i est incrémenté de 1 à chaque tour de boucle, c'est à chaque fois c'est la fenêtre frame suivante qui grâce à parent.frames[i] est adressée.


après:	document
avant:	window

SELFHTML/Quickbar JavaScript Référence objet