iframeNN 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
 
alignallowTransparencyborderborderColorcontentDocument
contentWindowdataFlddataSrcframeBorderframeSpacing
heighthspacelongDescmarginHeightmarginWidth
namenoResizescrollingsrcvspace
width
 
Méthodes spécifiques à l´objet

Aucune.

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

Aucune.

alignNN 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

allowTransparencyNN 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

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

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

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

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

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

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
 
document.getElementById("myIframe").dataSrc = "DBSRC3";
 
Valeur

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

 
Par défaut

Aucune.

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

frameSpacingNN 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, widthNN 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, vspaceNN 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

longDescNN 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, marginWidthNN 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.

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

noResizeNN s.o. IE 4 DOM s.o.

Lecture/écriture

Indique si l'utilisateur peut redimensionner le cadre. Non applicable à un élément iframe.

scrollingNN 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

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

tabIndexNN 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