文档: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

浏览器兼容性

另见