HTMLIFrameElement

Baseline 廣泛可用 *

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

* 此特性的某些部分可能存在不同級別的支援。

HTMLIFrameElement 介面提供了用於操作內嵌框架(inline frame)元素的佈局和顯示的特殊屬性和方法(除了透過繼承獲得的 HTMLElement 介面的屬性和方法)。

EventTarget Node Element HTMLElement HTMLIFrameElement

例項屬性

繼承其父級 HTMLElement 的屬性。.

HTMLIFrameElement.align 已棄用

一個字串,指定框架相對於周圍上下文的對齊方式。

HTMLIFrameElement.allow

一個字串,指示為該 <iframe> 指定的 許可權策略(Permissions Policy)

HTMLIFrameElement.allowFullscreen

一個布林值,指示內嵌框架是否願意進入全屏模式。有關詳細資訊,請參閱 使用全屏模式

HTMLIFrameElement.allowPaymentRequest 已棄用 非標準

一個布林值,指示是否允許在跨域 iframe 中呼叫 Payment Request API

HTMLIFrameElement.browsingTopics 實驗性 非標準

一個布林屬性,指定應將當前使用者的選定主題與相關 <iframe> 源的請求一起傳送。這反映了 browsingtopics 內容屬性的值。

HTMLIFrameElement.contentDocument 只讀

返回一個 Document 物件,即內嵌框架巢狀瀏覽上下文中的活動文件。

HTMLIFrameElement.contentWindow 只讀

返回一個 WindowProxy 物件,即巢狀瀏覽上下文的視窗代理。

HTMLIFrameElement.credentialless 實驗性

一個布林值,指示 <iframe> 是否為無憑證模式(credentialless),意味著其內容在一個新的、臨時的上下文中載入。此上下文無法訪問父上下文的共享儲存和憑證。作為回報,可以解除 Cross-Origin-Embedder-Policy (COEP) 嵌入規則,因此設定了 COEP 的文件可以嵌入未設定 COEP 的第三方文件。有關更深入的解釋,請參閱 IFrame credentialless

HTMLIFrameElement.csp 實驗性

指定一個內容安全策略(Content Security Policy),嵌入的文件必須同意強制執行該策略。

HTMLIFrameElement.featurePolicy 只讀 實驗性

返回 FeaturePolicy 介面,該介面提供了一個簡單的 API 來檢查應用於特定文件的 許可權策略(Permissions Policies)

HTMLIFrameElement.frameBorder 已棄用

一個字串,指示是否在框架之間建立邊框。

HTMLIFrameElement.height

一個字串,反映了 height HTML 屬性,表示框架的高度。

HTMLIFrameElement.loading

一個字串,為瀏覽器提供提示,說明 iframe 應立即載入(eager)還是按需載入(lazy)。這反映了 loading HTML 屬性。

HTMLIFrameElement.longDesc 已棄用

一個字串,包含框架長描述的 URI。

HTMLIFrameElement.marginHeight 已棄用

一個字串,表示框架邊距的高度。

HTMLIFrameElement.marginWidth 已棄用

一個字串,表示框架邊距的寬度。

HTMLIFrameElement.name

一個字串,反映了 name HTML 屬性,其中包含用於引用框架的名稱。

HTMLIFrameElement.referrerPolicy

一個字串,反映了 referrerPolicy HTML 屬性,指示在獲取連結資源時應使用的引用者(referrer)策略。

HTMLIFrameElement.sandbox 只讀

返回一個 DOMTokenList 物件,該物件反映了 sandbox HTML 屬性,指示對巢狀內容的行為施加的額外限制。

HTMLIFrameElement.scrolling 已棄用

一個字串,指示瀏覽器是否應為框架提供捲軸。

HTMLIFrameElement.src

一個字串,反映了 src HTML 屬性,其中包含要嵌入的內容的地址。請注意,在 Firefox(從 65 版開始)、基於 Chromium 的瀏覽器以及 Safari/iOS 中,透過程式設計方式移除 <iframe> 的 src 屬性(例如使用 Element.removeAttribute())會導致在框架中載入 about:blank

HTMLIFrameElement.srcdoc

一個 TrustedHTML 物件或字串,表示載入到框架中的 HTML 文件。

HTMLIFrameElement.width

一個字串,反映了 width HTML 屬性,表示框架的寬度。

例項方法

它還繼承了其父介面 HTMLElement 的方法。

HTMLIFrameElement.getSVGDocument()

Document 物件形式返回嵌入的 SVG。

規範

規範
HTML
# htmliframeelement

瀏覽器相容性

另見

  • 實現此介面的 HTML 元素:<iframe>