-
Notifications
You must be signed in to change notification settings - Fork 8k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[zh-cn]: update translation for HTMLMediaElement #23712
Changes from 3 commits
15a6d53
30ca87f
190b18c
e99a734
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
@@ -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")}} 。 | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 多了个空格,这里写“通用 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")}} | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. [mdn-linter] reported by reviewdog 🐶
Suggested change
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 少了末尾的空行 |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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) 来学习更多关于获取一个媒体元素音轨列表变化的信息。 | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 返回的列表是“动态的”,注意,中文之间不能有空格,这里可以用星号来表示斜体 |
||
|
||
## 返回值 | ||
|
||
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")}} | ||
IvanHanloth marked this conversation as resolved.
Show resolved
Hide resolved
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 注意标点符号 |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,62 +1,51 @@ | ||
--- | ||
title: "HTMLMediaElement: canplay" | ||
title: HTMLMediaElement:canplay 事件 | ||
slug: Web/API/HTMLMediaElement/canplay_event | ||
l10n: | ||
sourceCommit: 595cba0e07c70eda7f08a12890e00ea0281933d3 | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. hash 值不对,确定一下问题 |
||
--- | ||
|
||
{{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`** 事件,但是预计没有加载足够的数据以流畅的播放媒体至结束,可能需要停顿来缓存更多内容。 | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 我们对事件的第一段的描述格式是固定的,“xxx 事件会在 xxx 时触发”。 |
||
|
||
此事件无法被取消也不会冒泡。 | ||
|
||
## 语法 | ||
|
||
在类似 {{domxref("EventTarget.addEventListener", "addEventListener()")}} 的方法中使用事件名,或者设置一个事件处理器属性。 | ||
|
||
```js | ||
addEventListener("canplay", (event) => {}); | ||
|
||
oncanplay = (event) => {}; | ||
``` | ||
|
||
## 事件类型 | ||
|
||
一个通用型 {{domxref("Event")}} 。 | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 同第一个文档 |
||
|
||
## 示例 | ||
|
||
以下示例展示了如何为媒体元素的 `canplay` 事件添加一个事件监听器,以在该事件触发时发送一条消息。 | ||
这些示例为 HTMLMediaElement 的 `canplay` 事件添加了一个事件监听器。事件处理器会在事件被触发时发送一条信息。 | ||
|
||
使用 `addEventListener()`: | ||
使用 `addEventListener()`: | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 标点错了,原来是对的 |
||
|
||
```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`事件处理器属性: | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 空格应该保留 |
||
|
||
```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")}} | ||
IvanHanloth marked this conversation as resolved.
Show resolved
Hide resolved
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 最后必须保留一个空行 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
可省略最后的量词