From fb2b77d01faa1f695993c2d23b226d3c395980ac Mon Sep 17 00:00:00 2001
From: Tianyi Tao <tianyi.tao@proton.me>
Date: Thu, 19 Sep 2024 08:39:38 +0800
Subject: [PATCH] [zh-cn]: create the translation of `documentpipevent`
 constructor

---
 .../documentpictureinpictureevent/index.md    | 64 +++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 files/zh-cn/web/api/documentpictureinpictureevent/documentpictureinpictureevent/index.md

diff --git a/files/zh-cn/web/api/documentpictureinpictureevent/documentpictureinpictureevent/index.md b/files/zh-cn/web/api/documentpictureinpictureevent/documentpictureinpictureevent/index.md
new file mode 100644
index 00000000000000..d2a24bf381632c
--- /dev/null
+++ b/files/zh-cn/web/api/documentpictureinpictureevent/documentpictureinpictureevent/index.md
@@ -0,0 +1,64 @@
+---
+title: DocumentPictureInPictureEvent：DocumentPictureInPictureEvent() 构造函数
+slug: Web/API/DocumentPictureInPictureEvent/DocumentPictureInPictureEvent
+l10n:
+  sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e
+---
+
+{{APIRef("Document Picture-in-Picture API")}}{{SeeCompatTable}}{{SecureContext_Header}}
+
+**`DocumentPictureInPictureEvent()`** 构造函数创建一个新的 {{domxref("DocumentPictureInPictureEvent")}} 对象实例。
+
+## 语法
+
+```js-nolint
+new DocumentPictureInPictureEvent(type, init)
+```
+
+### 参数
+
+- `type`
+  - : 一个表示事件类型的字符串。在 `DocumentPictureInPictureEvent` 的情况下，这始终是 `enter`。
+- `init`
+  - : 一个包含以下属性的对象：
+    - `window`
+      - : 一个 {{domxref("Window")}} 实例，表示事件触发时的 `DocumentPictureInPicture` 窗口中的浏览上下文。
+
+## 示例
+
+开发者通常不会手动使用此构造函数。当 {{domxref("DocumentPictureInPicture.enter_event", "enter")}} 事件触发时，会自动构造一个新的 `DocumentPictureInPictureEvent` 对象。
+
+```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);
+});
+```
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{domxref("Document Picture-in-Picture API", "Document Picture-in-Picture API", "", "nocode")}}
+- [使用 Document Picture-in-Picture API](/zh-CN/docs/Web/API/Document_Picture-in-Picture_API/Using)