HTMLTrackElement

在此页

特性
方法
事件
用法注意事项
规范
浏览器兼容性
另请参阅
相关话题

HTMLTrackElement interface represents an HTML <track> element within the DOM . This element can be used as a child of either <audio> or <video> to specify a text track containing information such as closed captions or subtitles.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="../API/EventTarget.html" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25  351,20  351,30  341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25  501,20  501,30  491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="../API/HTMLTrackElement" target="_top"><rect x="331" y="65" width="160" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="411" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLTrackElement</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

特性

继承的特性来自其父级， HTMLElement .

HTMLTrackElement.kind

是


									DOMString

that reflects the


								
									kind

HTML attribute, indicating how the text track is meant to be used. Possible values are:


								subtitles


								captions


								descriptions


								chapters

，或


								metadata

HTMLTrackElement.src

是


									DOMString

that reflects the

src

HTML attribute, indicating the address of the text track data.

HTMLTrackElement.srclang

是


									DOMString

that reflects the


								
									srclang

HTML attribute, indicating the language of the text track data.

HTMLTrackElement.label

是


									DOMString

that reflects the


								
									label

HTML attribute, indicating a user-readable title for the track.

HTMLTrackElement.default


									布尔

反射


								
									default

attribute, indicating that the track is to be enabled if the user's preferences do not indicate that another track would be more appropriate.

HTMLTrackElement.readyState 只读

Returns an


								unsigned short

that show the readiness state of the track:

常量	值	描述
`NONE`	0	Indicates that the text track's cues have not been obtained.
`LOADING`	1	Indicates that the text track is loading and there have been no fatal errors encountered so far. Further cues might still be added to the track by the parser.
`LOADED`	2	Indicates that the text track has been loaded with no fatal errors.
`ERROR`	3	Indicates that the text track was enabled, but when the user agent attempted to obtain it, this failed in some way. Some or all of the cues are likely missing and will not be obtained.

HTMLTrackElement.track 只读


									TextTrack

is the track element's text track data.

方法

No specific method; inherits methods from its parent, HTMLElement .

事件

The following events may be fired on a <track> element, in addition to any that may be fired at its parent, HTMLElement .

cuechange: Sent when the underlying TextTrack has changed the currently-presented cues. This event is always sent to the TextTrack but is also sent to the HTMLTrackElement if one is associated with the track.
You may also use the oncuechange event handler to establish a handler for this event.

用法注意事项

Loading of the track's text resource

The WebVTT or TTML data describing the actual cues for the text track isn't loaded if the track's mode is initially in the 被禁用 state. If you need to be able to perform any processing on the track after the <track> is set up, you should instead ensure that the track's mode 是 hidden (if you don't want it to start out being presented to the user) or showing (to initially display the track). You can then change the mode as desired later.

规范

规范	状态	注释
HTML 实时标准 The definition of 'HTMLTrackElement' in that specification.	实时标准
HTML5 The definition of 'HTMLTrackElement' in that specification.	推荐	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`HTMLTrackElement`	Chrome 23	Edge ≤18	Firefox 31 31 Prior to Firefox 50, text tracks would only load if the <track> element is in a document. 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	IE No	Opera 12	Safari Yes	WebView Android Yes	Chrome Android 25	Firefox Android 31 31 Prior to Firefox 50, text tracks would only load if the <track> element is in a document. 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 12	Safari iOS Yes	Samsung Internet Android 1.5
`cuechange` event	Chrome Yes	Edge ≤79	Firefox 68	IE No	Opera ?	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 68	Opera Android ?	Safari iOS Yes	Samsung Internet Android Yes
`default`	Chrome 23	Edge 12	Firefox 31 31 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	IE No	Opera 12	Safari Yes	WebView Android Yes	Chrome Android 25	Firefox Android 31 31 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 12	Safari iOS Yes	Samsung Internet Android 1.5
`kind`	Chrome 23	Edge 12	Firefox 31 31 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	IE No	Opera 12	Safari Yes	WebView Android Yes	Chrome Android 25	Firefox Android 31 31 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 12	Safari iOS Yes	Samsung Internet Android 1.5
`label`	Chrome 23	Edge 12	Firefox 31 31 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	IE No	Opera 12	Safari Yes	WebView Android Yes	Chrome Android 25	Firefox Android 31 31 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 12	Safari iOS Yes	Samsung Internet Android 1.5
`readyState`	Chrome 23	Edge 12	Firefox 31 31 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	IE No	Opera 12	Safari Yes	WebView Android Yes	Chrome Android 25	Firefox Android 31 31 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 12	Safari iOS Yes	Samsung Internet Android 1.5
`src`	Chrome 23	Edge 12	Firefox 31 31 设置 `src` property did not work properly in versions prior to 50. 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	IE No	Opera 12	Safari Yes	WebView Android Yes	Chrome Android 25	Firefox Android 31 31 设置 `src` property did not work properly in versions prior to 50. 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 12	Safari iOS Yes	Samsung Internet Android 1.5
`srclang`	Chrome 23	Edge 12	Firefox 31 31 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	IE No	Opera 12	Safari Yes	WebView Android Yes	Chrome Android 25	Firefox Android 31 31 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 12	Safari iOS Yes	Samsung Internet Android 1.5
`track`	Chrome 23	Edge 12	Firefox 31 31 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	IE No	Opera 12	Safari Yes	WebView Android Yes	Chrome Android 25	Firefox Android 31 31 不支持 24 — 30 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 12	Safari iOS Yes	Samsung Internet Android 1.5

图例

完整支持
不支持
兼容性未知 ?

用户必须明确启用此特征。

另请参阅

The HTML element implementing this interface: <track> .

元数据

最后修改： Aug 6, 2019

在此页

特性

方法

事件

用法注意事项

Loading of the track's text resource

规范

浏览器兼容性

图例

另请参阅

相关话题