Objet Window.Frame


Cet objet permet d’afficher dans un même écran plusieurs documents qui ont chacun un URL différent. Chaque cadre (frame) est un objet "window".

Il est possible de faire référence à un cadre en utilisant la déclaration parent.nomCadre ou parent.frames[index]. Par exemple, si votre troisième cadre possède l’attribut NAME=”unCadre”, il est possible de faire référence à ce cadre en utilisant la déclaration parent.unCadre ou parent.frames[2].

Pour faire référence au cadre courant, il faut utiliser les propriétés "self" ou "window". Il est également possible d’utiliser les propriétés "top" et "parent" a place des noms des cadres.

Le tableau des cadres (frames array) :

Il est possible de faire référence à l’objet "frame" dans votre code en utilisant le tableau des cadres. Ce tableau contient une entrée pour chaque cadre enfant (le marqueur: <FRAME>) dans une fenêtre qui contient le marqueur <FRAMESET> dans l’ordre du code source. Par exemple, si une fenêtre possède trois cadres enfants, ces cadres sont représentés de la façon suivante:
parent.frames[0]
parent.frames[1]
parent.frames[2]

Les éléments dans un tableau des cadres peuvent être utilisés en lecture seulement. Par exemple, la déclaration
windowReference.frames[0]="frame1" n’a pas d’effet.

Syntaxe :

Pour définir l’objet "frame", il faut utiliser la syntaxe HTML habituelle:

<FRAMESET>
…<FRAME SRC="URL" NAME="nomFrame">
</FRAMESET>

Pour utiliser les propriétés de l’objet "frame":

  1. [réfWindow.] nomFrame.nomPropriété
  2. [réfWindow.]frames[index].nomPropriété
  3. window.nomPropriété
  4. self.nomPropriété
  5. parent.nomPropriété

réfWindow est une variable de type windowVar d’une fenêtre de définition (voir l’objet "window", ou une des propriétés "top" ou "parent".
nomFrame est la valeur de l’attribut NAME de la commande <FRAME>.
index est un entier représentant un objet "frame".

Pour utiliser le tableau de cadres (frames array):

  1. [réfCadre.]frames[index]
  2. [réfCadre.]frames.length
  3. [réfWindow.]frames[index]
  4. [réfWindow.]frames.length

réfCadre est la façon valide de faire référence à un cadre.
réfWindow est une variable de type windowVar d’une fenêtre de définition (voir l’objet "window") ou d'une des propriétés "top" ou "parent".
index est un entier représentant un cadre dans une fenêtre parente.
Pour obtenir le nombre de cadres enfants d’une fenêtre ou d’un cadre, il faut utiliser la propriété length.

Propriétés :

L’objet "frame" possède les propriétés suivantes :

Le tableau de cadres (frames array) possède la propriété suivante :

Méthodes :

Événements :

Note: les événements onLoad et onUnload sont spécifiés dans la commande <FRAMESET> mais sont des événements de l’objet "window".

Exemple :

<SCRIPT LANGUAGE="JavaScript">
document.write("Nombre de frames actives : " + window.frames.length)
</SCRIPT>