Document: pictureInPictureElement 属性

有限可用性

此功能并非基线功能，因为它在一些最广泛使用的浏览器中无法正常工作。

Document 接口的只读pictureInPictureElement 属性返回当前在此文档中以画中画模式呈现的Element，如果当前未使用画中画模式，则返回null。

尽管此属性为只读，但如果修改它不会抛出错误（即使在严格模式下）；设置器为无操作，将被忽略。

值

对当前处于画中画模式的Element 对象的引用。

如果文档在画中画模式下没有关联的元素，则返回null。例如，没有画中画元素，或者该元素来自 iframe。

示例

此示例演示了一个函数 exitPictureInPicture()，它测试 pictureInPictureElement 返回的值。如果文档处于画中画模式（pictureInPictureElement 不为 null），则运行Document.exitPictureInPicture() 以退出画中画模式。

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

规范

规范
画中画
# ref-for-dom-documentorshadowroot-pictureinpictureelement①⑤

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅