---
title: HTMLIFrameElement
slug: Web/API/HTMLIFrameElement
tags:
  - API
  - HTML DOM
  - Interface
  - Reference
translation_of: Web/API/HTMLIFrameElement
---
{{APIRef("HTML DOM")}}

L'interface **`HTMLIFrameElement`** fournit des propriétés et des méthodes spéciales (en plus de celles de l'interface {{domxref("HTMLElement")}} auxquelles elle peut accéder par héritage) pour manipuler la disposition et la présentation des éléments "en-ligne" d'un cadre.

{{InheritanceDiagram(600,120)}}

## Propriétés

_Propriétés héritées de son parent, {{domxref("HTMLElement")}}_.

- {{domxref("HTMLIFrameElement.align")}} {{obsolete_inline}}
  - : Est une caîne de caractères {{domxref("DOMString")}} qui spécifie l'alignement du cadre par rapport au contexte environnant.
- {{domxref("HTMLIFrameElement.allow")}} {{experimental_inline}}
  - : Est une liste d'origines à partir desquelles le cadre est autorisé à afficher du contenu. Cet attribut accepte également les valeurs `self` et `src` qui représentent l'origine dans l'attribut src de l'iframe. La valeur par défaut est `src`.
- {{domxref("HTMLIFrameElement.allowfullscreen")}} {{experimental_inline}}
  - : Est un {{domxref("Boolean")}} indiquant si le cadre en ligne est prêt à être placé en mode plein écran. Voir [Utiliser le mode plein écran](/fr/docs/Web/API/Fullscreen_API) pour plus de détails.
- {{domxref("HTMLIFrameElement.allowPaymentRequest")}}
  - : Est un {{domxref("Boolean")}} indiquant si l'API' [Payment Request API](/fr/docs/Web/API/Payment_Request_API) peut être appelée à l'intérieur d'une iframe cross-origin.
- {{domxref("HTMLIFrameElement.contentDocument")}} {{readonlyInline}}
  - : Retourne un {{domxref("Document")}}, le document actif dans le contexte de navigation imbriqué du cadre en ligne.
- {{domxref("HTMLIFrameElement.contentWindow")}} {{readonlyInline}}
  - : Renvoie un {{domxref("WindowProxy")}}, la fenêtre proxy pour le contexte de navigation imbriqué.
- {{domxref("HTMLIFrameElement.csp")}}
  - : Spécifie la politique de sécurité du contenu qu'un document incorporé doit accepter d'appliquer à lui-même.
- {{domxref("HTMLIFrameElement.frameBorder")}} {{obsolete_inline}}
  - : Est une chaîne de caractères {{domxref("DOMString")}} qui indique s'il faut créer des bordures entre les cadres.
- {{domxref("HTMLIFrameElement.height")}}
  - : Est une chaîne de caractères {{domxref("DOMString")}} qui reflète l'attribut HTML {{htmlattrxref("height", "iframe")}} indiquant la hauteur du cadre.
- {{domxref("HTMLIFrameElement.longDesc")}} {{obsolete_inline}}
  - : Est une chaîne de caractères {{domxref("DOMString")}} qui contient l'URI d'une description longue du cadre.
- {{domxref("HTMLIFrameElement.marginHeight")}} {{obsolete_inline}}
  - : Est une chaîne de caractères {{domxref("DOMString")}} représentant la hauteur de la marge du cadre.
- {{domxref("HTMLIFrameElement.marginWidth")}} {{obsolete_inline}}
  - : Est une chaîne de caractères {{domxref("DOMString")}} représentant la largeur de la marge du cadre.
- {{domxref("HTMLIFrameElement.name")}}
  - : Est une chaîne de caractères {{domxref("DOMString")}} qui reflète l'attribut HTML {{htmlattrxref("name", "iframe")}} contenant un nom permettant de faire référence au cadre.
- {{domxref("HTMLIFrameElement.featurePolicy")}} {{readonlyinline}}{{experimental_inline}}
  - : Retourne l'interface {{domxref("FeaturePolicy")}} qui fournit une API simple pour l'introspection des politiques de fonctionnalité appliquées à un document spécifique.
- {{domxref("HTMLIFrameElement.referrerPolicy")}} {{experimental_inline}}
  - : Est une chaîne de caractères {{domxref("DOMString")}} qui reflète l'attribut HTML {{htmlattrxref("referrerPolicy", "iframe")}} attribut HTML indiquant le référent à utiliser lors de l'extraction de la ressource liée.
- {{domxref("HTMLIFrameElement.sandbox")}}
  - : Est un {{domxref("DOMSettableTokenList")}} qui reflète l'attribut {{htmlattrxref("sandbox", "iframe")}} indiquant des restrictions supplémentaires sur le comportement du contenu imbriqué.
- {{domxref("HTMLIFrameElement.scrolling")}} {{obsolete_inline}}
  - : Est une chaîne de caractères {{domxref("DOMString")}} qui indique si le navigateur doit fournir des barres de défilement pour le cadre.
- {{domxref("HTMLIFrameElement.src")}}
  - : Est une chaîne de caractères {{domxref("DOMString")}} qui reflète l'attribut HTML {{htmlattrxref("src", "iframe")}} contenant l'adresse du contenu à intégrer. Notez que la suppression programmatique de l'attribut src d'un `<iframe>` (par exemple via {{domxref("Element.removeAttribute()")}}) entraîne le chargement de `about:blank` dans le cadre dans Firefox (à partir de la version 65), les navigateurs basés sur Chromium et Safari/iOS.
- {{domxref("HTMLIFrameElement.srcdoc")}}
  - : Est une chaîne de caractères {{domxref("DOMString")}} qui représente le contenu à afficher dans le cadre.
- {{domxref("HTMLIFrameElement.width")}}
  - : Est une chaîne de caractères {{domxref("DOMString")}} qui reflète l'attribut HTML {{htmlattrxref("width", "iframe")}} indiquant la largeur du cadre.

## Méthodes

_Aucune méthode spécifique ; hérite des propriétés de son parent, {{domxref("HTMLElement")}}_.

## Spécifications

| Spécification                                                                                                                | Statut                           | Commentaire                                                                                                                                                                                                                |
| ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| {{SpecName('HTML WHATWG', "#htmliframeelement", "HTMLIFrameElement")}}                                 | {{Spec2('HTML WHATWG')}} | La propriété suivante a été ajoutée : `allowFullscreen`.                                                                                                                                                                   |
| {{SpecName('HTML5 W3C', "embedded-content-0.html#the-iframe-element", "HTMLIFrameElement")}} | {{Spec2('HTML5 W3C')}}     | Les propriétés suivantes sont désormais obsolètes : `scrolling`, `marginWidth`, `marginHeight`, `longDesc`, `frameBorder` et `align`. Les propriétés suivantes ont été ajoutées : `srcdoc`, `sandbox`, et `contentWindow`. |
| {{SpecName('DOM2 HTML', 'html.html#ID-50708718', 'HTMLIFrameElement')}}                             | {{Spec2('DOM2 HTML')}}     | La propriété `contentDocument` a été ajoutée.                                                                                                                                                                              |
| {{SpecName('DOM1', 'level-one-html.html#ID-50708718', 'HTMLIFrameElement')}}                         | {{Spec2('DOM1')}}         | Définition initiale.                                                                                                                                                                                                       |

## Compatibilité des navigateurs

{{Compat("api.HTMLIFrameElement")}}

## Voir aussi

- L'élément HTML implémentant cette interface : {{HTMLElement("iframe")}}