文件:fullscreenElement 屬性

可用性有限

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

Document.fullscreenElement 只讀屬性返回當前在此文件中以全屏模式呈現的 Element,或者在當前未使用全屏模式時返回 null

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

當前處於全屏模式的 Element 物件;如果當前文件未使用全屏模式,則返回值為 null。如果存在多個全屏元素,則返回最頂層(最近請求的)元素。

示例

此示例展示了一個函式 isVideoInFullscreen(),該函式檢查 fullscreenElement 返回的值;如果文件處於全屏模式(fullscreenElement 不為 null)且全屏元素的 nodeNameVIDEO,表明這是一個 <video> 元素,則該函式返回 true,表示影片處於全屏模式。

js
function isVideoInFullscreen() {
  if (document.fullscreenElement?.nodeName === "VIDEO") {
    return true;
  }
  return false;
}

規範

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

瀏覽器相容性

另見