<iframe>
Un cadre qui intègre un autre document HTML dans la page, par exemple une vidéo YouTube ou une carte.
- Affichage
- inline (élément remplacé)
- Balise fermante
- Obligatoire
- Contenu autorisé
- Aucun (le contenu entre les balises est ignoré)
Exemple
#<iframe
title="Carte de visite d’Ania"
width="320"
height="140"
srcdoc="<h1 style='font: 700 22px system-ui; margin: 0 0 8px'>Ania Kowalska</h1><p style='font: 15px system-ui; margin: 0'>J’apprends le HTML et le CSS. Voici ma première page !</p>"
></iframe>Définition et utilisation
#L’élément <iframe> (de l’anglais inline frame) affiche à l’intérieur de la page un document totalement distinct, avec son propre HTML, son CSS et son JavaScript. C’est ainsi que l’on intègre les lecteurs YouTube et Vimeo, les cartes, les formulaires de paiement ou les widgets de chat. Vous indiquez l’adresse du document dans src, et vous pouvez aussi écrire un court code HTML directement dans l’attribut srcdoc.
Le contenu du cadre est isolé de votre page : les styles ne se mélangent pas, et les scripts d’un autre domaine n’ont pas accès à votre DOM. De nombreux sites n’autorisent pas du tout l’intégration de leurs pages dans des cadres et le bloquent par des en-têtes de réponse : toutes les pages ne peuvent donc pas être affichées dans un <iframe>.
Chaque cadre devrait avoir un attribut title décrivant son contenu, par exemple « Plan d’accès au bureau ». Un lecteur d’écran le lit avant que l’utilisateur n’entre dans le cadre. Les cadres situés sous le premier écran gagnent à être chargés paresseusement avec loading="lazy".
Syntaxe
#<iframe src="adresse" title="Description du contenu" width="…" height="…"></iframe>Attributs
#src
URL
L’adresse du document affiché dans le cadre. Des services comme YouTube ou Google Maps fournissent un code<iframe>prêt à l’emploi, avec la bonne adresse, dans l’option « Partager », puis « Intégrer ».code HTML
Du code HTML que le cadre affiche au lieu de charger une page depuis une adresse. Il a priorité sursrc. Écrivez les guillemets à l’intérieur du code sous forme de guillemets simples ou de l’entité", afin de ne pas fermer la valeur de l’attribut.width / height
nombre de pixels
Les dimensions du cadre, 300 sur 150 pixels par défaut. Le contenu qui ne tient pas est défilé à l’intérieur du cadre.vide ou liste d’autorisations, p. ex. `allow-scripts allow-forms`
Exécute le cadre dans un bac à sable avec des restrictions. Un attribut vide bloque les scripts, les formulaires et les fenêtres contextuelles, et traite le contenu comme provenant d’un domaine étranger. Vous rétablissez d’autres autorisations avec des mots-clés, par exempleallow-scriptsouallow-forms. Dans l’exemple, le même script ne s’exécute que dans le second cadre.allow
liste d’autorisations, p. ex. `fullscreen; autoplay; clipboard-write`
Définit les fonctionnalités du navigateur que le cadre peut utiliser : plein écran, lecture automatique, caméra, microphone, presse-papiers. Les codes d’intégration prêts à l’emploi de YouTube contiennent déjà la bonne valeur. L’ancien attributallowfullscreenfonctionne encore, mais la notation plus récente estallow="fullscreen".loading
eager | lazy
lazyne charge le cadre que lorsqu’il approche de la partie visible de la page. C’est une grosse économie pour les vidéos et les cartes intégrées, qui pèsent souvent plus que tout le reste de la page.name
texte
Le nom du cadre. Un lien avectarget="nom"ouvrira son adresse dans ce cadre précis.referrerpolicy
no-referrer | origin | strict-origin-when-cross-origin | …
Détermine la quantité d’informations sur votre page transmise au service intégré dans l’en-têteReferer.
L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.
Attributs en pratique
#srcdoc
code HTMLDu code HTML que le cadre affiche au lieu de charger une page depuis une adresse. Il a priorité sur src. Écrivez les guillemets à l’intérieur du code sous forme de guillemets simples ou de l’entité ", afin de ne pas fermer la valeur de l’attribut.
<iframe
title="Aperçu du bouton"
width="260"
height="80"
srcdoc="<button style='font: 16px system-ui; padding: 8px 16px'>S’inscrire</button>"
></iframe>sandbox
vide ou liste d’autorisations, p. ex. `allow-scripts allow-forms`Exécute le cadre dans un bac à sable avec des restrictions. Un attribut vide bloque les scripts, les formulaires et les fenêtres contextuelles, et traite le contenu comme provenant d’un domaine étranger. Vous rétablissez d’autres autorisations avec des mots-clés, par exemple allow-scripts ou allow-forms. Dans l’exemple, le même script ne s’exécute que dans le second cadre.
<iframe
sandbox
title="Cadre sans autorisations"
width="220"
height="70"
srcdoc="<p id='msg' style='font: 15px system-ui'>Scripts bloqués</p><script>document.getElementById('msg').textContent = 'Le script fonctionne'</script>"
></iframe>
<iframe
sandbox="allow-scripts"
title="Cadre avec l’autorisation allow-scripts"
width="220"
height="70"
srcdoc="<p id='msg' style='font: 15px system-ui'>Scripts bloqués</p><script>document.getElementById('msg').textContent = 'Le script fonctionne'</script>"
></iframe>CSS par défaut
#La plupart des navigateurs affichent cet élément avec ces styles par défaut :
iframe {
border: 2px inset;
}Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- Un cadre issu d’un autre site exécute du code qui n’est pas le vôtre. N’intégrez que des services de confiance, et pour les services inconnus, ajoutez
sandboxavec un ensemble minimal d’autorisations. - Ne combinez pas
allow-scriptsavecallow-same-originpour du contenu de votre propre domaine. Le script du cadre pourrait alors lever lui-même les restrictions du bac à sable. - Vous obtenez un cadre vidéo responsive en CSS :
width: 100%; aspect-ratio: 16 / 9; border: 0;.
Entrées associées
#- <embed>Intègre une ressource externe dans la page, le plus souvent un document PDF.
- <object>Intègre une ressource externe (PDF, image, page) avec un contenu de remplacement au cas où elle ne se chargerait pas.
- <video>Un lecteur vidéo intégré directement à la page.
- <a>Un lien vers une autre page, un fichier, une adresse e-mail ou un endroit sur la même page.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.