<IFRAME> | NN 6 IE 3 HTML 4
<IFRAME>...</IFRAME> | Balise de fin HTML : obligatoire
L'élément iframe crée un cadre interne au sein du flux naturel de contenu du document. Ce cadre (frame) est un espace rectangulaire dans lequel peut être chargé un autre document HTML (ou dans lequel il est possible d'écrire un contenu dynamique, à l'aide d'un script). Si vous affectez une valeur à l'attribut name d'un élément iframe, vous pouvez ensuite utiliser ce nom comme valeur de l'attribut target d'un élément a, form, ou de tout autre élément qui permet de définir une cible de destination ou de renvoi d'un document. Bien que l'espace rectangulaire défini par l'élément iframe débute immédiatement après le contenu qui le précède (donc éventuellement dans une ligne de texte), le contenu qui suit la balise de fin de cet élément débute sur la ligne qui suit ce rectangle. Le texte qui encadre l'élément iframe peut être aligné de la même manière que pour les éléments img ou object. Le contenu qui figure entre les balises de début et de fin de l'élément iframe est ignoré par les navigateurs qui prennent en charge cet élément. Les autres navigateurs affichent ce contenu dans le flux HTML; cela permet d'indiquer à l'utilisateur que son navigateur n'affiche pas la page intégralement et, éventuellement, de fournir un lien vers des informations complémentaires). Dans Navigator 4, l'élément le plus proche de iframe, en termes de fonctionnalités et de comportement, est l'élément ilayer. Puisqu'un élément iframe tire son contenu d'un fichier serveur séparé, il peut permettre les inclusions côté client (reportez-vous au chapitre 5). A bien des égards, un élément iframe a le même comportement qu'un élément frame, mais les jeux de cadres sont inutiles. En fait, l'élément a en gros le même comportement qu'un cadre et si vous choisissez de le référencer au moyen de la syntaxe de référencement de cadre (window.frameName), l'objet renvoyé possède le même type que l'objet window, plutôt qu'un objet élément frame. Alors que l'élément iframe est validé dans la DTD HTML 4 de transition avec les éléments frame et frameset, seul l'élément iframe est validé dans la DTD XHTML de transition. L'élément iframe est validé dans les DTD de jeux de cadres pour HTML 4 et XHTML.
Exemple
    <IFRAME src="quotes.html" width="150" height="90">
    <A href="quotes.html" target="new" style="color:darkred">
     Click here to see the latest quotes </A>
    </IFRAME>
Rflrence de modle d'objet
    [window.]document.getElementById(elementID)
Attributs sprcifiques à l'élément
align | datafld | datasrc | frameborder | height
hspace | longdesc | marginheight | marginwidth | name
scrolling | security | src | vspace | width
Attributs du gestionnaire d'événements spécifiques à l'élément
Aucune.

align | NN 6 IE 3 HTML 4
align="alignmentConstant" | Facultatif
Détermine le type d'alignement du rectangle de l'élément iframe dans le contexte du contenu environnant. Reportez-vous à la section 8.1.5, au début de ce chapitre, pour la description des possibilités définies pour l'attribut de cet élément.
Exemple
    <IFRAME src="quotes.html" width="150" height="90" align="center"></IFRAME>
Valeur
Constante non sensible à la casse.
Par défaut
left
Rfgrence de modle d'objet
    [window.]document.getElementById(elementID).align

datafld | NN s.o. IE 4 HTML s.o.
datafld="columnName" | Facultatif
Cet attribut est utilisé avec Internet Explorer dans le cadre d'une liaison de données, pour associer le nom d'une colonne d'une source de données distante à un élément frame, à la place de l'attribut src. Cette colonne doit contenir une adresse URI valide (relative ou absolue). Vous devez également définir un attribut datasrc pour l'élément. S'applique uniquement aux sources de données de fichier texte dans IE 5/Mac.
Exemple
    <IFRAME datasrc="DBSRC3" datafld="newsURL"></IFRAME>
Valeur
Identifiant sensible à la casse.
Par défaut
Aucune.
Rf>rence de modle d'objet
    [window.]document.getElementById(elementID).dataFld

datasrc | NN s.o. IE 4 HTML s.o.
datasrc="dataSourceName" | Facultatif
Utilisl 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 contenu à extraire de la source de données est spécifié à l'aide de l'attribut datafld. S'applique uniquement aux sources de données de fichier texte dans IE 5/Mac.
Exemple
    <IFRAME datasrc="DBSRC3" datafld="newsURL"></IFRAME>
Valeur
Identifiant sensible à la casse.
Par défaut
Aucune.
Rforence de modle d'objet
    [window.]document.getElementById(elementID).dataSrc

frameborder | NN 6 IE 3 HTML 4
frameborder="borderSwitch" | Facultatif
Contrcle si l'élément iframe affiche une bordure. Si vous voulez que les documents liés ressemblent à des documents imbriqués dans le document principal, désactivez l'attribut frameborder.
Exemple
    <IFRAME src="quotes.html" width="150" height="90" frameborder="no"></IFRAME>
Valeur
Les valeurs d'activation et désactivation de cet attribut varient selon les sources. HTML 4 spécifie des valeurs de 1 (activée) et 0 (désactivée). Internet Explorer 4 et Netscape 6 acceptent la valeur HTML et les valeurs yes ou no.
Par défaut
1
Rfsrence de modle d'objet
    [window.]document.getElementById(elementID).frameBorder

height, width | NN 6 IE 3 HTML 4
height="length" width="length" | Facultatif
Ces attributs dnfinissent les dimensions de l'élément iframe. IE 4.5 et versions ultérieures sur le Mac est requise. Les deux attributs sont délaissés dans HTML 4, au profit des attributs de feuilles de style height et width CSS.
Exemple
    <IFRAME src="news.html" height="200" width="200">
Valeur
Toute valeur en pixels ou en pourcentage de l'espace disponible.
Par défaut
Largeur: 300 pixels; hauteur: 150 pixels.
Rfvrence de modle d'objet
    [window.]document.getElementById(elementID).height
    [window.]document.getElementById(elementID).width

hspace, vspace | NN s.o. IE 4 HTML s.o.
hspace="pixelCount" vspace="pixelCount" | Facultatif
Ces attributs définissent le remplissage autour d'un élément iframe par rapport au flux de contenu. L'attribut hspace contrôle la marge extérieure le long des côtés gauche et droit (remplissage horizontal), et l'attribut vspace contrôle la marge extérieure le long des côtés supérieur et inférieur (remplissage vertical). Ce « remplissage » permet d'ajouter un espace vide autour du cadre concerné. Vous pouvez également (pour garantir la compatibilité entre les navigateurs), utiliser les divers paramètres de marges dans une feuille de style, en particulier si vous ne désirez redéfinir l'espace vierge que le long d'un seul côté.
Exemple
    <IFRAME src="news.html" hspace="20" vspace="10">
Valeur
Tout entier positif.
Par défaut
0
Rf;rence de modle d'objet
    [window.]document.getElementById(elementID).hspace
    [window.]document.getElementById(elementID).vspace

longdesc | NN 6 IE 6 HTML 4
longdesc="URL" | Facultatif
Permet de sp/cifier l'adresse URL d'un document contenant une description de l'élément plus longue que celle qui apparaît dans l'attribut title. Une application de cet attribut, dans de futures versions des navigateurs, pourra consister à recevoir une description annotée de l'élément, pour les utilisateurs qui ne peuvent pas lire l'écran du navigateur. La sélection de Properties pour le menu contextuel de Netscape 6 de cet élément affiche une petite fenêtre qui inclut un lien actif vers l'URL assigné à l'attribut. Les navigateurs de la Version 6 ne proposent aucune autre fonctionnalité pour cet attribut.
Exemple
    <IFRAME longdesc="newsDesc.html" title="Navigation Bar" src="news.html">
    </IFRAME>
Valeur
Toute adresse URI et URL valide (complète ou relative).
Par défaut
Aucune.

marginheight, marginwidth | NN 6 IE 3 HTML 4
marginheight="pixelCount" marginwidth="pixelCount" | Facultatif
Ces attributs déterminent le nombre de pixels qui séparent le bord intérieur d'un cadre et le contenu de ce cadre. L'attribut marginheight contrôle l'espace le long des bords supérieur et inférieur (en cas de défilement) du cadre; l'attribut marginwidth contrôle l'espace le long des bords gauche et droit. Les spécifications HTML 4 laissent le comportement par défaut à la discrétion des développeurs du navigateur. Les navigateurs insèrent leurs marges par défaut (entre 8 et 14 pixels) à l'intérieur d'un cadre. 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
    <IFRAME src="news.html" marginheight="20" marginwidth="14"></IFRAME>
Valeur
Tout entier positif, ou zéro.
Par défaut
Varie selon le navigateur et le système d'exploitation.
Rf rence de modle d'objet
    [window.]document.getElementById(elementID).marginHeight
    [window.]document.getElementById(elementID).marginWidth

name | NN 6 IE 3 HTML 4
name="elementIdentifier" | Facultatif
Lorsque des liens ou des formulaires doivent charger leurs documents de destination ou de retour dans d'autres cadres que celui qui les contient, l'attribut target de ces éléments permet d'indiquer le cadre qui doit recevoir le nouveau contenu. Pour que le contenu soit inséré dans un cadre précis, une valeur doit être affectée à l'attribut name de ce cadre. Cette même valeur est ensuite donnée à l'attribut target de l'élément a ou form.
Exemple
    <IFRAME name="news" id="news" src="news.html"></IFRAME>
Valeur
Identifiant sensible à la casse.
Par défaut
Aucune.
Rf/rence de modle d'objet
    [window.]document.getElementById(elementID).name

scrolling | NN 6 IE 3 HTML 4
scrolling="featureSwitch" | Facultatif
Par dofaut, les navigateurs ajoutent des barres de défilement vertical et / ou horizontal lorsque le contenu d'un cadre interne déborde de la zone visible de cet élément. Les barres de défilement peuvent fréquemment affecter la présentation du contenu, car elles occupent un espace normalement dévolu à ce contenu (les dimensions extérieures du cadre ne changent pas en fonction de la présence ou non de barres de défilement). De plus, en raison des différences de taille des polices de caractères par défaut selon le navigateur et le système d'exploitation, un texte donné s'affichera de façon différente dans différents navigateurs. Pour empêcher le cadre d'afficher des barres de défilement, donnez la valeur no à l'attribut scrolling; à l'inverse, pour que les barres de défilement soient présentes en permanence dans ce cadre, donnez à cet attribut la valeur yes. Dans ce dernier cas, si le contenu ne nécessite pas de défilement, les barres seront visibles, mais inactives. Il est conseillé de ne donner la valeur no à l'attribut scrolling qu'après avoir testé avec tous les navigateurs et toutes les plates-formes qu'un contenu important est toujours visible dans le cadre, pour tous les navigateurs et toutes les plate-formes. Faute de quoi, en l'absence de barres de défilement, certains utilisateurs pourraient ne pas être en mesure de voir tout le contenu du cadre. A la place de cet attribut, vous pouvez aussi utiliser l'attribut de style overflow CSS. Microsoft assure un contrôle supplémentaire des axes sur les barres de défilement, au moyen de leurs attributs de style overflow-x et overflow-y.
Exemple
    <IFRAME src="news.html" scrolling="no"></IFRAME>
Valeur
Constantes: auto | no | yes.
Par défaut
auto
Rfdrence de modle d'objet
    [window.]document.getElementById(elementID).scrolling

security | NN s.o. IE 6 HTML s.o.
security="restricted" | Facultatif
Si vous l'activez, cet attribut accroît le niveau de sécurité du cadre interne au niveau Restreint dans les préférences de sécurité de Windows. Le contenu d'un tel cadre ne pourra peut-être pas exécuter des scripts.
Exemple
    <IFRAME src="news.html" security="restricted">
Valeur
Constante: restricted.
Par défaut
Aucune.

src | NN 6 IE 3 HTML 4
src="URL" | Facultatif
Définit l'adresse URL du contenu qui doit être chargé dans l'élément iframe. Cette adresse URL peut être absolue, ou relative à celle du document qui contient les spécifications du jeu de cadres. Vous pouvez également utiliser la pseudo URL javascript: pour faire apparaître dans le cadre la valeur renvoyée par le script ainsi appelé. Si l'attribut src est omis, le cadre reste vide.
Exemple
    <IFRAME src="news.html"></IFRAME>
Valeur
Une adresse URL complète ou relative, ou la pseudo-URL javascript: .
Par défaut
Aucune.
Rf0rence de modle d'objet
    [window.]document.getElementById(elementID).src

style | NN 4 IE 4 HTML 4
style="styleSheetProperties" | Facultatif
Cet attribut permet de définir une ou plusieurs propriétés de style pour l'élément considéré. Vous pouvez utiliser la syntaxe CSS ou (pour Navigator 4 uniquement) JavaScript pour affecter des attributs de style. Utilisez l'attribut style uniquement avec les éléments visibles (affichables).
Exemple
    <span style="color:green; font-size:18px">Big, green, and bold</span>
Valeur
L'ensemble de la règle de feuille de style, qui est conforme à la syntaxe des CSS, est entre guillemets. Les divers attributs de style et leurs valeurs sont séparés par des points-virgules. Les attributs des feuilles de style sont présentés en détail dans le chapitre 11.
Par défaut
Aucune.
Rfprence de modle d'objet
    [window.]document.getElementById(elementID).style

vspace |
Voir hspace.

width |
Voir height.