SELFHTML/Quickbar  JavaScript  Référence objet


frames

Cette page est un document avec du texte et des informations

  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:

É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.

 

JavaScript 1.0Netscape2.0MS IE3.0Lecture 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

© 1998 Stefan Münz / © 2001 Traduction  Serge François, 13405@free.fr