此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

DocumentPictureInPictureEvent

有限可用

此特性不属于基线,因为它尚未在主流浏览器中得到支持。

实验性: 这是一项实验性技术
在将其用于生产之前,请仔细检查浏览器兼容性表格

安全上下文: 此特性仅在一些支持的浏览器安全上下文(HTTPS)中可用。

DocumentPictureInPictureEvent 接口是 Document Picture-in-Picture APIenter 事件(会在画中画窗口打开时触发)的对象。

Event DocumentPictureInPictureEvent

构造函数

DocumentPictureInPictureEvent()

创建一个新的 DocumentPictureInPictureEvent 对象实例。

实例属性

继承其父接口 Event 的属性。

window 只读

返回一个 Window 实例,表示触发事件的 DocumentPictureInPicture 窗口的浏览上下文。

实例方法

继承其父接口 Event 的方法。

示例

js
documentPictureInPicture.addEventListener("enter", (event) => {
  const pipWindow = event.window;
  console.log("视频播放器已进入画中画窗口");

  const pipMuteButton = pipWindow.document.createElement("button");
  pipMuteButton.textContent = "静音";
  pipMuteButton.addEventListener("click", () => {
    const pipVideo = pipWindow.document.querySelector("#video");
    if (!pipVideo.muted) {
      pipVideo.muted = true;
      pipMuteButton.textContent = "取消静音";
    } else {
      pipVideo.muted = false;
      pipMuteButton.textContent = "静音";
    }
  });

  pipWindow.document.body.append(pipMuteButton);
});

规范

规范
Document Picture-in-Picture Specification
# documentpictureinpictureevent

浏览器兼容性

参见