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.

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.

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.

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.

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.

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.

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

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.

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.

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.

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.

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.

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.

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

Voir hspace.

Voir height.