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 的浏览器中加载。