frame | NN 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
allowTransparency | borderColor | contentDocument | contentWindow
dataFld | dataSrc | frameBorder | height
longDesc | marginHeight | marginWidth | name
noResize | scrolling | src | width
Méthodes spécifiques à l´objet
Aucune.
Propriétés de gestionnaire d´événements spécifiques à l´objet
Aucune.

allowTransparency | NN 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

borderColor | NN 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.

contentDocument | NN 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.

contentWindow | NN 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.

dataFld | NN 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.

dataSrc | NN 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.

frameBorder | NN 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, width | NN 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.

longDesc | NN 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, marginWidth | NN 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.

name | NN 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.

noResize | NN 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

scrolling | NN 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

src | NN 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.