<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é)
Sur cette page

Exemple

#
HTML
<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>
Aperçu

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

#
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 ».
  • srcdoc

    code HTML

    Du 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é &quot;, 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.
  • 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.
  • 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 attribut allowfullscreen fonctionne encore, mais la notation plus récente est allow="fullscreen".
  • loading

    eager | lazy

    lazy ne 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 avec target="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ête Referer.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

srcdoc

code HTML

Du 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é &quot;, afin de ne pas fermer la valeur de l’attribut.

HTML
<iframe
  title="Aperçu du bouton"
  width="260"
  height="80"
  srcdoc="<button style='font: 16px system-ui; padding: 8px 16px'>S’inscrire</button>"
></iframe>
Aperçu

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.

HTML
<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>
Aperçu

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
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 sandbox avec un ensemble minimal d’autorisations.
  • Ne combinez pas allow-scripts avec allow-same-origin pour 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

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.