iframe | NN 6 IE 4 DOM 1 | ||||||||||||||||||||||||
L'objet iframe représente l'élément iframe. Sachez que, dans Internet Explorer, certaines propriétés définies pour cet objet ne produisent aucun effet et sont dépourvues de valeur par défaut. Elles sont cependant implémentées car l´élément partage sa structure interne avec d´autres éléments qui utilisent ces propriétés. |
|||||||||||||||||||||||||
Equivalent HTML | |||||||||||||||||||||||||
<iframe> |
|||||||||||||||||||||||||
Référence de modèle d'objet | |||||||||||||||||||||||||
[window.]document.getElementById("elementID")
|
|||||||||||||||||||||||||
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. |
align | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Définit l'alignement de l'élément par rapport au contenu du texte environnant. La plupart des valeurs définissent la relation verticale existant entre l'élément et le texte environnant. Par exemple, pour aligner le bas de l'élément sur la ligne de base du texte environnant, la valeur de la propriété align doit être baseline. Un élément peut “ flotter ” le long de la marge de gauche ou de droite pour permettre au texte environnant de l'entourer. |
|
Exemple | |
document.getElementById("myIframe").align = "absmiddle"; |
|
Valeur | |
L'une des constantes d´alignement suivantes (sous forme de chaîne): absbottom | absmiddle | baseline | bottom | right | left | none | texttop | top. |
|
Par défaut | |
bottom |
allowTransparency | NN s.o. IE 6 DOM s.o. |
Lecture/écriture | |
Spécifie si l´arrière-plan iframe peut être transparent. Pour que l´arrière-plan du document principal soit visible à travers iframe et son document, l´attribut de style background-color du document doit être défini sur transparent. |
|
Exemple | |
document.getElementById("myIframe").allowTransparency = true; |
|
Valeur | |
Valeur booléenne: true | false. |
|
Par défaut | |
false |
border | NN s.o. IE 4 (Win) DOM s.o. |
Lecture/écriture | |
Bien qu´elle soit définie pour l´objet élément iframe dans IE pour Windows, la propriété border n´a pas de valeur et l´affectation d´une valeur ne modifie pas l´apparence de l´élément. |
borderColor | NN s.o. IE 4 DOM s.o. |
Lecture/écriture | |
Bien qu´elle soit définie pour l´objet élément iframe dans IE, la propriété borderColor n´a pas de valeur. L´affectation d´une valeur de couleur fait apparaître une fine bordure autour du rectangle iframe sur Macintosh, mais n´a aucun effet sur Windows. |
contentDocument | NN 6 IE s.o DOM 2 |
Lecture seule | |
Renvoie une référence à l'objet document chargé dans l´objet élément iframe. Gr ce à cet objet document, vous pouvez accéder à l´un des éléments du document avec la méthode getElementByIdOPENBRACKET 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 iframe à son contenu. |
|
Exemple | |
var iframeElem = parent.document.getElementById("myIframe"); var doc = iframeElem.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 iframe. 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 iframe à son contenu. 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 iframeElem = parent.document.getElementById("myIframe"); var win = iframeElem.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 à la valeur de propriété src. 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 | |
document.getElementById("myIframe").dataFld = "frameURL"; |
|
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 | |
document.getElementById("myIframe").dataSrc = "DBSRC3"; |
|
Valeur | |
Identifiant de la source de données, sensible à la casse. |
|
Par défaut | |
Aucune. |
frameBorder | NN s.o. IE 4 DOM s.o. |
Lecture/écriture | |
Cette propriété permet de contrôler l'affichage d'une bordure de cadre. Dans la pratique, elle n'a aucune d'incidence sur l'aspect visuel d'un cadre interne. |
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. Cette propriété n'a aucune incidence sur les cadres internes de Microsoft Internet Explorer. |
height, width | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Fournissent la mesure en pixels ou en pourcentage pour la hauteur et la largeur de l´élément iframe. |
|
Exemple | |
document.getElementById("myIframe").height = "200"; document.getElementById("myIframe").width = "500"; |
|
Valeur | |
Chaîne de longueur. |
|
Par défaut | |
300 (largeur); 150 (hauteur). |
hspace, vspace | NN s.o. IE 4 DOM s.o. |
Lecture/écriture | |
Mesure en pixels des marges horizontales et verticales entourant un cadre interne. La propriété hspace affecte de façon identique les côtés gauche et droit de l'élément; la propriété vspace affecte de façon identique les côtés haut et bas de l'élément. Ces marges diffèrent de celles définies dans les feuilles de style, mais leur aspect visuel est identique. |
|
Exemple | |
document.getElementById("myIframe").hspace = 5; document.getElementById("myIframe").vspace = 8; |
|
Valeur | |
Nombre entier de pixels. |
|
Par défaut | |
0 |
longDesc | NN 6 IE 5(Mac)/6(Win) DOM 1 |
Lecture/écriture | |
Représente l´attribut longDesc de l'élément iframe. 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 | |
Déterminent le nombre de pixels qui séparent le bord intérieur d'un cadre et le contenu de ce cadre. Une modification de l´une de ces propriétés réinitialise l´autre propriété à zéro, éliminant la marge par défaut fournie par le navigateur. Peu fiable dans IE 4 pour Windows, mais utilisable dans toutes les autres versions prises en charge. |
|
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 iframe, 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. |
|
Valeur | |
Identifiant sensible à la casse, sous forme de chaîne, 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 s.o. IE 4 DOM s.o. |
Lecture/écriture | |
Indique si l'utilisateur peut redimensionner le cadre. Non applicable à un élément iframe. |
scrolling | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Contrôle le traitement des barres de défilement d'un iframe dont le contenu dépasse sa capacité d'affichage. Vous pouvez forcer l'affichage ou le masquage permanent de barres de défilement dans un iframe. Vous pouvez également laisser le navigateur déterminer si une barre de défilement est nécessaire. Il n´est pas rare que les navigateurs ignorent les modifications apportées à cette propriété par script. Faites votre choix dans l'attribut scrolling de l'élément. |
|
Exemple | |
document.getElementById("myIframe").scrolling = "no"; |
|
Valeur | |
Une des trois constantes suivantes sous forme de chaîne: auto | no | yes. |
|
Par défaut | |
auto |
src | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Indique l´adresse URL du fichier de contenu externe chargé dans l'élément courant. Pour modifier le contenu, affectez une nouvelle adresse URL à la propriété. |
|
Exemple | |
document.getElementById("myIframe").src = "section2.html"; |
|
Valeur | |
Adresse URL complète ou relative, sous forme de chaîne. |
|
Par défaut | |
Aucune. |
vspace | |
Voir hspace. |
width | |
Voir height. |
tabIndex | NN 6 IE 4 DOM 1 |
Lecture/écriture | |
Nombre indiquant la position de cet élément dans l'ordre de tabulation des éléments pouvant être activés dans le document. L'ordre de tabulation suit un ensemble de règles très strictes. Les éléments dont les valeurs affectées aux propriétés tabIndex diffèrent de zéro sont les premiers activés lorsqu'un utilisateur commence à tabuler dans une page. Le premier élément activé est celui dont l'attribut tabIndex a la valeur la plus faible, et ainsi de suite, dans l'ordre croissant, quel que soit l'emplacement physique des éléments sur la page ou dans le document. Si deux éléments ont un attribut tabIndex de valeur identique, c'est celui qui apparaît le premier dans le document qui est activé d'abord. Viennent ensuite les éléments qui ne prennent pas en charge la propriété tabIndex ou dont la valeur est zéro. Ces éléments sont activés dans l'ordre où ils apparaissent dans le document. |
|
Le DOM W3C et Netscape 6 limitent la propriété tabIndex aux objets éléments suivants: a , area , button , input , object , select , textarea . A cette liste, IE 4 ajoute applet , body , div , embed , isindex , marquee , span , table , et td . IE 5 ajoute tout autre élément affichable. Une valeur négative dans IE (uniquement) supprime un élément de la séquence de tabulation. |
|
Les liens et les ancres ne sont pas activables à l'aide de la touche de tabulation dans la version Macintosh de Microsoft Internet Explorer 4 et la propriété tabIndex des objets éléments a est donc ignorée dans cette version. |
|
Exemple | |
document.getElementById("link3").tabIndex = 6; |
|
Valeur | |
Nombre entier. |
|
Par défaut | |
0 |