frameNN 6 IE 4 DOM 1

L´objet frame représente l´élément frame, qui peut être généré uniquement dans un élément frameset. Faites bien attention de ne pas confondre l´objet élément frame (décrit ici) et l´objet window rendu possible par un cadre. Les propriétés et méthodes d´un objet élément frame ont tendance à refléter les aspects associés à l´élément HTML et ses attributs. Le contenu du cadre est une fenêtre (un affichage en terminologie DOM W3C), qui est définissable par script depuis le début et contient un document. Référencez un objet élément frame avec son ID, même si vous affectez le même identificateur aux attributs id et name d´un élément cadre. Par exemple, à partir d´un script résidant dans le document d´un cadre, accédez à l´objet élément frame avec:

parent.document.getElementById("TOCFrame")
 

Mais pour accéder au même cadre en tant que fenêtre (et de ce fait accéder à ses scripts et au document), la référence issue du même script serait l´une des références suivantes:

parent.TOCFrame
parent.frames["TOCFrame"]
 

Si un script traite une référence à un objet élément frame, vous pouvez passer de l´objet élément à son contenu à l´aide des propriétés contentDocument ou contentWindow décrites ci-dessous.

 

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

 
Equivalent HTML
 
<frame>
 
Référence de modèle d'objet
 
[windowRef.]document.getElementById("frameID")
 
Propriétés spécifiques à l´objet
 
allowTransparencyborderColorcontentDocumentcontentWindow
dataFlddataSrcframeBorderheight
longDescmarginHeightmarginWidthname
noResizescrollingsrcwidth
 
Méthodes spécifiques à l´objet

Aucune.

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

Aucune.

allowTransparencyNN s.o. IE 6 DOM s.o.

Lecture/écriture

Précise si l´arrière-plan du cadre peut être transparent. Comme un jeu de cadres n´a pas de couleur ou d´image d´arrière-plan, cette propriété est inutile pour un cadre. Mais elle s´applique à l´élément objet iframe associé.

 
Valeur

Valeur booléenne: true | false.

 
Par défaut

false

borderColorNN s.o. IE 4 DOM s.o.

Lecture/écriture

Couleur de la bordure du cadre. Les différents navigateurs et systèmes d'exploitation résolvent parfois différemment les conflits entre plusieurs couleurs de bordure; il est donc conseillé de tester les modifications apportées par vos scripts aux couleurs des bordures de cadre individuelles.

 
Exemple
 
parent.document.getElementById("myFrame").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.

contentDocumentNN 6 IE s.o DOM 2

Lecture seule

Renvoie une référence à l'objet document chargé dans l´objet élément frame. Gr ce à cet objet document, vous pouvez accéder à l´un des éléments du document avec la méthode getElementById() ou accéder à l´objet window conteneur avec la propriété defaultView du document. Pour IE pour Windows, utilisez la propriété contentWindow pour passer de l´objet élément frame à son contenu.

 
Exemple
 
var frameElem = parent.document.getElementById("myFrame");
var doc = frameElem.contentDocument;
 
Valeur

Référence à un noeud document.

 
Par défaut

Noeud document courant.

contentWindowNN 7 IE 5.5(Win) DOM s.o.

Lecture seule

Renvoie une référence à l'objet window généré par l´élément cadre. Gr ce à cet objet window, vous pouvez accéder à l´objet document et ainsi à n´importe quel élément du document. Pour Netscape 6, utilisez la propriété contentDocument pour passer de l´objet élément frame à son contenu. Mais si vous essayez d´accéder à des variables ou des fonctions de script dans le cadre, contentWindow (ou contentDocument.defaultView compatible avec le DOM W3C et Netscape 6) permet d´accéder au contexte du script.

 
Exemple
 
var frameElem = parent.document.getElementById("myFrame");
var win = frameElem.contentWindow;
 
Valeur

Référence à un noeud window.

 
Par défaut

Noeud window courant.

dataFldNN s.o. IE 4 DOM s.o.

Lecture/écriture

Utilisé avec la fonction de liaison de données de Microsoft Internet Explorer pour associer un nom de colonne provenant d'une source de données distante à l'attribut src du cadre. Vous devez également définir un attribut datasrc pour l'élément. Le paramétrage des deux propriétés dataFld et dataSrc sur des chaînes vides rompt la liaison entre l'élément et la source de données. Fonctionne uniquement avec les sources de données de fichiers sources dans IE 5/Mac.

 
Exemple
 
parent.document.getElementById("myFrame").dataFld = "srcURL";
 
Valeur

Identifiant de la colonne de la source de données, sensible à la casse.

 
Par défaut

Aucune.

dataSrcNN s.o. IE 4 DOM s.o.

Lecture/écriture

Utilisé avec la fonction de liaison de données de Microsoft Internet Explorer pour spécifier l´ID de l´élément object de la page qui charge l´objet de source de données pour l´accès distant aux données. Le paramétrage des deux propriétés dataFld et dataSrc sur des chaînes vides rompt la liaison entre l'élément et la source de données. Fonctionne uniquement avec les sources de données de fichiers sources dans IE 5/Mac.

 
Exemple
 
parent.document.getElementById("myFrame").dataSrc = "DBSRC3";
 
Valeur

Identifiant de la source de données, sensible à la casse.

 
Par défaut

Aucune.

frameBorderNN 6 IE 4 DOM 1

Lecture/écriture

Contrôle l'affichage ou non d'une bordure pour un cadre individuel au sein d'un jeu de cadres. Le contrôle des bordures de cadres individuels est délicat pour la plupart des navigateurs dans la majorité des systèmes d'exploitations. La désactivation des bordures d'un cadre peut ne pas produire d'effet si les bordures sont activées pour tous les cadres adjacents. Activez certaines bordures et désactivez-en d'autres à titre d'essai, mais n'oubliez pas de tester l'effet final dans tous les navigateurs et sur tous les systèmes d'exploitation utilisés. L'attribut frameborder ou la propriété frameBorder du frameset complet sont plus fiables.

 
Exemple
 
parent.document.getElementById("frame2").frameBorder = "no";
 
Valeur

Les valeurs sous forme de chaîne 1 (activé) et 0 (désactivé) ainsi que yes et no.

 
Par défaut

yes

height, widthNN s.o. IE 4 DOM s.o.

Lecture seule

Renvoie la hauteur et la largeur du cadre en pixels. Les dimensions comprennent l´habillage du cadre (barres de défilement). Ajustez la taille du cadre avec les propriété rows ou cols de l´objet du jeu de cadres.

 
Exemple
 
var frHeight = parent.document.getElementById("myFrame").height;
 
Valeur

Nombre entier.

 
Par défaut

Hauteur et largeur courantes.

longDescNN 6 IE 5(Mac)/6(Win) DOM 1

Lecture/écriture

Représente l´attribut longDesc de l'élément frame. Les navigateurs version 6 ne fournissent aucune fonctionnalité significative pour cet attribut ou propriété.

 
Valeur

Chaîne URL.

 
Par défaut

Une chaîne vide.

marginHeight, marginWidthNN 6 IE 4 DOM 1

Lecture/écriture

Indique le nombre de pixels qui séparent le bord intérieur d'un cadre et le contenu de ce cadre. La propriété marginHeight contrôle l'espace le long des bords supérieur et inférieur (en cas de défilement) d'un cadre; l'attribut marginWidth contrôle l'espace le long des bords gauche et droit d'un cadre.

 

Sans aucune invite, les navigateurs insèrent automatiquement une petite marge à l´intérieur d´un cadre (généralement entre 8 et 14 pixels selon le navigateur et le système d´exploitation). Mais si vous tentez d'intervenir sur ce comportement par défaut, n'oubliez pas que le paramétrage d'un seul de ces deux attributs provoque le passage à la valeur zéro de l'autre attribut. C'est pourquoi des valeurs doivent être affectées pour ces deux attributs à la fois, sauf si vous désirez que le contenu soit aligné absolument sur les bords de divers cadres.

 
Exemple
 
parent.document.getElementById("myFrame").marginHeight = 14;
parent.document.getElementById("myFrame").marginWidth = 5;
 
Valeur

Nombre entier positif ou zéro.

 
Par défaut

Varie selon le navigateur et le système d'exploitation.

nameNN 6 IE 4 DOM 1

Lecture/écriture

Identifiant associé à un cadre, utilisé comme valeur affectée aux attributs target ou comme instructions de script faisant référence au cadre. La valeur est généralement affectée à l'attribut name, mais un script peut la modifier, si nécessaire.

 
Exemple
 
parent.document.getElementById("myFrame").name = "results";
 
Valeur

Identifiant sensible à la casse, conforme aux règles de dénomination des identifiants: il ne peut pas contenir d'espace blanc ni de signe de ponctuation, à l'exception du caractère de soulignement, et ne peut pas commencer par un chiffre.

 
Par défaut

Aucune.

noResizeNN 6 IE 4 DOM 1

Lecture/écriture

Indique si l'utilisateur peut redimensionner le cadre. Toutes les bordures de l'élément frame affecté sont à présent verrouillées. Cela signifie que toutes les bordures qui s'étendent à d'autres cadres du jeu de cadres sont également verrouillées.

 
Exemple
 
parent.document.getElementById("myFrame").noResize = "true";
 
Valeur

Valeur booléenne: true | false.

 
Par défaut

false

scrollingNN 6 IE 4 DOM 1

Lecture/écriture

Contrôle le traitement des barres de défilement d'un cadre dont le contenu dépasse la capacité d'affichage. Vous pouvez forcer l'affichage ou le masquage permanent de barres de défilement dans un cadre. Vous pouvez également laisser le navigateur déterminer si une barre de défilement est nécessaire. Dans de nombreux navigateurs prenant cette propriété en charge, la modification de sa valeur n´a aucun effet.

 
Exemple
 
parent.document.getElementById("mainFrame").scrolling = "yes";
 
Valeur

Les valeurs sous forme de chaîne 1 (activé) et 0 (désactivé) ainsi que yes et no.

 
Par défaut

auto

srcNN 6 IE 4 DOM 1

Lecture/écriture

Fournit l´adresse URL du fichier de contenu externe chargé dans le cadre. Pour modifier le contenu, affectez une nouvelle adresse URL à la propriété. Pour les applications multi-plates-formes, vous pouvez également paramétrer la propriété location.href du cadre pour charger un autre document dans le cadre à l'aide de références relatives à la fenêtre (parent.frameName.location.href = "newDoc.html").

 
Exemple
 
parent.document.getElementById("myFrame").src = "images/altNavBar.jpg";
 
Valeur

Adresse URL complète ou relative, sous forme de chaîne.

 
Par défaut

Aucune.

width

Voir height.