HTMLIFrameElement

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("HTML DOM")}}

The **HTMLIFrameElement** interface provides special properties and methods (beyond those of the {{domxref("HTMLElement")}} interface it also has available to it by inheritance) for manipulating the layout and presentation of inline frame elements.

{{InheritanceDiagram}}

Instance properties

_Inherits properties from its parent, {{domxref("HTMLElement")}}_.

  • {{domxref("HTMLIFrameElement.align")}} {{Deprecated_Inline}}
  • : A string that specifies the alignment of the frame with respect to the surrounding context.
  • {{domxref("HTMLIFrameElement.allow")}}
  • : A string that indicates the Permissions Policy specified for this <iframe>.
  • {{domxref("HTMLIFrameElement.allowFullscreen")}}
  • : A boolean value indicating whether the inline frame is willing to be placed into full screen mode. See Using fullscreen mode for details.
  • {{domxref("HTMLIFrameElement.allowPaymentRequest")}} {{Deprecated_Inline}} {{Non-standard_Inline}}
  • : A boolean value indicating whether the Payment Request API may be invoked inside a cross-origin iframe.
  • {{domxref("HTMLIFrameElement.browsingTopics")}} {{non-standard_inline}} {{deprecated_inline}}
  • : A boolean property specifying that the selected topics for the current user should be sent with the request for the associated {{htmlelement("iframe")}}'s source. This reflects the browsingtopics content attribute value.
  • {{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 {{glossary("WindowProxy")}}, the window proxy for the nested browsing context.
  • {{domxref("HTMLIFrameElement.credentialless")}} {{Experimental_Inline}}
  • : A boolean value indicating whether the <iframe> is credentialless, meaning that its content is loaded in a new, ephemeral context. This context does not have access to the parent context's shared storage and credentials. In return, the {{httpheader("Cross-Origin-Embedder-Policy")}} (COEP) embedding rules can be lifted, so documents with COEP set can embed third-party documents that do not. See IFrame credentialless for a deeper explanation.
  • {{domxref("HTMLIFrameElement.csp")}} {{Experimental_Inline}}
  • : Specifies the Content Security Policy that an embedded document must agree to enforce upon itself.
  • {{domxref("HTMLIFrameElement.featurePolicy")}} {{ReadOnlyInline}} {{Experimental_Inline}} {{non-standard_inline}}
  • : Returns the {{domxref("FeaturePolicy")}} interface which provides a simple API for introspecting the Permissions Policies applied to a specific document.
  • {{domxref("HTMLIFrameElement.frameBorder")}} {{Deprecated_Inline}}
  • : A string that indicates whether to create borders between frames.
  • {{domxref("HTMLIFrameElement.height")}}
  • : A string that reflects the [height](/en-US/docs/Web/HTML/Reference/Elements/iframe#height) HTML attribute, indicating the height of the frame.
  • {{domxref("HTMLIFrameElement.loading")}}
  • : A string providing a hint to the browser that the iframe should be loaded immediately (eager) or on an as-needed basis (lazy).

This reflects the [loading](/en-US/docs/Web/HTML/Reference/Elements/iframe#loading) HTML attribute.

  • {{domxref("HTMLIFrameElement.longDesc")}} {{Deprecated_Inline}}
  • : A string that contains the URI of a long description of the frame.
  • {{domxref("HTMLIFrameElement.marginHeight")}} {{Deprecated_Inline}}
  • : A string being the height of the frame margin.
  • {{domxref("HTMLIFrameElement.marginWidth")}} {{Deprecated_Inline}}
  • : A string being the width of the frame margin.
  • {{domxref("HTMLIFrameElement.name")}}
  • : A string that reflects the [name](/en-US/docs/Web/HTML/Reference/Elements/iframe#name) HTML attribute, containing a name by which to refer to the frame.
  • {{domxref("HTMLIFrameElement.privateToken")}} {{experimental_inline}}
  • : A string representation of an options object representing a private state token operation; this object has the same structure as the RequestInit dictionary's [privateToken](/en-US/docs/Web/API/RequestInit#privatetoken) property. Mirrors the content of the associated <iframe> element's [privateToken](/en-US/docs/Web/HTML/Reference/Elements/iframe#privatetoken) attribute.
  • {{domxref("HTMLIFrameElement.referrerPolicy")}}
  • : A string that reflects the [referrerPolicy](/en-US/docs/Web/HTML/Reference/Elements/iframe#referrerpolicy) HTML attribute indicating which referrer to use when fetching the linked resource.
  • {{domxref("HTMLIFrameElement.sandbox")}} {{ReadOnlyInline}}
  • : Returns a {{domxref("DOMTokenList")}} that reflects the [sandbox](/en-US/docs/Web/HTML/Reference/Elements/iframe#sandbox) HTML attribute, indicating extra restrictions on the behavior of the nested content.
  • {{domxref("HTMLIFrameElement.scrolling")}} {{Deprecated_Inline}}
  • : A string that indicates whether the browser should provide scrollbars for the frame.
  • {{domxref("HTMLIFrameElement.src")}}
  • : A string that reflects the [src](/en-US/docs/Web/HTML/Reference/Elements/iframe#src) HTML attribute, containing the address of the content to be embedded. Note that programmatically removing an <iframe>'s src attribute (e.g., via {{domxref("Element.removeAttribute()")}}) causes about:blank to be loaded in the frame in Firefox (from version 65), Chromium-based browsers, and Safari/iOS.
  • {{domxref("HTMLIFrameElement.srcdoc")}}
  • : A {{domxref("TrustedHTML")}} or string that represents the HTML document loaded into the frame.
  • {{domxref("HTMLIFrameElement.width")}}
  • : A string that reflects the [width](/en-US/docs/Web/HTML/Reference/Elements/iframe#width) HTML attribute, indicating the width of the frame.

Instance methods

_Also inherits methods from its parent interface, {{domxref("HTMLElement")}}._

  • {{domxref("HTMLIFrameElement.getSVGDocument()")}}
  • : Returns the embedded SVG as a {{domxref("Document")}}.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • The HTML element implementing this interface: {{HTMLElement("iframe")}}