Skip to content

Commit

Permalink
[zh-cn]: update cue
Browse files Browse the repository at this point in the history
  • Loading branch information
fuchunhui committed Aug 22, 2024
1 parent 7001457 commit 717bf8e
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 10 deletions.
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/htmltrackelement/cuechange_event/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ l10n:

{{APIRef("WebVTT")}}

**`cuechange`** 事件在 {{domxref("TextTrack")}} 更改当前显示提示时触发。此事件在 `TextTrack` 和显示它的 {{domxref("HTMLTrackElement")}}(如果有的话)上触发。
**`cuechange`** 事件在 {{domxref("TextTrack")}} 更改当前显示提示(cue)时触发。此事件在 `TextTrack` 和显示它的 {{domxref("HTMLTrackElement")}}(如果有的话)上触发。

## 语法

Expand All @@ -25,7 +25,7 @@ oncuechange = (event) => {};

## 示例

每当当前呈现的提示更改时,由 {{domxref("HTMLTrackElement.track", "track")}} 属性指示的底层 {{domxref("TextTrack")}} 会接收 `cuechange` 事件。即使轨道并未与媒体元素关联,也会发生。
每当当前呈现的 cue 更改时,由 {{domxref("HTMLTrackElement.track", "track")}} 属性指示的底层 {{domxref("TextTrack")}} 会接收 `cuechange` 事件。即使轨道并未与媒体元素关联,也会发生。

如果轨道和媒体元素**关联的,使用 {{HTMLElement("track")}} 元素作为 {{HTMLElement("audio")}} 或 {{HTMLElement("video")}} 的孩子,`cuechange` 事件也发送给 {{domxref("HTMLTrackElement")}}。

Expand Down
16 changes: 8 additions & 8 deletions files/zh-cn/web/api/htmltrackelement/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,12 +29,12 @@ _从其父接口 {{domxref("HTMLElement")}} 继承属性。_

- : 返回 `unsigned short` 显示轨道的准备状态:

| 常量 || 描述 |
| --------- | --- | ---------------------------------------------------------------------------------------------------- |
| `NONE` | 0 | 表示尚未获得文本轨道的提示 |
| `LOADING` | 1 | 表示正在加载文本轨道,到目前为止还没有遇到致命错误。解析器可能湘轨道中添加更多提示。 |
| `LOADED` | 2 | 表示已加载文本轨道,没有出现致命错误。 |
| `ERROR` | 3 | 表示文本轨道已启用,但当用户代理尝试获取它时,以某种方式失败了。部分或全部提示可能丢失,且无法获得。 |
| 常量 || 描述 |
| --------- | --- | ----------------------------------------------------------------------------------------------------- |
| `NONE` | 0 | 表示尚未获得文本轨道的提示(cue)。 |
| `LOADING` | 1 | 表示正在加载文本轨道,到目前为止还没有遇到致命错误。解析器可能湘轨道中添加更多 cue。 |
| `LOADED` | 2 | 表示已加载文本轨道,没有出现致命错误。 |
| `ERROR` | 3 | 表示文本轨道已启用,但当用户代理尝试获取它时,以某种方式失败了。部分或全部 cue 可能丢失,且无法获得。 |

- {{domxref("HTMLTrackElement.track")}} {{ReadOnlyInline}}
- : 返回 {{Domxref("TextTrack")}} 是轨道元素的文本轨道数据。
Expand All @@ -50,13 +50,13 @@ _从其父接口 {{domxref("HTMLElement")}} 继承事件。_
使用 {{domxref("EventTarget/addEventListener", "addEventListener()")}} 或为此接口的 `oneventname` 属性分配一个事件监听器来监听这些事件:

- {{domxref("HTMLTrackElement.cuechange_event", "cuechange")}}
- : 当底层的 {{domxref("TextTrack")}} 更改了当前呈现的提示时发送事件。此事件始终发送到 `TextTrack`,但如果与轨道关联,则**会发送到 `HTMLTrackElement`。你可以使用 `oncuechange` 事件为此事件建立处理器。
- : 当底层的 {{domxref("TextTrack")}} 更改了当前呈现的 cue 时发送事件。此事件始终发送到 `TextTrack`,但如果与轨道关联,则**会发送到 `HTMLTrackElement`。你可以使用 `oncuechange` 事件为此事件建立处理器。

## 使用说明

### 加载轨道的文本资源

如果轨道的 {{domxref("TextTrack.mode", "mode")}} 最初处于 `disabled` 状态,则描述文本轨道实际提示的 WebVTT 或 TTML 数据不加载。如果你需要在设置 `<track>` 之后对轨道执行任何处理,你应该确保轨道的 `mode``hidden`(如果你不想让它呈现给用户)或 `showing`(初始时显示轨道)。你可以以后根据需要更改模式。
如果轨道的 {{domxref("TextTrack.mode", "mode")}} 最初处于 `disabled` 状态,则描述文本轨道实际 cue 的 WebVTT 或 TTML 数据不加载。如果你需要在设置 `<track>` 之后对轨道执行任何处理,你应该确保轨道的 `mode``hidden`(如果你不想让它呈现给用户)或 `showing`(初始时显示轨道)。你可以以后根据需要更改模式。

## 规范

Expand Down

0 comments on commit 717bf8e

Please sign in to comment.