文件:pictureInPictureEnabled 屬性

可用性有限

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

Document 介面的只讀 pictureInPictureEnabled 屬性指示畫中畫模式是否可用。

預設情況下,畫中畫模式可用,除非被 Permissions-Policy 另行指定。

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

一個布林值,如果透過呼叫 HTMLVideoElement.requestPictureInPicture() 可以使影片進入畫中畫模式並在浮動視窗中顯示,則該值為 true。如果畫中畫模式不可用,則該值為 false

示例

在此示例中,在嘗試為 <video> 元素進入畫中畫模式之前,會檢查 pictureInPictureEnabled 的值,以避免在功能不可用時呼叫。

js
function requestPictureInPicture() {
  if (document.pictureInPictureEnabled) {
    videoElement.requestPictureInPicture();
  } else {
    console.log("Your browser cannot use picture-in-picture right now");
  }
}

規範

規範
畫中畫
# dom-document-pictureinpictureenabled

瀏覽器相容性

另見