Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLIFrameElement

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

L'interface HTMLIFrameElement fournit des propriétés et des méthodes spéciales (en plus de celles de l'interface 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.

must be a string

Propriétés d'instance

Hérite également des propriétés de son parent, HTMLElement.

HTMLIFrameElement.align Obsolète

Une chaîne de caractères qui définit l'alignement du cadre par rapport au contexte environnant.

HTMLIFrameElement.allow

Une chaîne de caractères qui indique la politique d'autorisations définie pour ce <iframe>.

HTMLIFrameElement.allowfullscreen

Un booléen indiquant si le cadre intégré est prêt à être placé en mode plein écran. Voir Utiliser le mode plein écran pour plus de détails.

HTMLIFrameElement.allowPaymentRequest Obsolète Non standard

Un booléen indiquant si l'API Payment Request peut être appelée à l'intérieur d'un cadre intégré (iframe en anglais) inter-origine (cross-origin en anglais).

HTMLIFrameElement.browsingTopics Non standard Obsolète

Une propriété booléenne indiquant que les sujets sélectionnés pour l'utilisateur·ice actuel·le doivent être envoyés avec la requête pour la source de l'élément HTML <iframe> associé. Cela reflète la valeur de l'attribut de contenu browsingtopics. HTMLIFrameElement.contentDocument Lecture seule

Retourne un objet Document, le document actif dans le contexte de navigation imbriqué du cadre intégré.

HTMLIFrameElement.contentWindow Lecture seule

Retourne un WindowProxy, la fenêtre mandataire pour le contexte de navigation imbriqué.

HTMLIFrameElement.credentialless Expérimental

Un booléen indiquant si un <iframe> est sans identifiants, ce qui signifie que son contenu est chargé dans un nouveau contexte éphémère. Ce contexte n'a pas accès au stockage partagé et aux identifiants du contexte parent. En contrepartie, les règles d'intégration du Cross-Origin-Embedder-Policy (COEP) peuvent être levées, de sorte que les documents avec COEP défini peuvent intégrer des documents tiers qui ne le sont pas. Voir IFrame sans identifiant pour une explication plus approfondie.

HTMLIFrameElement.csp Expérimental

Définit la politique de sécurité du contenu qu'un document incorporé doit accepter d'appliquer à lui-même.

HTMLIFrameElement.featurePolicy Lecture seule Expérimental

Retourne l'interface FeaturePolicy qui fournit une API simple pour l'introspection des politiques d'autorisations appliquées à un document spécifique.

HTMLIFrameElement.frameBorder Obsolète

Est une chaîne de caractères qui indique s'il faut créer des bordures entre les cadres.

HTMLIFrameElement.height

Est une chaîne de caractères qui reflète l'attribut HTML height indiquant la hauteur du cadre.

HTMLIFrameElement.loading

Une chaîne de caractères fournissant une indication au navigateur que le cadre intégré (iframe en anglais) doit être chargée immédiatement (eager) ou au besoin (lazy). Cela reflète l'attribut HTML loading.

HTMLIFrameElement.longDesc Obsolète

Est une chaîne de caractères qui contient l'URI d'une description longue du cadre.

HTMLIFrameElement.marginHeight Obsolète

Est une chaîne de caractères représentant la hauteur de la marge du cadre.

HTMLIFrameElement.marginWidth Obsolète

Est une chaîne de caractères représentant la largeur de la marge du cadre.

HTMLIFrameElement.name

Est une chaîne de caractères qui reflète l'attribut HTML name contenant un nom permettant de faire référence au cadre.

HTMLIFrameElement.privateToken Expérimental

Une représentation sous forme de chaîne de caractères d'un objet d'options représentant une opération de jeton d'état privé ; cet objet a la même structure que la propriété privateToken du dictionnaire RequestInit. Reflète le contenu de l'attribut privateToken de l'élément <iframe> associé.

HTMLIFrameElement.referrerPolicy

Est une chaîne de caractères qui reflète l'attribut HTML referrerPolicy attribut HTML indiquant le référent à utiliser lors de l'extraction de la ressource liée.

HTMLIFrameElement.sandbox

Retourne un objet DOMTokenList qui reflète l'attribut sandbox indiquant des restrictions supplémentaires sur le comportement du contenu imbriqué.

HTMLIFrameElement.scrolling Obsolète

Est une chaîne de caractères qui indique si le navigateur doit fournir des barres de défilement pour le cadre.

HTMLIFrameElement.src

Est une chaîne de caractères qui reflète l'attribut HTML src contenant l'adresse du contenu à intégrer. Notez que la suppression programmatique de l'attribut src d'un <iframe> (par exemple via 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.

HTMLIFrameElement.srcdoc

Est une chaîne de caractères qui représente le contenu à afficher dans le cadre.

HTMLIFrameElement.width

Est une chaîne de caractères qui reflète l'attribut HTML width indiquant la largeur du cadre.

Méthodes d'instance

Hérite également des méthodes de son parent, HTMLElement.

HTMLIFrameElement.getSVGDocument()

Retourne le SVG intégré en tant que Document.

Spécifications

Specification
HTML
# htmliframeelement

Compatibilité des navigateurs

Voir aussi

  • L'élément HTML implémentant cette interface : <iframe>