Document: pictureInPictureEnabled 属性

有限可用性

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

Document 接口的只读属性 pictureInPictureEnabled 指示是否启用了画中画模式。

默认情况下启用画中画模式,除非通过 Permissions-Policy 指定。

虽然此属性是只读的,但即使在严格模式下修改它也不会抛出错误;设置器是一个空操作,会被忽略。

一个布尔值,如果视频可以通过调用 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");
  }
}

规范

规范
画中画
# ref-for-dom-document-pictureinpictureenabled

浏览器兼容性

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

另请参见