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