HTMLIFrameElement

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

特性

Inherits properties from its parent, HTMLElement .

HTMLIFrameElement.align
DOMString that specifies the alignment of the frame with respect to the surrounding context.
HTMLIFrameElement.allow
Is a list of origins the the frame is allowed to display content from. This attribute also accepts the values self and src which represent the origin in the iframe's src attribute. The default value is src .
HTMLIFrameElement.allowfullscreen
Boolean indicating whether the inline frame is willing to be placed into full screen mode. See 使用全屏模式 了解细节。
HTMLIFrameElement.allowPaymentRequest
Boolean indicating whether the 支付请求 API may be invoked inside a cross-origin iframe.
HTMLIFrameElement.contentDocument 只读
返回 Document , the active document in the inline frame's nested browsing context.
HTMLIFrameElement.contentWindow 只读
返回 WindowProxy , the window proxy for the nested browsing context.
HTMLIFrameElement.csp
Specifies the Content Security Policy that an embedded document must agree to enforce upon itself.
HTMLIFrameElement.frameBorder
DOMString that indicates whether to create borders between frames.
HTMLIFrameElement.height
DOMString that reflects the height HTML attribute, indicating the height of the frame.
HTMLIFrameElement.longDesc
DOMString that contains the URI of a long description of the frame.
HTMLIFrameElement.marginHeight
DOMString being the height of the frame margin.
HTMLIFrameElement.marginWidth
DOMString being the width of the frame margin.
HTMLIFrameElement.name
DOMString that reflects the name HTML attribute, containing a name by which to refer to the frame.
HTMLIFrameElement.featurePolicy 只读
返回 FeaturePolicy interface which provides a simple API for introspecting the feature policies applied to a specific document.
HTMLIFrameElement.referrerPolicy
DOMString that reflects the referrerpolicy HTML attribute indicating which referrer to use when fetching the linked resource.
HTMLIFrameElement.sandbox
DOMSettableTokenList that reflects the sandbox HTML attribute, indicating extra restrictions on the behavior of the nested content.
HTMLIFrameElement.scrolling
DOMString that indicates whether the browser should provide scrollbars for the frame.
HTMLIFrameElement.src
DOMString that reflects the src HTML attribute, containing the address of the content to be embedded. Note that programatically removing an <iframe> 's src attribute (e.g. via Element.removeAttribute() ) causes about:blank to be loaded in the frame in Firefox (from version 65), Chromium-based browsers, and Safari/iOS.
HTMLIFrameElement.srcdoc
DOMString that represents the content to display in the frame.
HTMLIFrameElement.width
DOMString that reflects the width HTML attribute, indicating the width of the frame.

方法

Inherits properties from its parent, HTMLElement .

      规范

      规范 状态 Comment
      HTML Living Standard
      The definition of 'HTMLIFrameElement' in that specification.
      实时标准 The following property has been added: allowFullscreen .
      HTML5
      The definition of 'HTMLIFrameElement' in that specification.
      Recommendation The following properties are now obsolete: scrolling , marginWidth , marginHeight , longDesc , frameBorder ,和 align .
      The following properties have been added: srcdoc , sandbox ,和 contentWindow .
      Document Object Model (DOM) Level 2 HTML Specification
      The definition of 'HTMLIFrameElement' in that specification.
      Obsolete contentDocument property has been added.
      Document Object Model (DOM) Level 1 Specification
      The definition of 'HTMLIFrameElement' in that specification.
      Obsolete 初始定义。

      浏览器兼容性

      更新 GitHub 上的兼容性数据
      Desktop Mobile
      Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
      HTMLIFrameElement Chrome Yes Edge 12 Firefox 1 IE Yes Opera Yes Safari Yes WebView Android Yes Chrome Android Yes Firefox Android 4 Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
      align
      弃用
      Chrome 43 Edge 12 Firefox Yes IE ? Opera Yes Safari 6 WebView Android Yes Chrome Android Yes Firefox Android Yes Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
      allow Chrome 60 Edge ≤79 Firefox 74 IE ? Opera 53 Safari Yes WebView Android 66 Chrome Android 66 Firefox Android 不支持 No Opera Android 47 Safari iOS Yes Samsung Internet Android 9.0
      allowFullscreen Chrome 38 Edge ≤18 Firefox 22
      22
      9 — 18
      Alternate Name
      Alternate Name Uses the non-standard name: mozAllowFullScreen
      IE 不支持 No Opera 25 Safari 10 WebView Android 38 Chrome Android 38 Firefox Android 22
      22
      9 — 18
      Alternate Name
      Alternate Name Uses the non-standard name: mozAllowFullScreen
      Opera Android 25 Safari iOS 10 Samsung Internet Android 3.0
      allowPaymentRequest
      Chrome 60
      Disabled
      60
      Disabled
      Disabled From version 60: this feature is behind the #web-payments preference (needs to be set to Enabled ). To change preferences in Chrome, visit chrome://flags.
      Edge 15 Firefox 56 IE ? Opera 不支持 No Safari ? WebView Android 不支持 No Chrome Android 61
      Disabled
      61
      Disabled
      Disabled From version 61: this feature is behind the #web-payments preference (needs to be set to Enabled ). To change preferences in Chrome, visit chrome://flags.
      Firefox Android Yes Opera Android 不支持 No Safari iOS ? Samsung Internet Android 不支持 No
      contentDocument Chrome 43 Edge 12 Firefox Yes IE 8 Opera Yes Safari 10 WebView Android Yes Chrome Android Yes Firefox Android 4 Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
      contentWindow Chrome 1 Edge 12 Firefox 1 IE 8 Opera 8 Safari 3 WebView Android 1 Chrome Android 18 Firefox Android 4 Opera Android 10.1 Safari iOS 1 Samsung Internet Android 1.0
      csp
      Chrome 61 Edge ≤79 Firefox ? IE ? Opera 48 Safari ? WebView Android 61 Chrome Android 61 Firefox Android ? Opera Android 45 Safari iOS ? Samsung Internet Android 8.0
      featurePolicy
      Chrome 74
      注意事项
      74
      注意事项
      Chrome Platform Status incorrectly describes this variable as document.policy . It was renamed in bug 917057 before being shipped in bug 703703 .
      73 — 74
      Disabled
      Disabled From version 73 until version 74 (exclusive): this feature is behind the #enable-experimental-productivity-features preference (needs to be set to Enabled ). To change preferences in Chrome, visit chrome://flags.
      69 — 73
      Alternate Name Disabled
      Alternate Name Uses the non-standard name: policy
      Disabled From version 69 until version 73 (exclusive): this feature is behind the #enable-experimental-productivity-features preference (needs to be set to Enabled ). To change preferences in Chrome, visit chrome://flags.
      Edge 79
      注意事项
      79
      注意事项
      Edge Platform Status incorrectly describes this variable as document.policy . It was renamed in bug 917057 before being shipped in bug 703703 .
      Firefox 69
      Disabled
      69
      Disabled
      Disabled From version 69: this feature is behind the dom.security.featurePolicy.webidl.enabled preference (needs to be set to true ). To change preferences in Firefox, visit about:config.
      65 — 69
      Alternate Name Disabled
      Alternate Name Uses the non-standard name: policy
      Disabled From version 65 until version 69 (exclusive): this feature is behind the dom.security.featurePolicy.webidl.enabled preference (needs to be set to true ). To change preferences in Firefox, visit about:config.
      IE 不支持 No Opera 62
      62
      60 — 62
      Disabled
      Disabled From version 60 until version 62 (exclusive): this feature is behind the #enable-experimental-productivity-features preference (needs to be set to Enabled ).
      56 — 60
      Alternate Name Disabled
      Alternate Name Uses the non-standard name: policy
      Disabled From version 56 until version 60 (exclusive): this feature is behind the #enable-experimental-productivity-features preference (needs to be set to Enabled ).
      Safari 不支持 No WebView Android 74
      注意事项
      74
      注意事项
      Chrome Platform Status incorrectly describes this variable as document.policy . It was renamed in bug 917057 before being shipped in bug 703703 .
      Chrome Android 74
      注意事项
      74
      注意事项
      Chrome Platform Status incorrectly describes this variable as document.policy . It was renamed in bug 917057 before being shipped in bug 703703 .
      73 — 74
      Disabled
      Disabled From version 73 until version 74 (exclusive): this feature is behind the #enable-experimental-productivity-features preference (needs to be set to Enabled ). To change preferences in Chrome, visit chrome://flags.
      69 — 73
      Alternate Name Disabled
      Alternate Name Uses the non-standard name: policy
      Disabled From version 69 until version 73 (exclusive): this feature is behind the #enable-experimental-productivity-features preference (needs to be set to Enabled ). To change preferences in Chrome, visit chrome://flags.
      Firefox Android 65
      Alternate Name Disabled
      65
      Alternate Name Disabled
      Alternate Name Uses the non-standard name: policy
      Disabled From version 65: this feature is behind the dom.security.featurePolicy.webidl.enabled preference (needs to be set to true ). To change preferences in Firefox, visit about:config.
      Opera Android 48
      Alternate Name Disabled
      48
      Alternate Name Disabled
      Alternate Name Uses the non-standard name: policy
      Disabled From version 48: this feature is behind the #enable-experimental-productivity-features preference (needs to be set to Enabled ).
      Safari iOS 不支持 No Samsung Internet Android 11.0
      frameBorder
      弃用
      Chrome 43 Edge 12 Firefox Yes IE ? Opera Yes Safari 6 WebView Android Yes Chrome Android Yes Firefox Android Yes Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
      height Chrome 43 Edge 12 Firefox Yes IE ? Opera Yes Safari 6 WebView Android Yes Chrome Android Yes Firefox Android Yes Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
      longDesc
      弃用
      Chrome 43 Edge 12 Firefox Yes IE ? Opera Yes Safari 6 WebView Android Yes Chrome Android Yes Firefox Android Yes Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
      marginHeight
      弃用
      Chrome 43 Edge 12 Firefox Yes IE ? Opera Yes Safari 6 WebView Android Yes Chrome Android Yes Firefox Android Yes Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
      marginWidth
      弃用
      Chrome 43 Edge 12 Firefox Yes IE ? Opera Yes Safari 6 WebView Android Yes Chrome Android Yes Firefox Android Yes Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
      name Chrome 43 Edge 12 Firefox Yes IE ? Opera Yes Safari 6 WebView Android Yes Chrome Android Yes Firefox Android Yes Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
      referrerPolicy Chrome 51 Edge 79 Firefox 50 IE 不支持 No Opera 38 Safari 11.1 WebView Android 51 Chrome Android 51 Firefox Android 50 Opera Android 41 Safari iOS 不支持 No Samsung Internet Android 5.0
      sandbox Chrome 43
      注意事项
      43
      注意事项
      Before Chrome 50, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList .
      Edge 12 Firefox 17
      注意事项
      17
      注意事项
      Previously, the type of sandbox was a DOMString instead of a DOMSettableTokenList . This has been fixed with Firefox 29. Other browsers may still implement the property as DOMString since it was a late change in the specification.
      IE ? Opera Yes
      注意事项
      Yes
      注意事项
      Before Opera 37, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList .
      Safari 6 WebView Android Yes
      注意事项
      Yes
      注意事项
      Before Chrome 50, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList .
      Chrome Android 18
      注意事项
      18
      注意事项
      Before Chrome 50, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList .
      Firefox Android 17
      注意事项
      17
      注意事项
      Previously, the type of sandbox was a DOMString instead of a DOMSettableTokenList . This has been fixed with Firefox 29. Other browsers may still implement the property as DOMString since it was a late change in the specification.
      Opera Android Yes
      注意事项
      Yes
      注意事项
      Before Opera 37, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList .
      Safari iOS Yes Samsung Internet Android 1.0
      注意事项
      1.0
      注意事项
      Before Samsung Internet 5.0, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList .
      scrolling
      弃用
      Chrome 43 Edge 12 Firefox Yes IE ? Opera Yes Safari 6 WebView Android Yes Chrome Android Yes Firefox Android Yes Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
      setNfcFocus
      非标
      Chrome 不支持 No Edge 不支持 No Firefox 不支持 No
      注意事项
      No
      注意事项
      Supported in chrome code only since Firefox version 47.
      IE 不支持 No Opera 不支持 No Safari 不支持 No WebView Android 不支持 No Chrome Android 不支持 No Firefox Android 不支持 No Opera Android 不支持 No Safari iOS 不支持 No Samsung Internet Android 不支持 No
      src Chrome 43 Edge 12 Firefox Yes IE ? Opera Yes Safari 6 WebView Android Yes Chrome Android Yes Firefox Android Yes Opera Android Yes Safari iOS Yes Samsung Internet Android Yes
      srcdoc Chrome 43 Edge 79 Firefox 25 IE 不支持 No Opera Yes Safari 6 WebView Android Yes Chrome Android 18 Firefox Android 25 Opera Android Yes Safari iOS Yes Samsung Internet Android 1.0
      width Chrome 43 Edge 12 Firefox Yes IE ? Opera Yes Safari 6 WebView Android Yes Chrome Android Yes Firefox Android Yes Opera Android Yes Safari iOS Yes Samsung Internet Android Yes

      图例

      完整支持
      完整支持
      不支持
      不支持
      兼容性未知
      兼容性未知
      实验。期望将来行为有所改变。
      实验。期望将来行为有所改变。
      非标。预期跨浏览器支持较差。
      弃用。不要用于新网站。
      弃用。不要用于新网站。
      见实现注意事项。
      用户必须明确启用此特征。
      用户必须明确启用此特征。
      使用非标名称。
      使用非标名称。

      另请参阅

      • The HTML element implementing this interface: <iframe>
      1. HTMLIFrameElement
      2. 特性
        1. allowPaymentRequest
        2. contentWindow
        3. csp
        4. featurePolicy
        5. referrerPolicy
      3. 方法
        1. setNfcFocus()
      4. 继承:
        1. HTMLElement
        2. Element
        3. Node
        4. EventTarget
      5. Related pages for HTML DOM
        1. BeforeUnloadEvent
        2. DOMStringMap
        3. ErrorEvent
        4. GlobalEventHandlers
        5. HTMLAnchorElement
        6. HTMLAreaElement
        7. HTMLAudioElement
        8. HTMLBRElement
        9. HTMLBaseElement
        10. HTMLBaseFontElement
        11. HTMLBodyElement
        12. HTMLButtonElement
        13. HTMLCanvasElement
        14. HTMLContentElement
        15. HTMLDListElement
        16. HTMLDataElement
        17. HTMLDataListElement
        18. HTMLDialogElement
        19. HTMLDivElement
        20. HTMLDocument
        21. HTMLElement
        22. HTMLEmbedElement
        23. HTMLFieldSetElement
        24. HTMLFormControlsCollection
        25. HTMLFormElement
        26. HTMLFrameSetElement
        27. HTMLHRElement
        28. HTMLHeadElement
        29. HTMLHeadingElement
        30. HTMLHtmlElement
        31. HTMLImageElement
        32. HTMLInputElement
        33. HTMLIsIndexElement
        34. HTMLKeygenElement
        35. HTMLLIElement
        36. HTMLLabelElement
        37. HTMLLegendElement
        38. HTMLLinkElement
        39. HTMLMapElement
        40. HTMLMediaElement
        41. HTMLMetaElement
        42. HTMLMeterElement
        43. HTMLModElement
        44. HTMLOListElement
        45. HTMLObjectElement
        46. HTMLOptGroupElement
        47. HTMLOptionElement
        48. HTMLOptionsCollection
        49. HTMLOutputElement
        50. HTMLParagraphElement
        51. HTMLParamElement
        52. HTMLPictureElement
        53. HTMLPreElement
        54. HTMLProgressElement
        55. HTMLQuoteElement
        56. HTMLScriptElement
        57. HTMLSelectElement
        58. HTMLShadowElement
        59. HTMLSourceElement
        60. HTMLSpanElement
        61. HTMLStyleElement
        62. HTMLTableCaptionElement
        63. HTMLTableCellElement
        64. HTMLTableColElement
        65. HTMLTableDataCellElement
        66. HTMLTableElement
        67. HTMLTableHeaderCellElement
        68. HTMLTableRowElement
        69. HTMLTableSectionElement
        70. HTMLTemplateElement
        71. HTMLTextAreaElement
        72. HTMLTimeElement
        73. HTMLTitleElement
        74. HTMLTrackElement
        75. HTMLUListElement
        76. HTMLUnknownElement
        77. HTMLVideoElement
        78. HashChangeEvent
        79. History
        80. ImageData
        81. Location
        82. MessageChannel
        83. MessageEvent
        84. MessagePort
        85. Navigator
        86. NavigatorGeolocation
        87. NavigatorID
        88. NavigatorLanguage
        89. NavigatorOnLine
        90. NavigatorPlugins
        91. PageTransitionEvent
        92. Plugin
        93. PluginArray
        94. PopStateEvent
        95. PortCollection
        96. PromiseRejectionEvent
        97. RadioNodeList
        98. Transferable
        99. ValidityState
        100. Window
        101. WindowBase64
        102. WindowEventHandlers
        103. WindowTimers