[zh-CN]: Update translation for HTMLMediaElement

mdn · Sep 20, 2024 · 15a6d53 · 15a6d53
1 parent 4fc76f0
commit 15a6d53
Show file tree

Hide file tree

Showing 4 changed files with 100 additions and 110 deletions.
diff --git a/files/zh-cn/web/api/htmlmediaelement/abort_event/index.md b/files/zh-cn/web/api/htmlmediaelement/abort_event/index.md
@@ -1,40 +1,35 @@
 ---
-title: "HTMLMediaElement: abort event"
+title: HTMLMediaElement：abort 事件
 slug: Web/API/HTMLMediaElement/abort_event
+l10n:
+  sourceCommit: 595cba0e07c70eda7f08a12890e00ea0281933d3
 ---
 
 {{APIRef}}
 
 资源没有被完全加载时就会触发 **`abort`** 事件，但错误不会触发该事件。
 
-<table class="properties">
-  <tbody>
-    <tr>
-      <th scope="row">Bubbles</th>
-      <td>No</td>
-    </tr>
-    <tr>
-      <th scope="row">Cancelable</th>
-      <td>No</td>
-    </tr>
-    <tr>
-      <th scope="row">Interface</th>
-      <td>{{domxref("Event")}}</td>
-    </tr>
-    <tr>
-      <th scope="row">Event handler property</th>
-      <td>
-        {{domxref("GlobalEventHandlers/onabort", "onabort")}}
-      </td>
-    </tr>
-  </tbody>
-</table>
+此事件无法被取消也不会冒泡。
+
+## 语法
+
+在类似 {{domxref("EventTarget.addEventListener", "addEventListener()")}} 的方法中使用此事件名，或者设置一个事件处理器属性。
+
+```js
+addEventListener("abort", (event) => {});
+
+onabort = (event) => {};
+```
+
+## 事件类型
+
+一个通用型 {{domxref("Event")}} 。
 
 ## 示例
 
 ```js
 const video = document.querySelector("video");
-const videoSrc = "https://path/to/video.webm";
+const videoSrc = "https://example.org/path/to/video.webm";
 
 video.addEventListener("abort", () => {
   console.log(`Abort loading: ${videoSrc}`);
@@ -55,9 +50,9 @@ video.appendChild(source);
 
 {{Compat}}
 
-## 参阅
+## 参见
 
 - {{domxref("HTMLAudioElement")}}
 - {{domxref("HTMLVideoElement")}}
 - {{HTMLElement("audio")}}
-- {{HTMLElement("video")}}
+- {{HTMLElement("video")}}
diff --git a/files/zh-cn/web/api/htmlmediaelement/audiotracks/index.md b/files/zh-cn/web/api/htmlmediaelement/audiotracks/index.md
@@ -1,35 +1,46 @@
 ---
-title: HTMLMediaElement.audioTracks
+title: HTMLMediaElement： audioTracks 属性
 slug: Web/API/HTMLMediaElement/audioTracks
+l10n:
+  sourceCommit: 595cba0e07c70eda7f08a12890e00ea0281933d3
 ---
 
 {{APIRef("HTML DOM")}}
 
-**`HTMLMediaElement.audioTracks`** 获得可用音频轨道的数量
+{{domxref("HTMLMediaElement")}} 对象的只读属性 **`audioTracks`** 返回一个 {{domxref("AudioTrackList")}} 对象。该对象列出了所有表示媒体元素音频轨道的 {{domxref("AudioTrack")}} 对象。
 
-## 语法
+媒体元素可能是一个 {{HTMLElement("audio")}} 元素或一个 {{HTMLElement("video")}} 元素。
 
-```plain
-audio|video.audioTracks
-```
+所返回的列表是 _活的_；这指的是，当音频轨道从媒体元素上增加或删除时，列表的内容将会动态的变化。一旦你引用了该列表，你可以监控它以检测何时有新的音轨被添加或已存在的音轨被删除。参阅 [AudioTrackList events](/zh-CN/docs/Web/API/AudioTrackList#events) 来学习更多关于获取一个媒体元素音轨列表变化的信息。
 
 ## 返回值
 
-AudioTrackList 对象 表示音频/视频的可用音频轨道
+一个 {{domxref("AudioTrackList")}} 对象。该对象表示了一个媒体元素中所包含的音频轨道的列表。音轨列表可以使用数组表示法或对象的 {{domxref("AudioTrackList.getTrackById", "getTrackById()")}} 方法访问。
+
+每一个音轨都是由一个提供音轨信息的 {{domxref("AudioTrack")}} 对象表示的。
+
+## 示例
 
-## 用例
+在这个示例中，给定元素的所有的音频轨道都是被静音的。
 
-以 audio 标签为例
+### HTML
+
+使用 HTML 构建元素本身。
 
 ```html
-<audio id="audio"></audio>
+<video id="video" src="somevideo.mp4"></video>
 ```
 
-调用
+### JavaScript
+
+这段 JavaScript 代码负责静音视频元素的音轨。
+
+```js
+const video = document.getElementById("video");
 
-```plain
-myVid=document.getElementById("audio");
-alert(myVid.audioTracks.length);
+for (let i = 0; i < video.audioTracks.length; i += 1) {
+  video.audioTracks[i].enabled = false;
+}
 ```
 
 ## 规范
@@ -42,4 +53,6 @@ alert(myVid.audioTracks.length);
 
 ## 参见
 
-- 定义它的接口，{{domxref("HTMLMediaElement")}}。
+- {{domxref("HTMLMediaElement")}}: 用于指定 `HTMLMediaElement.audioTracks` 属性的接口
+- {{HTMLElement("audio")}}, {{HTMLElement("video")}}
+- {{domxref("AudioTrack")}}, {{domxref("AudioTrackList")}}
diff --git a/files/zh-cn/web/api/htmlmediaelement/buffered/index.md b/files/zh-cn/web/api/htmlmediaelement/buffered/index.md
@@ -1,24 +1,17 @@
 ---
-title: HTMLMediaElement.buffered
+title: HTMLMediaElement：buffered 属性
 slug: Web/API/HTMLMediaElement/buffered
+l10n:
+  sourceCommit: 2b554506d84d016d3ddf612c593bd8315833c64d
 ---
 
 {{APIRef("HTML DOM")}}
 
-**`HTMLMediaElement.buffered`** 返回一个只读 {{domxref("TimeRanges")}} 对象 返回媒体已缓冲的区域
+{{domxref("HTMLMediaElement")}} 对象的只读属性 **`buffered`** 返回一个新的静态[规范化 `TimeRanges` 对象](/zh-CN/docs/Web/API/TimeRanges#normalized_timeranges_objects)。该对象表示用户代理在访问`buffered`属性时已缓冲的媒体资源（如果有）的范围。
 
-> [!NOTE]
-> This feature is not available in [Web Workers](/zh-CN/docs/Web/API/Web_Workers_API).
+## 返回值
 
-## 值
-
-对象{{domxref("TimeRanges")}}
-
-length - 获得音频/视频中已缓冲范围的数量
-
-buffered.start 开始的区域
-
-buffered.end 结束的区域
+一个新的静态[规范化 `TimeRanges` 对象](/zh-CN/docs/Web/API/TimeRanges#normalized_timeranges_objects)。该对象表示用户代理在访问`buffered`属性时已缓冲的媒体资源（如果有）的范围。
 
 ## 示例
 
@@ -37,4 +30,4 @@ console.log(obj.buffered); // TimeRanges { length: 0 }
 
 ## 参见
 
-- The interface defining it, {{domxref("HTMLMediaElement")}}.
+- {{domxref("HTMLMediaElement")}}: 用于指定 `HTMLMediaElement.buffered` 属性的接口
diff --git a/files/zh-cn/web/api/htmlmediaelement/canplay_event/index.md b/files/zh-cn/web/api/htmlmediaelement/canplay_event/index.md
@@ -1,62 +1,51 @@
 ---
-title: "HTMLMediaElement: canplay"
+title: HTMLMediaElement：canplay 事件
 slug: Web/API/HTMLMediaElement/canplay_event
+l10n:
+  sourceCommit: 595cba0e07c70eda7f08a12890e00ea0281933d3
 ---
 
 {{APIRef("HTMLMediaElement")}}
 
-`canplay` 事件在终端可以播放媒体文件时（但估计还没有加载足够的数据来播放媒体直到其结束，即后续可能需要停止以进一步缓冲内容）被触发。
-
-<table class="properties">
-  <tbody>
-    <tr>
-      <th scope="row">是否冒泡</th>
-      <td>否</td>
-    </tr>
-    <tr>
-      <th scope="row">是否可取消</th>
-      <td>否</td>
-    </tr>
-    <tr>
-      <th scope="row">接口</th>
-      <td>{{DOMxRef("Event")}}</td>
-    </tr>
-    <tr>
-      <th scope="row">目标</th>
-      <td>元素</td>
-    </tr>
-    <tr>
-      <th scope="row">默认行为</th>
-      <td>无</td>
-    </tr>
-    <tr>
-      <th scope="row">事件处理器属性</th>
-      <td>{{domxref("GlobalEventHandlers.oncanplay")}}</td>
-    </tr>
-  </tbody>
-</table>
+当用户代理可以播放媒体时就会触发 **`canplay`** 事件，但是预计没有加载足够的数据以流畅的播放媒体至结束，可能需要停顿来缓存更多内容。
+
+此事件无法被取消也不会冒泡。
+
+## 语法
+
+在类似 {{domxref("EventTarget.addEventListener", "addEventListener()")}} 的方法中使用事件名，或者设置一个事件处理器属性。
+
+```js
+addEventListener("canplay", (event) => {});
+
+oncanplay = (event) => {};
+```
+
+## 事件类型
+
+一个通用型 {{domxref("Event")}} 。
 
 ## 示例
 
-以下示例展示了如何为媒体元素的 `canplay` 事件添加一个事件监听器，以在该事件触发时发送一条消息。
+这些示例为 HTMLMediaElement 的 `canplay` 事件添加了一个事件监听器。事件处理器会在事件被触发时发送一条信息。
 
-使用 `addEventListener()`：
+使用 `addEventListener()`:
 
 ```js
 const video = document.querySelector("video");
 
 video.addEventListener("canplay", (event) => {
-  console.log("Video can start, but not sure it will play through.");
+  console.log("视频可以开始播放，但是不一定能够完整地播放。");
 });
 ```
 
-使用 `oncanplay` 事件处理器属性：
+使用`oncanplay`事件处理器属性:
 
 ```js
 const video = document.querySelector("video");
 
 video.oncanplay = (event) => {
-  console.log("Video can start, but not sure it will play through.");
+  console.log("视频可以开始播放，但是不一定能够完整地播放。");
 };
 ```
 
@@ -70,28 +59,28 @@ video.oncanplay = (event) => {
 
 ## 相关事件
 
-- 媒体元素 {{domxref("HTMLMediaElement.playing_event", 'playing')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.waiting_event", 'waiting')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.seeking_event", 'seeking')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.seeked_event", 'seeked')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.ended_event", 'ended')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.loadedmetadata_event", 'loadedmetadata')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.loadeddata_event", 'loadeddata')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.canplay_event", 'canplay')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.canplaythrough_event", 'canplaythrough')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.durationchange_event", 'durationchange')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.timeupdate_event", 'timeupdate')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.play_event", 'play')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.pause_event", 'pause')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.ratechange_event", 'ratechange')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.volumechange_event", 'volumechange')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.suspend_event", 'suspend')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.emptied_event", 'emptied')}} 事件
-- 媒体元素 {{domxref("HTMLMediaElement.stalled_event", 'stalled')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.playing_event", 'playing')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.waiting_event", 'waiting')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.seeking_event", 'seeking')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.seeked_event", 'seeked')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.ended_event", 'ended')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.loadedmetadata_event", 'loadedmetadata')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.loadeddata_event", 'loadeddata')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.canplay_event", 'canplay')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.canplaythrough_event", 'canplaythrough')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.durationchange_event", 'durationchange')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.timeupdate_event", 'timeupdate')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.play_event", 'play')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.pause_event", 'pause')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.ratechange_event", 'ratechange')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.volumechange_event", 'volumechange')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.suspend_event", 'suspend')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.emptied_event", 'emptied')}} 事件
+- HTMLMediaElement {{domxref("HTMLMediaElement.stalled_event", 'stalled')}} 事件
 
 ## 参见
 
 - {{domxref("HTMLAudioElement")}}
 - {{domxref("HTMLVideoElement")}}
 - {{HTMLElement("audio")}}
-- {{HTMLElement("video")}}
+- {{HTMLElement("video")}}