From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/zh-cn/web/html/element/track/index.html | 160 ++++++++++++++++++++++++++ 1 file changed, 160 insertions(+) create mode 100644 files/zh-cn/web/html/element/track/index.html (limited to 'files/zh-cn/web/html/element/track') diff --git a/files/zh-cn/web/html/element/track/index.html b/files/zh-cn/web/html/element/track/index.html new file mode 100644 index 0000000000..e93803188c --- /dev/null +++ b/files/zh-cn/web/html/element/track/index.html @@ -0,0 +1,160 @@ +--- +title: +slug: Web/HTML/Element/track +translation_of: Web/HTML/Element/track +--- +

HTML <track> 元素 被当作媒体元素—{{HTMLElement("audio")}} 和 {{HTMLElement("video")}}的子元素来使用。它允许指定时序文本字幕（或者基于时间的数据），例如自动处理字幕。字幕格式有 WebVTT 格式（.vtt格式文件）— Web 视频文本字幕格式，以及指时序文本标记语言（TTML）格式。

+ +

track 给媒体元素添加的数据的类型在 kind 属性中设置，属性值可以是 subtitles, captions, descriptions, chapters 或 metadata。该元素指向当用户请求额外的数据时浏览器公开的包含定时文本的源文件。

+ +

一个media 元素的任意两个 track 子元素不能有相同的 kind, srclang, 和 label属性。

+ +

{{EmbedInteractiveExample("pages/tabbed/track.html", "tabbed-standard")}}

+ +

使用上下文

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
内容分类无
允许的内容无, 它是一个 {{Glossary("空元素")}}。
标签省略允许省略，因为他是一个空元素，所以开始标签必须存在，结束标记可以省略。
允许的父元素媒体元素，流内容之前。
允许的ARIA角色无
DOM接口{{domxref("HTMLTrackElement")}}
+ +

属性

+ +

该元素包含 全局属性。

+ +
+
{{htmlattrdef("default")}}
+
该属性定义了该track应该启用，除非用户首选项指定了更合适一个track。每个媒体元素里面只有一个 track 元素可以有这个属性。
+
{{htmlattrdef("kind")}}
+
定义了 text track 应该如何使用。如果省略了该属性，默认的 kind 值就是 subtitles。下面是允许的关键字： +
    +
  • subtitles +
      +
    • 字幕给观影者看不懂的内容提供了翻译。比如英文电影里非英文的对话框或者文字。
      • +
    • 字幕可能包含额外的内容，通常有附加的背景信息。比如在电影星球大战开头的文字，或者某个场景的日期，时间，还有地点。
      • +
    +
    • +
  • captions +
      +
    • 隐藏式字幕提供了音频的转录甚至是翻译。
      • +
    • 可能包含重要的非言语的信息，比如音乐提示或者音效。可以指定提示音的源文件 (e.g. music, text, character).
      • +
    • 适用于耳聋的用户或者当调成静音的时候。
      • +
    +
    • +
  • descriptions +
      +
    • 视频内容的文本描述。
      • +
    • 适用于失明用户或者当视频不可见的场景。
      • +
    +
    • +
  • chapters +
      +
    • 章节标题用于用户浏览媒体资源的时候。
      • +
    +
    • +
  • metadata +
      +
    • 脚本使用的track。 对用户不可见。
      • +
    +
    • +
+
+
{{htmlattrdef("label")}}
+
当列出可用的text tracks时，给浏览器使用的text track的标题，这种标题是用户可读的。
+
{{htmlattrdef("src")}}
+
track的地址。必须是合法的URL。该属性必须定义。
+
{{htmlattrdef("srclang")}}
+
track文本数据的语言。它必须是合法的 BCP 47 语言标签。如果 kind 属性被设为 subtitles, 那么srclang 必须定义。
+
+ +

用法说明

+ +

轨道数据类型

+ +

track 给媒体元素添加的数据的类型在 kind 属性中设置，属性值可以是 subtitles, captions, descriptions, chapters 或 metadata。该元素指向当用户请求额外的数据时浏览器公开的包含定时文本的源文件。

+ +

一个media 元素的任意两个 track 子元素不能有相同的 kind, srclang, 和 label属性。

+ +

示例

+ +
<video controls poster="/images/sample.gif">
+   <source src="sample.mp4" type="video/mp4">
+   <source src="sample.ogv" type="video/ogv">
+   <track kind="captions" src="sampleCaptions.vtt" srclang="en">
+   <track kind="descriptions"
+     src="sampleDescriptions.vtt" srclang="en">
+   <track kind="chapters" src="sampleChapters.vtt" srclang="en">
+   <track kind="subtitles" src="sampleSubtitles_de.vtt" srclang="de">
+   <track kind="subtitles" src="sampleSubtitles_en.vtt" srclang="en">
+   <track kind="subtitles" src="sampleSubtitles_ja.vtt" srclang="ja">
+   <track kind="subtitles" src="sampleSubtitles_oz.vtt" srclang="oz">
+   <track kind="metadata" src="keyStage1.vtt" srclang="en"
+     label="Key Stage 1">
+   <track kind="metadata" src="keyStage2.vtt" srclang="en"
+     label="Key Stage 2">
+   <track kind="metadata" src="keyStage3.vtt" srclang="en"
+     label="Key Stage 3">
+   <!-- Fallback -->
+   ...
+</video>
+
+ +

规范

+ + + + + + + + + + + + + + + + + + + + + +
规范状态注释
{{SpecName('HTML WHATWG','embedded-content.html#the-track-element','track element')}}{{Spec2('HTML WHATWG')}}
{{SpecName("HTML5 W3C", "embedded-content-0.html#the-track-element", "track element")}}{{Spec2("HTML5 W3C")}}Initial definition
+ +

浏览器兼容性

+ +

{{Compat("html.elements.track")}}

+ +

参阅

+ + + +

{{HTMLRef}}

-- cgit v1.2.3-54-g00ecf