TextTrack
interface—part of the API for handling WebVTT (text tracks on media presentations)—describes and controls the text track associated with a particular
<track>
元素。
This interface also inherits properties from
EventTarget
.
TextTrack.activeCues
只读
TextTrackCueList
object listing the currently active set of text track cues. Track cues are active if the current playback position of the media is between the cues' start and end times. Thus, for displayed cues such as captions or subtitles, the active cues are currently being displayed.
TextTrack.cues
只读
TextTrackCueList
which contains all of the track's cues.
TextTrack.id
只读
DOMString
which identifies the track, if it has one. If it doesn't have an ID, then this value is an empty string (
""
). If the
TextTrack
is associated with a
<track>
element, then the track's ID matches the element's ID.
TextTrack.inBandMetadataTrackDispatchType
只读
DOMString
which indicates the track's in-band metadata track dispatch type.
needs details
TextTrack.kind
只读
DOMString
indicating what kind of text track the
TextTrack
describes. The value must be one of those in the TextTrackKind enum.
TextTrack.label
只读
DOMString
which contains the text track's label, if one is present; otherwise, this is an empty string (
""
), in which case a custom label may need to be generated by your code using other attributes of the track, if the track's label needs to be exposed to the user.
TextTrack.language
只读
DOMString
which specifies the text language in which the text track's contents is written. The value must adhere to the format specified in the
Tags for Identifying Languages
(
BCP 47
) document from the IETF, just like the HTML
lang
attribute. For example, this can be
"en-US"
for United States English or
"pt-BR"
for Brazilian Portuguese.
TextTrack.mode
DOMString
specifying the track's current mode. Changing this property's value changes the track's current mode to match. Permitted values are listed under
Text track mode constants
。默认为
被禁用
, unless the
<track>
元素的
default
Boolean attribute is specified, in which case the default mode is
started
.
cuechange
oncuechange
特性。
This interface also inherits methods from
EventTarget
.
TextTrack.addCue()
TextTrackCue
object to the track's list of cues.
TextTrack.removeCue()
TextTrackCue
object from the track's list of cues.
tbd
| 规范 | 状态 | 注释 |
|---|---|---|
|
HTML 实时标准
The definition of 'TextTrack' in that specification. |
实时标准 |
| 桌面 | 移动 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
TextTrack
|
Chrome 18 | Edge 12 |
Firefox
31
|
IE 10 | Opera 15 | Safari 6 | WebView Android 4.4 | Chrome Android 18 | Firefox Android 31 | Opera Android No | Safari iOS 7 | Samsung Internet Android 1.0 |
activeCues
|
Chrome 18 | Edge 12 |
Firefox
31
|
IE 10 | Opera 15 | Safari 6 | WebView Android 4.4 | Chrome Android 18 | Firefox Android 31 | Opera Android No | Safari iOS 7 | Samsung Internet Android 1.0 |
addCue
|
Chrome 18 | Edge 12 | Firefox 31 | IE 10 | Opera 15 | Safari 6 | WebView Android 4.4 | Chrome Android 18 | Firefox Android 31 | Opera Android No | Safari iOS 7 | Samsung Internet Android 1.0 |
cuechange
event
|
Chrome Yes | Edge 12 | Firefox 31 | IE ? | Opera ? | Safari Yes | WebView Android Yes | Chrome Android Yes | Firefox Android 31 | Opera Android No | Safari iOS ? | Samsung Internet Android Yes |
cues
|
Chrome 18 | Edge 12 |
Firefox
31
|
IE 10 | Opera 15 | Safari 6 | WebView Android 4.4 | Chrome Android 18 | Firefox Android 31 | Opera Android No | Safari iOS 7 | Samsung Internet Android 1.0 |
id
|
Chrome 18 | Edge 12 | Firefox 31 | IE 10 | Opera 15 | Safari 6 | WebView Android 4.4 | Chrome Android 18 | Firefox Android 31 | Opera Android No | Safari iOS 7 | Samsung Internet Android 1.0 |
inBandMetadataTrackDispatchType
|
Chrome 18 | Edge 12 | Firefox 31 | IE 10 | Opera 15 | Safari 6 | WebView Android 4.4 | Chrome Android 18 | Firefox Android 31 | Opera Android No | Safari iOS 7 | Samsung Internet Android 1.0 |
kind
|
Chrome 18 | Edge 12 | Firefox 31 | IE 10 | Opera 15 | Safari 6 | WebView Android 4.4 | Chrome Android 18 | Firefox Android 31 | Opera Android No | Safari iOS 7 | Samsung Internet Android 1.0 |
label
|
Chrome 18 | Edge 12 | Firefox 31 | IE 10 | Opera 15 | Safari 6 | WebView Android 4.4 | Chrome Android 18 | Firefox Android 31 | Opera Android No | Safari iOS 7 | Samsung Internet Android 1.0 |
语言
|
Chrome 18 | Edge 12 | Firefox 31 | IE 10 | Opera 15 | Safari 6 | WebView Android 4.4 | Chrome Android 18 | Firefox Android 31 | Opera Android No | Safari iOS 7 | Samsung Internet Android 1.0 |
mode
|
Chrome 18 | Edge 12 |
Firefox
31
|
IE 10 | Opera 15 | Safari 6 | WebView Android 4.4 | Chrome Android 18 | Firefox Android 31 | Opera Android No | Safari iOS 7 | Samsung Internet Android 1.0 |
oncuechange
|
Chrome Yes | Edge 12 | Firefox 31 | IE ? | Opera Yes | Safari Yes | WebView Android Yes | Chrome Android Yes | Firefox Android 31 | Opera Android No | Safari iOS ? | Samsung Internet Android Yes |
removeCue
|
Chrome 18 | Edge 12 | Firefox 31 | IE 10 | Opera 15 | Safari 6 | WebView Android 4.4 | Chrome Android 18 | Firefox Android 31 | Opera Android No | Safari iOS 7 | Samsung Internet Android 1.0 |
sourceBuffer
|
Chrome No | Edge No | Firefox ? | IE ? | Opera ? | Safari Yes | WebView Android No | Chrome Android No | Firefox Android ? | Opera Android No | Safari iOS ? | Samsung Internet Android No |
完整支持
不支持
兼容性未知
见实现注意事项。
TextTrack