文档:exitPictureInPicture() 方法
**Document
接口的** exitPictureInPicture()
**方法请求退出当前文档中处于浮动状态的视频的画中画模式,恢复屏幕之前的状态。这通常会撤销之前对** HTMLVideoElement.requestPictureInPicture()
**的调用产生的效果。
语法
js
exitPictureInPicture()
参数
无。
返回值
异常
InvalidStateError
DOMException
-
如果
document.pictureInPictureElement
为null
,则抛出此异常。
示例
此示例会在每次在文档中单击鼠标按钮时使当前文档退出画中画模式。
js
document.onclick = (event) => {
if (document.pictureInPictureElement) {
document
.exitPictureInPicture()
.then(() => console.log("Document Exited from Picture-in-Picture mode"))
.catch((err) => console.error(err));
} else {
video.requestPictureInPicture();
}
};
请注意,如果您想跟踪页面上哪个视频当前正在画中画模式下播放,则应侦听相关 HTMLVideoElement
元素上的 enterpictureinpicture
和 exitpictureinpicture
事件。或者,您可以检查 Document.pictureInPictureElement
是否引用当前的 HTMLVideoElement
元素。
规范
规范 |
---|
画中画 # ref-for-dom-document-exitpictureinpicture |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。