From 99efa5cfa34c3f9d38b75352881acdfc99508ebf Mon Sep 17 00:00:00 2001 From: tristantheb Date: Fri, 2 Apr 2021 13:50:14 +0200 Subject: UPDATE: FR-ONLY - Remove all old CompatibilityTable to replace with {{Compat()}} (#311) * UPDATE: Removing CompatibilityTable script - Part 1 * UPDATE: Removing CompatibilityTable script - Part 2 * UPDATE: Removing CompatibilityTable script - Part 3 * UPDATE: Removing CompatibilityTable script - Part 4 * UPDATE: Removing CompatibilityTable script - Part 5/5 * FIX: Repair the EOL of one page * FIX: Fix conflicting file --- files/fr/web/api/htmliframeelement/index.html | 339 +++++++------------------- 1 file changed, 85 insertions(+), 254 deletions(-) (limited to 'files/fr/web/api/htmliframeelement/index.html') diff --git a/files/fr/web/api/htmliframeelement/index.html b/files/fr/web/api/htmliframeelement/index.html index 6a8377ba23..c1e182c024 100644 --- a/files/fr/web/api/htmliframeelement/index.html +++ b/files/fr/web/api/htmliframeelement/index.html @@ -1,279 +1,110 @@ --- 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 il peut accéder par héritage) pour manipuler la disposition et la présentation des éléments "en-ligne" d'une frame.

+

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.

-

Propriétés

+

{{InheritanceDiagram(600,120)}}

-

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

+

Propriétés

+ +

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

-
{{domxref("HTMLIFrameElement.align")}} {{obsolete_inline}}
-
Is a {{domxref("DOMString")}} that specifies the alignment of the frame with respect to the surrounding context.
-
{{domxref("HTMLIFrameElement.allowfullscreen")}} {{experimental_inline}}
-
Is a {{domxref("Boolean")}} that indicates whether or not the inline frame is willing to be placed into full screen mode. See Using full-screen mode for details.
-
{{domxref("HTMLIFrameElement.contentDocument")}} {{readonlyInline}}
-
Returns a {{domxref("Document")}}, the active document in the inline frame's nested browsing context.
-
{{domxref("HTMLIFrameElement.contentWindow")}} {{readonlyInline}}
-
Returns a {{domxref("WindowProxy")}}, the window proxy for the nested browsing context.
-
{{domxref("HTMLIFrameElement.frameborder")}} {{obsolete_inline}}
-
Is a {{domxref("DOMString")}} that indicates whether to create borders between frames.
-
{{domxref("HTMLIFrameElement.height")}}
-
Is a {{domxref("DOMString")}} that reflects the {{htmlattrxref("height", "iframe")}} HTML attribute, indicating the height of the frame.
-
{{domxref("HTMLIFrameElement.longDesc")}} {{obsolete_inline}}
-
Is a {{domxref("DOMString")}} that contains the URI of a long description of the frame.
-
{{domxref("HTMLIFrameElement.marginHeight")}} {{obsolete_inline}}
-
Is a {{domxref("DOMString")}} being the height of the frame margin.
-
{{domxref("HTMLIFrameElement.marginWidth")}} {{obsolete_inline}}
-
Is a {{domxref("DOMString")}} being the width of the frame margin.
-
{{domxref("HTMLIFrameElement.name")}}
-
Is a {{domxref("DOMString")}} that reflects the {{htmlattrxref("name", "iframe")}} HTML attribute, containing a name by which to refer to the frame.
-
{{domxref("HTMLIFrameElement.sandbox")}}
-
Is a {{domxref("DOMSettableTokenList")}} that reflects the {{htmlattrxref("sandbox", "iframe")}} HTML attribute, indicating extra restrictions on the behavior of the nested content.
-
{{domxref("HTMLIFrameElement.scrolling")}} {{obsolete_inline}}
-
Is a {{domxref("DOMString")}} that indicates whether the browser should provide scrollbars for the frame.
-
{{domxref("HTMLIFrameElement.seamless")}} {{experimental_inline}}
-
Is a {{domxref("Boolean")}} that reflects the {{htmlattrxref("seamless", "iframe")}} HTML attribute, indicating that the inline frame should be rendered seamlessly within the parent document.
-
{{domxref("HTMLIFrameElement.src")}}
-
Is a {{domxref("DOMString")}} that reflects the {{htmlattrxref("src", "iframe")}} HTML attribute, containing the address of the content to be embedded.
-
{{domxref("HTMLIFrameElement.srcdoc")}}
-
Is a {{domxref("DOMString")}} that represents the content to display in the frame.
-
{{domxref("HTMLIFrameElement.width")}}
-
Is a {{domxref("DOMString")}} that reflects the {{htmlattrxref("width", "iframe")}} HTML attribute, indicating the width of the frame.
+
{{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 pour plus de détails.
+
{{domxref("HTMLIFrameElement.allowPaymentRequest")}}
+
Est un {{domxref("Boolean")}} indiquant si l'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

+

Méthodes

-

No specific method; inherits properties from its parent, {{domxref("HTMLElement")}}.

+

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

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('HTML WHATWG', "the-iframe-element.html#the-iframe-element", "HTMLIFrameElement")}}{{Spec2('HTML WHATWG')}}The following property has been added: allowFullscreen.
{{SpecName('HTML5 W3C', "embedded-content-0.html#the-iframe-element", "HTMLIFrameElement")}}{{Spec2('HTML5 W3C')}}The following properties are now obsolete: scrolling, marginWidth, marginHeight, longDesc, frameBorder, and align.
- The following properties have been added: srcdoc, sandbox, seamless, and contentWindow.
{{SpecName('DOM2 HTML', 'html.html#ID-50708718', 'HTMLIFrameElement')}}{{Spec2('DOM2 HTML')}}The contentDocument property has been added.
{{SpecName('DOM1', 'level-one-html.html#ID-50708718', 'HTMLIFrameElement')}}{{Spec2('DOM1')}}Initial definition.
- -

Browser compatibility

- -
{{CompatibilityTable}}
- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support{{CompatVersionUnknown}}{{CompatGeckoDesktop(1.0)}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
srcdoc4{{CompatGeckoDesktop(25)}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
sandbox4{{CompatGeckoDesktop(17)}} [1]{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
seamless {{experimental_inline}}4{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
contentDocument{{CompatVersionUnknown}}{{CompatVersionUnknown}}8.0 (for older version use HTMLIFrameElement.contentWindow.document instead){{CompatVersionUnknown}}{{CompatVersionUnknown}}
contentWindow{{CompatUnknown}}{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatUnknown}}
allowFullScreen {{experimental_inline}}17 {{property_prefix("-webkit")}}
- Daily test builds only		{{compatGeckoDesktop(9.0)}} {{property_prefix("-moz")}}
- {{compatGeckoDesktop(18.0)}}		{{CompatNo}}{{CompatNo}}{{CompatNo}}
SpécificationStatutCommentaire
{{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.
-
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Basic support{{CompatVersionUnknown}}{{CompatGeckoMobile(1.0)}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
srcdoc4{{CompatGeckoMobile(25)}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
sandbox4{{CompatGeckoMobile(17)}} [1]{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
seamless {{experimental_inline}}4{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
contentDocument{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
contentWindow{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
allowFullScreen {{experimental_inline}}17 {{property_prefix("-webkit")}}
- Daily test builds only		{{compatGeckoMobile(9.0)}} {{property_prefix("-moz")}}
- {{compatGeckoMobile(18.0)}}		{{CompatNo}}{{CompatNo}}{{CompatNo}}
-
+

Compatibilité des navigateurs

-

[1] Previously, the type of sandbox was a {{domxref("DOMString")}} instead of a {{domxref("DOMSettableTokenList")}}. This has been fixed with Gecko 29.0 {{geckoRelease(29)}}) ({{bug(845067)}}). Other browsers may still implement the property as DOMString since it was a late change in the specification.

- -

Firefox OS notes

- -

Firefox OS extend the HTMLIFrameElement interface to support browser iframes. Those extra methods are made for privileged applications which want to implement a browser like application for Firefox OS devices. Not that in that context, the HTMLIFrameElement also inherit methods from the {{domxref("EventTarget")}} interface. To learn how to implement such applications, see the Using the Browser API article.

- -
-
{{domxref("HTMLIFrameElement.setVisible()","HTMLIFrameElement.setVisible(visible)")}}
-
Allows the parent to explicitly change the visibility state of the browser iframes.
-
{{domxref("HTMLIFrameElement.getVisible()","HTMLIFrameElement.getVisible()")}}
-
Returns the current visibility state of the browser iframe. Returns a {{domxref("DOMRequest")}}.
-
{{domxref("HTMLIFrameElement.sendMouseEvent()","HTMLIFrameElement.sendMouseEvent(type, x, y, button, clickCount, modifiers)")}}
-
Send a mouse event to the browser iframe.
-
{{domxref("HTMLIFrameElement.sendTouchEvent()","HTMLIFrameElement.sendTouchEvent(type, identifiers, touchesX, touchesY,radiisX, radiisY, rotationAngles, forces,count, modifiers)")}}
-
Send a touch event to the browser iframe.
-
{{domxref("HTMLIFrameElement.goBack()","HTMLIFrameElement.goBack()")}}
-
Navigate the browser iframe back.
-
{{domxref("HTMLIFrameElement.goForward()","HTMLIFrameElement.goForward()")}}
-
Navigate the browser iframe forward.
-
{{domxref("HTMLIFrameElement.reload()","HTMLIFrameElement.reload()")}}
-
Reload the browser iframe.
-
{{domxref("HTMLIFrameElement.stop()","HTMLIFrameElement.stop()")}}
-
Stop loading the browser iframe content.
-
{{domxref("HTMLIFrameElement.purgeHistory()","HTMLIFrameElement.purgeHistory()")}}
-
Allows to remove the all browsing history of the browser iframe.
-
{{domxref("HTMLIFrameElement.getScreenshot()","HTMLIFrameElement.getScreenshot(maxWidth, maxHeight)")}}
-
Allows to take a screenshot of the browser iframe's content, scaled to fit within maxWidth and maxHeight pixels. Returns a {{domxref("DOMRequest")}}.
-
{{domxref("HTMLIFrameElement.addNextPaintListener()","HTMLIFrameElement.addNextPaintListener()")}}
-
Add a listener to recieve an event the first time the browser iframe is ready to paint (This listener is sent an event after the first {{event("MozAfterPaint")}} event is dispacted in the iframe.)
-
{{domxref("HTMLIFrameElement.removeNextPaintListener()","HTMLIFrameElement.removeNextPaintListener()")}}
-
Remove the listener added by the previous function.
-
{{domxref("HTMLIFrameElement.getCanGoBack()","HTMLIFrameElement.getCanGoBack()")}}
-
Returns a {{domxref("DOMRequest")}} which result is a boolean indicating wether the browser iframe can be navigate backward.
-
{{domxref("HTMLIFrameElement.getCanGoForward()","HTMLIFrameElement.getCanGoForward()")}}
-
Returns a {{domxref("DOMRequest")}} which result is a boolean indicating wether the browser iframe can be navigate forward.
-
+

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

-

See also

+

Voir aussi

-- cgit v1.2.3-54-g00ecf