文件:fullscreenEnabled 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

Document 介面上的只讀 fullscreenEnabled 屬性指示是否可用全屏模式。

僅當一個頁面在其任何文件中都沒有視窗化外掛,並且包含該文件的所有 <iframe> 元素都設定了 allowfullscreen 屬性時,全屏模式才可用。

儘管此屬性是隻讀的,但如果對其進行修改(即使在嚴格模式下),它也不會丟擲錯誤;setter 是一個無操作,它將被忽略。

一個布林值,如果文件和其中的元素可以透過呼叫 Element.requestFullscreen() 進入全屏模式,則為 true。如果全屏模式不可用,則此值為 false

示例

在此示例中,在嘗試為 <video> 元素請求全屏模式之前,會檢查 fullscreenEnabled 的值,以避免在不可用時進行嘗試。

js
function requestFullscreen() {
  if (document.fullscreenEnabled) {
    videoElement.requestFullscreen();
  } else {
    console.log("Your browser cannot use fullscreen right now");
  }
}

規範

規範
Fullscreen API
# ref-for-dom-document-fullscreenenabled①

瀏覽器相容性

另見