文件:pictureInPictureElement 屬性

可用性有限

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

Document 介面的只讀 pictureInPictureElement 屬性返回當前在此文件中以畫中畫模式顯示的 Element,如果當前未使用畫中畫模式,則返回 null

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

當前處於畫中畫模式的 Element 物件的引用。

如果文件沒有關聯的畫中畫元素,則返回 null。例如,沒有畫中畫元素,或者該元素來自 iframe。

示例

此示例提供了一個名為 exitPictureInPicture() 的函式,該函式測試 pictureInPictureElement 返回的值。如果文件處於畫中畫模式(pictureInPictureElement 不為 null),則執行 Document.exitPictureInPicture() 以退出畫中畫模式。

js
function exitPictureInPicture() {
  if (document.pictureInPictureElement) {
    document.exitPictureInPicture();
  }
}

規範

規範
畫中畫
# dom-documentorshadowroot-pictureinpictureelement

瀏覽器相容性

另見