frameset

NN 6 IE 4 DOM 1

L'objet frameset représente l'élément frameset. Faites bien attention de faire la différence entre l´objet élément frameset (décrit ici) et l´objet window rendu possible par un jeu de cadres. Les propriétés et méthodes d´un objet élément frameset ont tendance à refléter les aspects associés à l´élément HTML et ses attributs. Le contenu de l´élément frameset est window (un affichage en terminologie DOM W3C), qui est définissable par script depuis le début et contient un document (bien que sans éléments affichables en-dehors des éléments frame imbriqués). Référencez un objet élément frameset par son ID. Par exemple, à partir d´un script résidant dans le document d´un cadre, accédez à l´objet élément frameset avec:

parent.document.getElementById("myFrameset")

Mais pour accéder à la fenêtre du jeu de cadres (et ainsi accéder à ses scripts et au document), la référence à partir du même script serait l´une des références suivantes:

parent
top

Si un script traite une référence à un objet élément frameset, vous pouvez passer de l´objet élément à son contenu à l´aide de la propriété ownerDocument de l´élément (décrites parmi les propriétés partagées précédemment dans ce chapitre).

Sachez que les références aux objets frameset décrits dans cette section peuvent ne pas fonctionner correctement dans Internet Explorer 4 pour Windows 95. De plus, l'espace réservé windowRef peut être occupé par parent ou top si la référence figure dans un script contenu dans un cadre enfant.

Equivalent HTML

<frameset>

Référence de modèle d'objet

[windowRef.]document.getElementById("framesetID")

Propriétés spécifiques à l´objet

border

borderColor

cols

frameBorder

frameSpacing

rows

Méthodes spécifiques à l´objet

Aucune.

Propriétés de gestionnaire d´événements spécifiques à l´objet

Gestionnaire	IE pour Windows	IE pour Mac	NN	DOM W3C
onafterprint	5	s.o	s.o	s.o
onbeforeprint	5	s.o	s.o	s.o
onbeforeunload	4	s.o	s.o	s.o
onload	3	3.01	2	2
onresize	4	4	4	s.o
onunload	3	3.01	2	2

border	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Taille de l'espacement entre les cadres d'un jeu de cadres, exprimée en pixels. Seul l'élément frameset parent d'un système de jeux de cadres imbriqués répond au paramètre de propriété border. Internet Explorer traite l'espacement par défaut différemment en fonction du système d'exploitation. N'oubliez donc pas qu'une même valeur peut s'afficher différemment selon que vous êtes dans un environnement Windows ou Macintosh.

Exemple

top.document.getElementById("myFrameset").border = 4;

Valeur
Un nombre entier. La valeur zéro supprime totalement la bordure. Bien que la valeur soit censée représenter l'épaisseur précise, en pixels, des bordures du jeu de cadres, certains systèmes d'exploitation ou navigateurs ne la reconnaissent pas.

Par défaut
6 (IE Windows); 1 (IE Mac).

borderColor	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Couleur des bordures entre les cadres d'un jeu de cadres. La propriété borderColor d'un cadre individuel prend le pas sur le paramétrage de l'objet frameset

Exemple

parent.document.getElementById("myFrameset").borderColor = "salmon";

Valeur
Triplet de couleurs en hexadécimal, ou l'un des noms de couleurs en anglais. Si la valeur de cet attribut n'est pas indiquée, elle sera interprétée comme "#000000" (noir). Reportez-vous à l'annexe A pour connaître les noms de couleurs admises/autorisées.

Par défaut
Varie selon le système d'exploitation.

cols	NN 6 IE 4 DOM 1
	Lecture/écriture
Définit les tailles et proportions de l'organisation des colonnes de cadres d´un jeu de cadres. La taille des colonnes peut être définie par l'un des paramètres suivants:

Soyez très prudent si vous créez un script destiné à modifier cette propriété. La modification à la volée de la composition d'un jeu de cadres peut interrompre la communication des scripts entre cadres. La réduction du nombre de colonnes peut détruire des documents dont les scripts ou objets prennent en charge des scripts se trouvant dans d'autres cadres ou dans le parent. Il est plus prudent de ne pas changer le nombre de colonnes; vous pouvez en revanche utiliser cette propriété pour ajuster les largeurs des colonnes de cadre existantes. Les anciennes versions de Netscape 6 risquent de ne pas afficher les modifications correctement. De plus, si vos scripts reposent sur le gestionnaire d´événements onresize du jeu de cadres, essayez de vérifier que l´événement se déclenche en réponse aux modifications par script de ces propriétés sur autant de plates-formes que possible.

Exemple

parent.document.getElementById("framesetter").cols = "40%,60%";

Valeur
Liste, sous forme de chaîne, de valeurs séparées par des virgules, exprimées en pixels, en pourcentage ou par caractère générique (*). Internet Explorer 4 pour Macintosh ne fonctionne pas correctement avec certaines combinaisons comprenant un caractère générique.

Par défaut
100%

frameBorder	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Indique si des bordures s'affichent entre les cadres d'un jeu de cadres. Dans Internet Explorer pour Windows, cette propriété ne modifie pas de façon dynamique la visibilité de la bordure.

Exemple

parent.document.getElementById("framesetter").frameBorder = "no";

Valeur
Internet Explorer 4 accepte les valeurs sous forme de chaîne suivantes: 1 (activé) et 0 (désactivé) ainsi que yes et no.

Par défaut
yes

frameSpacing	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Espacement, en pixels, existant entre les cadres à l'intérieur d'un jeu de cadres. Dans Internet Explorer pour Windows, cette propriété ne modifie pas de façon dynamique l´espacement du cadre.

Exemple

parent.document.getElementById("framesetter").frameSpacing = 5;

Valeur
Nombre entier.

Par défaut
2