[html5] r5723 - [acgiowt] (0) Change 'timed track' to 'text track' since 'track' rather implies [...]
whatwg at whatwg.org
whatwg at whatwg.org
Fri Dec 24 22:56:44 PST 2010
Author: ianh
Date: 2010-12-24 22:56:43 -0800 (Fri, 24 Dec 2010)
New Revision: 5723
Modified:
complete.html
index
source
Log:
[acgiowt] (0) Change 'timed track' to 'text track' since 'track' rather implies the 'timed' component already and 'text' is the important part of the concept. Also, this fits in better with the WebVTT name. WARNING: This is bound to have caused all kinds of mistakes; please file bugs for such editorial issues. Thanks.
Modified: complete.html
===================================================================
--- complete.html 2010-12-25 06:42:53 UTC (rev 5722)
+++ complete.html 2010-12-25 06:56:43 UTC (rev 5723)
@@ -568,14 +568,14 @@
<li><a href=#the-ready-states><span class=secno>4.8.10.7 </span>The ready states</a></li>
<li><a href=#playing-the-media-resource><span class=secno>4.8.10.8 </span>Playing the media resource</a></li>
<li><a href=#seeking><span class=secno>4.8.10.9 </span>Seeking</a></li>
- <li><a href=#text-timed-tracks><span class=secno>4.8.10.10 </span>Text timed tracks</a>
+ <li><a href=#timed-text-tracks><span class=secno>4.8.10.10 </span>Timed text tracks</a>
<ol>
- <li><a href=#timed-track-model><span class=secno>4.8.10.10.1 </span>Timed track model</a></li>
- <li><a href=#sourcing-in-band-timed-tracks><span class=secno>4.8.10.10.2 </span>Sourcing in-band timed tracks</a></li>
- <li><a href=#sourcing-out-of-band-timed-tracks><span class=secno>4.8.10.10.3 </span>Sourcing out-of-band timed tracks</a></li>
- <li><a href=#guidelines-for-exposing-cues-in-various-formats-as-timed-track-cues><span class=secno>4.8.10.10.4 </span>Guidelines for exposing cues in various formats as
- timed track cues</a></li>
- <li><a href=#timed-track-api><span class=secno>4.8.10.10.5 </span>Timed track API</a></li>
+ <li><a href=#text-track-model><span class=secno>4.8.10.10.1 </span>Text track model</a></li>
+ <li><a href=#sourcing-in-band-text-tracks><span class=secno>4.8.10.10.2 </span>Sourcing in-band text tracks</a></li>
+ <li><a href=#sourcing-out-of-band-text-tracks><span class=secno>4.8.10.10.3 </span>Sourcing out-of-band text tracks</a></li>
+ <li><a href=#guidelines-for-exposing-cues-in-various-formats-as-text-track-cues><span class=secno>4.8.10.10.4 </span>Guidelines for exposing cues in various formats as
+ text track cues</a></li>
+ <li><a href=#text-track-api><span class=secno>4.8.10.10.5 </span>Text track API</a></li>
<li><a href=#cue-events><span class=secno>4.8.10.10.6 </span>Event definitions</a></ol></li>
<li><a href=#webvtt-0><span class=secno>4.8.10.11 </span>WebVTT</a>
<ol>
@@ -1259,7 +1259,7 @@
<li><a href=#replaced-elements><span class=secno>14.3 </span>Replaced elements</a>
<ol>
<li><a href=#embedded-content-2><span class=secno>14.3.1 </span>Embedded content</a></li>
- <li><a href=#timed-tracks><span class=secno>14.3.2 </span>Timed tracks</a>
+ <li><a href=#timed-text-tracks-0><span class=secno>14.3.2 </span>Timed text tracks</a>
<ol>
<li><a href=#webvtt-cue-text-rendering-rules><span class=secno>14.3.2.1 </span>WebVTT cue text rendering rules</a></li>
<li><a href=#applying-css-properties-to-webvtt-node-objects><span class=secno>14.3.2.2 </span>Applying CSS properties to WebVTT Node Objects</a></li>
@@ -24414,10 +24414,10 @@
<!--KEEP-END w3c-html--><!--TT-->
<p>The <code><a href=#video>video</a></code> element also <a href=#represents>represents</a> any
- <a href=#timed-track-cue title="timed track cue">timed track cues</a> whose
- <a href=#timed-track-cue-active-flag>timed track cue active flag</a> is set and whose
- <a href=#timed-track>timed track</a> is in the <a href=#timed-track-showing title="timed track
- showing">showing</a> or <a href=#timed-track-showing-by-default title="timed track showing by
+ <a href=#text-track-cue title="text track cue">text track cues</a> whose
+ <a href=#text-track-cue-active-flag>text track cue active flag</a> is set and whose
+ <a href=#text-track>text track</a> is in the <a href=#text-track-showing title="text track
+ showing">showing</a> or <a href=#text-track-showing-by-default title="text track showing by
default">showing by default</a> modes.</p>
<!--KEEP-START w3c-html--><!--TT-->
@@ -24943,13 +24943,11 @@
attribute DOMString <a href=#dom-track-label title=dom-track-label>label</a>;
attribute boolean <a href=#dom-track-default title=dom-track-default>default</a>;
- readonly attribute <a href=#timedtrack>TimedTrack</a> <a href=#dom-track-track title=dom-track-track>track</a>;
+ readonly attribute <a href=#texttrack>TextTrack</a> <a href=#dom-track-track title=dom-track-track>track</a>;
};</pre>
</dd>
</dl><p>The <code><a href=#the-track-element>track</a></code> element allows authors to specify explicit
- external text-based <a href=#timed-track title="timed track">timed tracks</a>
- for <a href=#media-element title="media element">media elements</a>. It does not
- <a href=#represents title=represents>represent</a> anything on its own.</p>
+ external timed <a href=#text-track title="text track">text tracks</a> for <a href=#media-element title="media element">media elements</a>. It does not <a href=#represents title=represents>represent</a> anything on its own.</p>
<p>The <dfn id=attr-track-kind title=attr-track-kind><code>kind</code></dfn>
attribute is an <a href=#enumerated-attribute>enumerated attribute</a>. The following
@@ -24989,7 +24987,7 @@
the <a href=#attr-track-kind-subtitles title=attr-track-kind-subtitles>subtitles</a> state.</p>
<p>The <dfn id=attr-track-src title=attr-track-src><code>src</code></dfn> attribute
- gives the address of the timed track data. The value must be a
+ gives the address of the text track data. The value must be a
<a href=#valid-non-empty-url-potentially-surrounded-by-spaces>valid non-empty URL potentially surrounded by
spaces</a>. This attribute must be present.</p>
@@ -25013,7 +25011,7 @@
<!--TTVTT-->
<p>The <dfn id=attr-track-srclang title=attr-track-srclang><code>srclang</code></dfn>
- attribute gives the language of the timed track data. The value must
+ attribute gives the language of the text track data. The value must
be a valid BCP 47 language tag. This attribute must be present if
the element's <code title=attr-track-kind><a href=#attr-track-kind>kind</a></code> attribute is
in the <a href=#attr-track-kind-subtitles title=attr-track-kind-subtitles>subtitles</a>
@@ -25063,7 +25061,7 @@
<dd>
- <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object corresponding to the <a href=#timed-track>timed track</a> of the <code><a href=#the-track-element>track</a></code> element.</p>
+ <p>Returns the <code><a href=#texttrack>TextTrack</a></code> object corresponding to the <a href=#text-track>text track</a> of the <code><a href=#the-track-element>track</a></code> element.</p>
</dd>
@@ -25071,7 +25069,7 @@
<p>The <dfn id=dom-track-track title=dom-track-track><code>track</code></dfn> IDL
attribute must, on getting, return the <code><a href=#the-track-element>track</a></code> element's
- <a href=#timed-track>timed track</a>'s corresponding <code><a href=#timedtrack>TimedTrack</a></code>
+ <a href=#text-track>text track</a>'s corresponding <code><a href=#texttrack>TextTrack</a></code>
object.</p>
<p>The <dfn id=dom-track-src title=dom-track-src><code>src</code></dfn>, <dfn id=dom-track-srclang title=dom-track-srclang><code>srclang</code></dfn>, <dfn id=dom-track-label title=dom-track-label><code>label</code></dfn>, and <dfn id=dom-track-default title=dom-track-default><code>default</code></dfn> IDL attributes
@@ -25155,9 +25153,9 @@
attribute double <a href=#dom-media-volume title=dom-media-volume>volume</a>;
attribute boolean <a href=#dom-media-muted title=dom-media-muted>muted</a>;
<!--KEEP-END w3c-html--><!--TT-->
- // timed tracks
- readonly attribute <a href=#timedtrack>TimedTrack</a>[] <a href=#dom-media-tracks title=dom-media-tracks>tracks</a>;
- <a href=#mutabletimedtrack>MutableTimedTrack</a> <a href=#dom-media-addtrack title=dom-media-addTrack>addTrack</a>(in DOMString kind, in optional DOMString label, in optional DOMString language);
+ // text tracks
+ readonly attribute <a href=#texttrack>TextTrack</a>[] <a href=#dom-media-tracks title=dom-media-tracks>tracks</a>;
+ <a href=#mutabletexttrack>MutableTextTrack</a> <a href=#dom-media-addtrack title=dom-media-addTrack>addTrack</a>(in DOMString kind, in optional DOMString label, in optional DOMString language);
<!--KEEP-START w3c-html--><!--TT-->
};</pre>
@@ -25549,8 +25547,8 @@
<code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code>.</li>
<!--KEEP-END w3c-html--><!--TT-->
- <li><p><a href="#forget-the-media-element's-media-resource-specific-timed-tracks">Forget the media element's media-resource-specific
- timed tracks</a>.</li>
+ <li><p><a href="#forget-the-media-element's-media-resource-specific-text-tracks">Forget the media element's media-resource-specific
+ text tracks</a>.</li>
<!--KEEP-START w3c-html--><!--TT-->
<li><p>If <code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> is
@@ -25702,8 +25700,8 @@
<code title=dom-MediaError-MEDIA_ERR_SRC_NOT_SUPPORTED><a href=#dom-mediaerror-media_err_src_not_supported>MEDIA_ERR_SRC_NOT_SUPPORTED</a></code>.</li>
<!--KEEP-END w3c-html--><!--TT-->
- <li><p><a href="#forget-the-media-element's-media-resource-specific-timed-tracks">Forget the media element's media-resource-specific
- timed tracks</a>.</li>
+ <li><p><a href="#forget-the-media-element's-media-resource-specific-text-tracks">Forget the media element's media-resource-specific
+ text tracks</a>.</li>
<!--KEEP-START w3c-html--><!--TT-->
<li><p>Set the element's <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> attribute to
@@ -25822,8 +25820,8 @@
marked with ⌛.)</li>
<!--KEEP-END w3c-html--><!--TT-->
- <li><p>⌛ <a href="#forget-the-media-element's-media-resource-specific-timed-tracks">Forget the media element's
- media-resource-specific timed tracks</a>.</li>
+ <li><p>⌛ <a href="#forget-the-media-element's-media-resource-specific-text-tracks">Forget the media element's
+ media-resource-specific text tracks</a>.</li>
<!--KEEP-START w3c-html--><!--TT-->
<li><p>⌛ <i title="">Find next candidate</i>: Let <var title="">candidate</var> be null.</li>
@@ -25991,7 +25989,7 @@
<a href=#media-resource>media resource</a>, its dimensions, and other
metadata,
<!--KEEP-END w3c-html--><!--TT-->
- and once <a href=#the-timed-tracks-are-ready>the timed tracks are ready</a>
+ and once <a href=#the-text-tracks-are-ready>the text tracks are ready</a>
<!--KEEP-START w3c-html--><!--TT-->
</dt>
@@ -26250,15 +26248,15 @@
<!--KEEP-END w3c-html--><!--TT-->
- <dt id=found-a-media-resource-specific-timed-track>If the <a href=#media-resource>media resource</a> is found to declare a <a href=#media-resource-specific-timed-track>media-resource-specific timed track</a> that the user agent supports</dt>
+ <dt id=found-a-media-resource-specific-timed-track>If the <a href=#media-resource>media resource</a> is found to declare a <a href=#media-resource-specific-text-track>media-resource-specific text track</a> that the user agent supports</dt>
<dd>
<p>If the <a href=#media-resource>media resource</a>'s <a href=#origin>origin</a> is
the <a href=#same-origin>same origin</a> as the <a href=#media-element>media element</a>'s
<code><a href=#document>Document</a></code>'s <a href=#origin>origin</a>, <a href=#queue-a-task>queue a
- task</a> to run the <a href=#steps-to-expose-a-media-resource-specific-timed-track>steps to expose a
- media-resource-specific timed track</a> with the relevant
+ task</a> to run the <a href=#steps-to-expose-a-media-resource-specific-text-track>steps to expose a
+ media-resource-specific text track</a> with the relevant
data.</p> <!-- CORS -->
<p class=note>Cross-origin files do not expose their subtitles
@@ -26659,8 +26657,8 @@
data</a> is available for the immediate <a href=#current-playback-position>current playback
position</a>.
<!--KEEP-END w3c-html--><!--TT-->
- The <a href=#timed-track title="timed track">timed tracks</a>
- are <a href=#the-timed-tracks-are-ready title="the timed tracks are ready">ready</a>.
+ The <a href=#text-track title="text track">text tracks</a>
+ are <a href=#the-text-tracks-are-ready title="the text tracks are ready">ready</a>.
<!--KEEP-START w3c-html--><!--TT-->
</dd>
@@ -27188,29 +27186,29 @@
rerun the steps.
<!--KEEP-END w3c-html--><!--TT-->
(These steps are thus run as often as possible or needed — if
- one iteration takes a long time, this can cause certain <a href=#timed-track-cue title="timed track cue">cues</a> to be skipped over as the user
+ one iteration takes a long time, this can cause certain <a href=#text-track-cue title="text track cue">cues</a> to be skipped over as the user
agent rushes ahead to "catch up".)
<!--KEEP-START w3c-html--><!--TT-->
</p>
<ol><!--KEEP-END w3c-html--><!--TT--><li><p>Let <var title="">current cues</var> be an ordered list of
- <a href=#timed-track-cue title="timed track cue">cues</a>, initialized to contain
- all the <a href=#timed-track-cue title="timed track cue">cues</a> of all the <a href=#timed-track-hidden title="timed track hidden">hidden</a>, <a href=#timed-track-showing title="timed track
- showing">showing</a>, or <a href=#timed-track-showing-by-default title="timed track showing by
- default">showing by default</a> <a href=#timed-track title="timed track">timed
- tracks</a> of the <a href=#media-element>media element</a> (not the <a href=#timed-track-disabled title="timed track disabled">disabled</a> ones) whose <a href=#timed-track-cue-start-time title="timed track cue start time">start times</a> are less than
+ <a href=#text-track-cue title="text track cue">cues</a>, initialized to contain
+ all the <a href=#text-track-cue title="text track cue">cues</a> of all the <a href=#text-track-hidden title="text track hidden">hidden</a>, <a href=#text-track-showing title="text track
+ showing">showing</a>, or <a href=#text-track-showing-by-default title="text track showing by
+ default">showing by default</a> <a href=#text-track title="text track">text
+ tracks</a> of the <a href=#media-element>media element</a> (not the <a href=#text-track-disabled title="text track disabled">disabled</a> ones) whose <a href=#text-track-cue-start-time title="text track cue start time">start times</a> are less than
or equal to the <a href=#current-playback-position>current playback position</a> and whose
- <a href=#timed-track-cue-end-time title="timed track cue end time">end times</a> are greater
- than the <a href=#current-playback-position>current playback position</a>, in <a href=#timed-track-cue-order>timed
+ <a href=#text-track-cue-end-time title="text track cue end time">end times</a> are greater
+ than the <a href=#current-playback-position>current playback position</a>, in <a href=#text-track-cue-order>text
track cue order</a>.</li>
<li><p>Let <var title="">other cues</var> be an ordered list of
- <a href=#timed-track-cue title="timed track cue">cues</a>, initialized to contain
- all the <a href=#timed-track-cue title="timed track cue">cues</a> of <a href=#timed-track-hidden title="timed track hidden">hidden</a>, <a href=#timed-track-showing title="timed track
- showing">showing</a>, and <a href=#timed-track-showing-by-default title="timed track showing by
- default">showing by default</a> <a href=#timed-track title="timed track">timed
+ <a href=#text-track-cue title="text track cue">cues</a>, initialized to contain
+ all the <a href=#text-track-cue title="text track cue">cues</a> of <a href=#text-track-hidden title="text track hidden">hidden</a>, <a href=#text-track-showing title="text track
+ showing">showing</a>, and <a href=#text-track-showing-by-default title="text track showing by
+ default">showing by default</a> <a href=#text-track title="text track">text
tracks</a> of the <a href=#media-element>media element</a> that are not
- present in <var title="">current cues</var>, also in <a href=#timed-track-cue-order>timed
+ present in <var title="">current cues</var>, also in <a href=#text-track-cue-order>text
track cue order</a>.</li>
<!--KEEP-START w3c-html--><!--TT-->
@@ -27233,79 +27231,79 @@
while decoding the video.</li>
<!--KEEP-END w3c-html--><!--TT-->
- <li><p>If all of the <a href=#timed-track-cue title="timed track cue">cues</a> in
- <var title="">current cues</var> have their <a href=#timed-track-cue-active-flag>timed track cue
- active flag</a> set, and none of the <a href=#timed-track-cue title="timed track
+ <li><p>If all of the <a href=#text-track-cue title="text track cue">cues</a> in
+ <var title="">current cues</var> have their <a href=#text-track-cue-active-flag>text track cue
+ active flag</a> set, and none of the <a href=#text-track-cue title="text track
cue">cues</a> in <var title="">other cues</var> have their
- <a href=#timed-track-cue-active-flag>timed track cue active flag</a> set, then abort these
+ <a href=#text-track-cue-active-flag>text track cue active flag</a> set, then abort these
steps.</li>
<li><p>If the time was reached through the usual monotonic increase
of the current playback position during normal playback, and there
- are <a href=#timed-track-cue title="timed track cue">cues</a> in <var title="">other cues</var> that have both their <a href=#timed-track-cue-active-flag>timed track
- cue active flag</a> set and their <a href=#timed-track-cue-pause-on-exit-flag>timed track cue
+ are <a href=#text-track-cue title="text track cue">cues</a> in <var title="">other cues</var> that have both their <a href=#text-track-cue-active-flag>text track
+ cue active flag</a> set and their <a href=#text-track-cue-pause-on-exit-flag>text track cue
pause-on-exit flag</a> set, then immediately act as if the
element's <code title=dom-media-pause><a href=#dom-media-pause>pause()</a></code> method had
been invoked. <!-- pause() can in theory call load(), but never can
it do so as part of this invokation, since we wouldn't be in this
algorithm if the media element was empty. So, no need to couch all
this in a task. --> (In the other cases, such as explicit seeks,
- playback is not paused by going past the end time of a <a href=#timed-track-cue title="timed track cue">cue</a>, even if that <a href=#timed-track-cue title="timed
- track cue">cue</a> has its <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit
+ playback is not paused by going past the end time of a <a href=#text-track-cue title="text track cue">cue</a>, even if that <a href=#text-track-cue title="text
+ track cue">cue</a> has its <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit
flag</a> set.)</li>
- <li><p>Let <var title="">affected tracks</var> be a list of <a href=#timed-track title="timed track">timed tracks</a>, initially empty.</li>
+ <li><p>Let <var title="">affected tracks</var> be a list of <a href=#text-track title="text track">text tracks</a>, initially empty.</li>
- <li><p>For each <a href=#timed-track-cue title="timed track cue">timed track
+ <li><p>For each <a href=#text-track-cue title="text track cue">text track
cue</a> in <var title="">other cues</var> that has its
- <a href=#timed-track-cue-active-flag>timed track cue active flag</a> set, in list order,
+ <a href=#text-track-cue-active-flag>text track cue active flag</a> set, in list order,
<a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> named
<code title=event-exit>exit</code> at the
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> object, and add the <a href=#timed-track-cue title="timed
- track cue">cue</a>'s <a href=#timed-track>timed track</a> to <var title="">affected tracks</var>, if it's not already in the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object, and add the <a href=#text-track-cue title="text
+ track cue">cue</a>'s <a href=#text-track>text track</a> to <var title="">affected tracks</var>, if it's not already in the
list.</li>
- <li><p>For each <a href=#timed-track-cue title="timed track cue">timed track
+ <li><p>For each <a href=#text-track-cue title="text track cue">text track
cue</a> in <var title="">current cues</var> that does not have
- its <a href=#timed-track-cue-active-flag>timed track cue active flag</a> set, in list order,
+ its <a href=#text-track-cue-active-flag>text track cue active flag</a> set, in list order,
<a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> named
<code title=event-enter>enter</code> at the
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> object, and add the <a href=#timed-track-cue title="timed
- track cue">cue</a>'s <a href=#timed-track>timed track</a> to <var title="">affected tracks</var>, if it's not already in the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object, and add the <a href=#text-track-cue title="text
+ track cue">cue</a>'s <a href=#text-track>text track</a> to <var title="">affected tracks</var>, if it's not already in the
list.</li>
- <li><p>For each <a href=#timed-track>timed track</a> in <var title="">affected
+ <li><p>For each <a href=#text-track>text track</a> in <var title="">affected
tracks</var>, in the order they were added to the list (which will
- match the relative order of the <a href=#timed-track title="timed track">timed
- tracks</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of
- timed tracks</a>), <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a
+ match the relative order of the <a href=#text-track title="text track">text
+ tracks</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of
+ text tracks</a>), <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a
simple event</a> named <code title=event-cuechange>cuechange</code> at the
- <code><a href=#timedtrack>TimedTrack</a></code> object, and, if the <a href=#timed-track>timed
+ <code><a href=#texttrack>TextTrack</a></code> object, and, if the <a href=#text-track>text
track</a> has a corresponding <code><a href=#the-track-element>track</a></code> element, to
then <a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-cuechange>cuechange</code> at the <code><a href=#the-track-element>track</a></code>
element as well.</li>
- <li><p>Set the <a href=#timed-track-cue-active-flag>timed track cue active flag</a> of all the
- <a href=#timed-track-cue title="timed track cue">cues</a> in the <var title="">current cues</var>, and unset the <a href=#timed-track-cue-active-flag>timed track cue
- active flag</a> of all the <a href=#timed-track-cue title="timed track
+ <li><p>Set the <a href=#text-track-cue-active-flag>text track cue active flag</a> of all the
+ <a href=#text-track-cue title="text track cue">cues</a> in the <var title="">current cues</var>, and unset the <a href=#text-track-cue-active-flag>text track cue
+ active flag</a> of all the <a href=#text-track-cue title="text track
cue">cues</a> in the <var title="">other cues</var>.</li>
- <li><p>Run the <a href=#rules-for-updating-the-timed-track-rendering>rules for updating the timed track
- rendering</a> of each of the <a href=#timed-track title="timed track">timed
- tracks</a> in <var title="">affected tracks</var> that are <a href=#timed-track-showing title="timed track showing">showing</a> or <a href=#timed-track-showing-by-default title="timed
+ <li><p>Run the <a href=#rules-for-updating-the-text-track-rendering>rules for updating the text track
+ rendering</a> of each of the <a href=#text-track title="text track">text
+ tracks</a> in <var title="">affected tracks</var> that are <a href=#text-track-showing title="text track showing">showing</a> or <a href=#text-track-showing-by-default title="text
track showing by default">showing by default</a>.
<!--TTVTT-->
- For example, for <a href=#timed-track title="timed track">timed tracks</a>
- based on <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the
- display of WebVTT timed tracks</a>.
+ For example, for <a href=#text-track title="text track">text tracks</a>
+ based on <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the
+ display of WebVTT text tracks</a>.
<!--TTVTT-->
</li>
<!--KEEP-START w3c-html--><!--TT-->
- </ol><!--KEEP-END w3c-html--><!--TT--><p>For the purposes of the algorithm above, a <a href=#timed-track-cue>timed track
- cue</a> is considered to be part of a <a href=#timed-track>timed track</a>
- only if it is listed in the <a href=#timed-track-list-of-cues>timed track list of cues</a>,
- not merely if it is associated with the <a href=#timed-track>timed
+ </ol><!--KEEP-END w3c-html--><!--TT--><p>For the purposes of the algorithm above, a <a href=#text-track-cue>text track
+ cue</a> is considered to be part of a <a href=#text-track>text track</a>
+ only if it is listed in the <a href=#text-track-list-of-cues>text track list of cues</a>,
+ not merely if it is associated with the <a href=#text-track>text
track</a>.</p>
<!--KEEP-START w3c-html--><!--TT-->
@@ -27467,47 +27465,47 @@
<!--KEEP-END w3c-html--><!--TT-->
<!--<div data-component="other Hixie drafts (editor: Ian Hickson)">-->
- <h5 id=text-timed-tracks><span class=secno>4.8.10.10 </span>Text timed tracks</h5>
+ <h5 id=timed-text-tracks><span class=secno>4.8.10.10 </span>Timed text tracks</h5>
- <h6 id=timed-track-model><span class=secno>4.8.10.10.1 </span>Timed track model</h6>
+ <h6 id=text-track-model><span class=secno>4.8.10.10.1 </span>Text track model</h6>
- <p>A <a href=#media-element>media element</a> can have a group of associated <dfn id=timed-track title="timed track">timed tracks</dfn>, known as the <a href=#media-element>media
- element</a>'s <dfn id=list-of-timed-tracks>list of timed tracks</dfn>. The <a href=#timed-track title="timed track">timed tracks</a> are sorted as follows:</p>
+ <p>A <a href=#media-element>media element</a> can have a group of associated <dfn id=text-track title="text track">text tracks</dfn>, known as the <a href=#media-element>media
+ element</a>'s <dfn id=list-of-text-tracks>list of text tracks</dfn>. The <a href=#text-track title="text track">text tracks</a> are sorted as follows:</p>
- <ol class=brief><li>The <a href=#timed-track title="timed track">timed tracks</a> corresponding
+ <ol class=brief><li>The <a href=#text-track title="text track">text tracks</a> corresponding
to <code><a href=#the-track-element>track</a></code> element children of the <a href=#media-element>media
element</a>, in <a href=#tree-order>tree order</a>.</li>
- <li>Any <a href=#timed-track title="timed track">timed tracks</a> added using
+ <li>Any <a href=#text-track title="text track">text tracks</a> added using
the <code title=dom-media-addTrack><a href=#dom-media-addtrack>addTrack()</a></code> method, in
the order they were added, oldest first.</li>
- <li>Any <a href=#media-resource-specific-timed-track title="media-resource-specific timed
- track">media-resource-specific timed tracks</a> (<a href=#timed-track title="timed track">timed tracks</a> corresponding to data in
+ <li>Any <a href=#media-resource-specific-text-track title="media-resource-specific text
+ track">media-resource-specific text tracks</a> (<a href=#text-track title="text track">text tracks</a> corresponding to data in
the <a href=#media-resource>media resource</a>), in the order defined by the
<a href=#media-resource>media resource</a>'s format specification.</li>
- </ol><p>A <a href=#timed-track>timed track</a> consists of:</p>
+ </ol><p>A <a href=#text-track>text track</a> consists of:</p>
- <dl><dt><dfn id=timed-track-kind title="timed track kind">The kind of timed track</dfn>
+ <dl><dt><dfn id=text-track-kind title="text track kind">The kind of text track</dfn>
<dd>
<p>This decides how the track is handled by the user agent. The
kind is represented by a string. The possible strings are:</p>
- <ul class=brief><li><dfn id=dom-timedtrack-kind-subtitles title=dom-TimedTrack-kind-subtitles><code>subtitles</code></dfn>
- <li><dfn id=dom-timedtrack-kind-captions title=dom-TimedTrack-kind-captions><code>captions</code></dfn>
- <li><dfn id=dom-timedtrack-kind-descriptions title=dom-TimedTrack-kind-descriptions><code>descriptions</code></dfn>
- <li><dfn id=dom-timedtrack-kind-chapters title=dom-TimedTrack-kind-chapters><code>chapters</code></dfn>
- <li><dfn id=dom-timedtrack-kind-metadata title=dom-TimedTrack-kind-metadata><code>metadata</code></dfn>
- </ul><p>The <a href=#timed-track-kind title="timed track kind">kind of track</a> can
- change dynamically, in the case of a <a href=#timed-track>timed track</a>
+ <ul class=brief><li><dfn id=dom-texttrack-kind-subtitles title=dom-TextTrack-kind-subtitles><code>subtitles</code></dfn>
+ <li><dfn id=dom-texttrack-kind-captions title=dom-TextTrack-kind-captions><code>captions</code></dfn>
+ <li><dfn id=dom-texttrack-kind-descriptions title=dom-TextTrack-kind-descriptions><code>descriptions</code></dfn>
+ <li><dfn id=dom-texttrack-kind-chapters title=dom-TextTrack-kind-chapters><code>chapters</code></dfn>
+ <li><dfn id=dom-texttrack-kind-metadata title=dom-TextTrack-kind-metadata><code>metadata</code></dfn>
+ </ul><p>The <a href=#text-track-kind title="text track kind">kind of track</a> can
+ change dynamically, in the case of a <a href=#text-track>text track</a>
corresponding to a <code><a href=#the-track-element>track</a></code> element.</p>
</dd>
- <dt><dfn id=timed-track-label title="timed track label">A label</dfn>
+ <dt><dfn id=text-track-label title="text track label">A label</dfn>
<dd>
@@ -27515,106 +27513,106 @@
for the user. In certain cases, the label might be generated
automatically.</p>
- <p>The <a href=#timed-track-label title="timed track label">label of a track</a> can
- change dynamically, in the case of a <a href=#timed-track>timed track</a>
+ <p>The <a href=#text-track-label title="text track label">label of a track</a> can
+ change dynamically, in the case of a <a href=#text-track>text track</a>
corresponding to a <code><a href=#the-track-element>track</a></code> element or in the case of an
automatically-generated label whose value depends on variable
factors such as the user's preferred user interface language.</p>
</dd>
- <dt><dfn id=timed-track-language title="timed track language">A language</dfn>
+ <dt><dfn id=text-track-language title="text track language">A language</dfn>
<dd>
<p>This is a string (a BCP 47 language tag) representing the
- language of the timed track's cues. <a href=#refsBCP47>[BCP47]</a></p>
+ language of the text track's cues. <a href=#refsBCP47>[BCP47]</a></p>
- <p>The <a href=#timed-track-language title="timed track language">language of a timed
- track</a> can change dynamically, in the case of a <a href=#timed-track>timed
+ <p>The <a href=#text-track-language title="text track language">language of a text
+ track</a> can change dynamically, in the case of a <a href=#text-track>text
track</a> corresponding to a <code><a href=#the-track-element>track</a></code> element.</p>
</dd>
- <dt><dfn id=timed-track-readiness-state title="timed track readiness state">A readiness state</dfn>
+ <dt><dfn id=text-track-readiness-state title="text track readiness state">A readiness state</dfn>
<dd>
<p>One of the following:</p>
- <dl><dt><dfn id=timed-track-not-loaded title="timed track not loaded">Not loaded</dfn>
+ <dl><dt><dfn id=text-track-not-loaded title="text track not loaded">Not loaded</dfn>
<dd>
- <p>Indicates that the timed track is known to exist (e.g. it has
+ <p>Indicates that the text track is known to exist (e.g. it has
been declared with a <code><a href=#the-track-element>track</a></code> element), but its cues
have not been obtained.</p>
</dd>
- <dt><dfn id=timed-track-loading title="timed track loading">Loading</dfn>
+ <dt><dfn id=text-track-loading title="text track loading">Loading</dfn>
<dd>
- <p>Indicates that the timed track is loading and there have been
+ <p>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.</p>
</dd>
- <dt><dfn id=timed-track-loaded title="timed track loaded">Loaded</dfn>
+ <dt><dfn id=text-track-loaded title="text track loaded">Loaded</dfn>
<dd>
- <p>Indicates that the timed track has been loaded with no fatal
+ <p>Indicates that the text track has been loaded with no fatal
errors. No new cues will be added to the track except if the
- <a href=#timed-track>timed track</a> corresponds to a
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object.</p>
+ <a href=#text-track>text track</a> corresponds to a
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object.</p>
</dd>
- <dt><dfn id=timed-track-failed-to-load title="timed track failed to load">Failed to load</dfn>
+ <dt><dfn id=text-track-failed-to-load title="text track failed to load">Failed to load</dfn>
<dd>
- <p>Indicates that the timed track was enabled, but when the user
+ <p>Indicates that the text track was enabled, but when the user
agent attempted to obtain it, this failed in some way
(e.g. <a href=#url>URL</a> could not be <a href=#resolve-a-url title="resolve a
- url">resolved</a>, network error, unknown timed track
+ url">resolved</a>, network error, unknown text track
format). Some or all of the cues are likely missing and will not
be obtained.</p>
</dd>
- </dl><p>The <a href=#timed-track-readiness-state title="timed track readiness state">readiness
- state</a> of a <a href=#timed-track>timed track</a> changes dynamically as
+ </dl><p>The <a href=#text-track-readiness-state title="text track readiness state">readiness
+ state</a> of a <a href=#text-track>text track</a> changes dynamically as
the track is obtained.</p>
</dd>
- <dt><dfn id=timed-track-mode title="timed track mode">A mode</dfn>
+ <dt><dfn id=text-track-mode title="text track mode">A mode</dfn>
<dd>
<p>One of the following:</p>
- <dl><dt><dfn id=timed-track-disabled title="timed track disabled">Disabled</dfn>
+ <dl><dt><dfn id=text-track-disabled title="text track disabled">Disabled</dfn>
<dd>
- <p>Indicates that the timed track is not active. Other than for
+ <p>Indicates that the text track is not active. Other than for
the purposes of exposing the track in the DOM, the user agent is
- ignoring the timed track. No cues are active, no events are
+ ignoring the text track. No cues are active, no events are
fired, and the user agent will not attempt to obtain the track's
cues.</p>
</dd>
- <dt><dfn id=timed-track-hidden title="timed track hidden">Hidden</dfn>
+ <dt><dfn id=text-track-hidden title="text track hidden">Hidden</dfn>
<dd>
- <p>Indicates that the timed track is active, but that the user
+ <p>Indicates that the text track is active, but that the user
agent is not actively displaying the cues. If no attempt has yet
been made to obtain the track's cues, the user agent will
perform such an attempt momentarily. The user agent is
@@ -27623,28 +27621,28 @@
</dd>
- <dt><dfn id=timed-track-showing title="timed track showing">Showing</dfn>
- <dt><dfn id=timed-track-showing-by-default title="timed track showing by default">Showing by default</dfn>
+ <dt><dfn id=text-track-showing title="text track showing">Showing</dfn>
+ <dt><dfn id=text-track-showing-by-default title="text track showing by default">Showing by default</dfn>
</dt><dd>
- <p>Indicates that the timed track is active. If no attempt has
+ <p>Indicates that the text track is active. If no attempt has
yet been made to obtain the track's cues, the user agent will
perform such an attempt momentarily. The user agent is
maintaining a list of which cues are active, and events are
- being fired accordingly. In addition, for timed tracks whose
- <a href=#timed-track-kind title="timed track kind">kind</a> is <code title=dom-mediatrack-kind-subtitles>subtitles</code> or <code title=dom-mediatrack-kind-captions>captions</code>, the cues
- are being displayed over the video as appropriate; for timed
- tracks whose <a href=#timed-track-kind title="timed track kind">kind</a> is <code title=dom-mediatrack-kind-descriptions>descriptions</code>,
+ being fired accordingly. In addition, for text tracks whose
+ <a href=#text-track-kind title="text track kind">kind</a> is <code title=dom-mediatrack-kind-subtitles>subtitles</code> or <code title=dom-mediatrack-kind-captions>captions</code>, the cues
+ are being displayed over the video as appropriate; for text
+ tracks whose <a href=#text-track-kind title="text track kind">kind</a> is <code title=dom-mediatrack-kind-descriptions>descriptions</code>,
the user agent is making the cues available to the user in a
- non-visual fashion; and for timed tracks whose <a href=#timed-track-kind title="timed track kind">kind</a> is <code title=dom-mediatrack-kind-chapters>chapters</code>, the user
+ non-visual fashion; and for text tracks whose <a href=#text-track-kind title="text track kind">kind</a> is <code title=dom-mediatrack-kind-chapters>chapters</code>, the user
agent is making available to the user a mechanism by which the
user can navigate to any point in the <a href=#media-resource>media
resource</a> by selecting a cue.</p>
- <p>The <a href=#timed-track-showing-by-default title="timed track showing by default">showing by
+ <p>The <a href=#text-track-showing-by-default title="text track showing by default">showing by
default</a> state is used in conjunction with the <code title=attr-track-default><a href=#attr-track-default>default</a></code> attribute on
- <code><a href=#the-track-element>track</a></code> elements to indicate that the timed track was
+ <code><a href=#the-track-element>track</a></code> elements to indicate that the text track was
enabled due to that attribute. This allows the user agent to
override the state if a later track is discovered that is more
appropriate per the user's preferences.</p>
@@ -27653,177 +27651,177 @@
</dl></dd>
- <dt><dfn id=timed-track-list-of-cues title="timed track list of cues">A list of zero or more cues</dfn>
+ <dt><dfn id=text-track-list-of-cues title="text track list of cues">A list of zero or more cues</dfn>
<dd>
- <p>A list of <a href=#timed-track-cue title="timed track cue">timed track
- cues</a>, along with <dfn id=rules-for-updating-the-timed-track-rendering>rules for updating the timed track
+ <p>A list of <a href=#text-track-cue title="text track cue">text track
+ cues</a>, along with <dfn id=rules-for-updating-the-text-track-rendering>rules for updating the text track
rendering</dfn>.
<!--TTVTT-->
- For example, for <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating
- the display of WebVTT timed tracks</a>.
+ For example, for <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating
+ the display of WebVTT text tracks</a>.
<!--TTVTT-->
</p>
- <p>The <a href=#timed-track-list-of-cues title="timed track list of cues">list of cues of a
- timed track</a> can change dynamically, either because the
- <a href=#timed-track>timed track</a> has <a href=#timed-track-not-loaded title="timed track not
- loaded">not yet been loaded</a> or is still <a href=#timed-track-loading title="timed
- track loading">loading</a>, or because the <a href=#timed-track>timed
- track</a> corresponds to a <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code>
+ <p>The <a href=#text-track-list-of-cues title="text track list of cues">list of cues of a
+ text track</a> can change dynamically, either because the
+ <a href=#text-track>text track</a> has <a href=#text-track-not-loaded title="text track not
+ loaded">not yet been loaded</a> or is still <a href=#text-track-loading title="text
+ track loading">loading</a>, or because the <a href=#text-track>text
+ track</a> corresponds to a <code><a href=#mutabletexttrack>MutableTextTrack</a></code>
object, whose API allows individual cues can be added or removed
dynamically.</p>
</dd>
- </dl><p>Each <a href=#timed-track>timed track</a> has a corresponding
- <code><a href=#timedtrack>TimedTrack</a></code> object.</p>
+ </dl><p>Each <a href=#text-track>text track</a> has a corresponding
+ <code><a href=#texttrack>TextTrack</a></code> object.</p>
- <p>The <a href=#timed-track title="timed track">timed tracks</a> of a
- <a href=#media-element>media element</a> are <dfn id=the-timed-tracks-are-ready title="the timed tracks are
- ready">ready</dfn> if all the <a href=#timed-track title="timed track">timed
- tracks</a> whose <a href=#timed-track-mode title="timed track mode">mode</a> was
- not in the <a href=#timed-track-disabled title="timed track disabled">disabled</a> state
+ <p>The <a href=#text-track title="text track">text tracks</a> of a
+ <a href=#media-element>media element</a> are <dfn id=the-text-tracks-are-ready title="the text tracks are
+ ready">ready</dfn> if all the <a href=#text-track title="text track">text
+ tracks</a> whose <a href=#text-track-mode title="text track mode">mode</a> was
+ not in the <a href=#text-track-disabled title="text track disabled">disabled</a> state
when the element's <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource selection
- algorithm</a> last started now have a <a href=#timed-track-readiness-state>timed track readiness
- state</a> of <a href=#timed-track-loaded title="timed track loaded">loaded</a> or
- <a href=#timed-track-failed-to-load title="timed track failed to load">failed to load</a>.</p>
+ algorithm</a> last started now have a <a href=#text-track-readiness-state>text track readiness
+ state</a> of <a href=#text-track-loaded title="text track loaded">loaded</a> or
+ <a href=#text-track-failed-to-load title="text track failed to load">failed to load</a>.</p>
- <hr><p>A <dfn id=timed-track-cue>timed track cue</dfn> is the unit of time-sensitive data
- in a <a href=#timed-track>timed track</a>, corresponding for instance for
+ <hr><p>A <dfn id=text-track-cue>text track cue</dfn> is the unit of time-sensitive data
+ in a <a href=#text-track>text track</a>, corresponding for instance for
subtitles and captions to the text that appears at a particular time
and disappears at another time.</p>
- <p>Each <a href=#timed-track-cue>timed track cue</a> consists of:</p>
+ <p>Each <a href=#text-track-cue>text track cue</a> consists of:</p>
- <dl><dt><dfn id=timed-track-cue-identifier title="timed track cue identifier">An identifier</dfn>
+ <dl><dt><dfn id=text-track-cue-identifier title="text track cue identifier">An identifier</dfn>
<dd>
<p>An arbitrary string.</p>
</dd>
- <dt><dfn id=timed-track-cue-start-time title="timed track cue start time">A start time</dfn>
+ <dt><dfn id=text-track-cue-start-time title="text track cue start time">A start time</dfn>
<dd>
<p>A time, in seconds and fractions of a second, at which the cue
becomes relevant.</p>
</dd>
- <dt><dfn id=timed-track-cue-end-time title="timed track cue end time">An end time</dfn>
+ <dt><dfn id=text-track-cue-end-time title="text track cue end time">An end time</dfn>
<dd>
<p>A time, in seconds and fractions of a second, at which the cue
stops being relevant.</p>
</dd>
- <dt><dfn id=timed-track-cue-pause-on-exit-flag title="timed track cue pause-on-exit flag">A pause-on-exit flag</dfn>
+ <dt><dfn id=text-track-cue-pause-on-exit-flag title="text track cue pause-on-exit flag">A pause-on-exit flag</dfn>
<dd>
<p>A boolean indicating whether playback of the <a href=#media-resource>media
resource</a> is to pause when the cue stops being relevant.</p>
</dd>
- <dt><dfn id=timed-track-cue-writing-direction title="timed track cue writing direction">A writing direction</dfn>
+ <dt><dfn id=text-track-cue-writing-direction title="text track cue writing direction">A writing direction</dfn>
<dd>
- <p>A writing direction, either <dfn id=timed-track-cue-horizontal-writing-direction title="timed track cue
+ <p>A writing direction, either <dfn id=text-track-cue-horizontal-writing-direction title="text track cue
horizontal writing direction">horizontal</dfn> (a line extends
horizontally and is positioned vertically, with consecutive lines
- displayed below each other), <dfn id=timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical
+ displayed below each other), <dfn id=text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical
growing left writing direction">vertical growing left</dfn> (a
line extends vertically and is positioned horizontally, with
consecutive lines displayed to the left of each other<!-- used
- for east asian-->), or <dfn id=timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical
+ for east asian-->), or <dfn id=text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical
growing right writing direction">vertical growing right</dfn> (a
line extends vertically and is positioned horizontally, with
consecutive lines displayed to the right of each other<!-- used for
mongolian -->).</p>
<!--TTVTT-->
- <p>If the <a href=#timed-track-cue-writing-direction title="timed track cue writing direction">writing
- direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal
- writing direction">horizontal</a>, then <a href=#timed-track-cue-line-position title="timed
+ <p>If the <a href=#text-track-cue-writing-direction title="text track cue writing direction">writing
+ direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal
+ writing direction">horizontal</a>, then <a href=#text-track-cue-line-position title="text
track cue line position">line position</a> percentages are
- relative to the height of the video, and <a href=#timed-track-cue-text-position title="timed track
- cue text position">text position</a> and <a href=#timed-track-cue-size title="timed
+ relative to the height of the video, and <a href=#text-track-cue-text-position title="text track
+ cue text position">text position</a> and <a href=#text-track-cue-size title="text
track cue size">size</a> percentages are relative to the width
of the video.</p>
- <p>Otherwise, <a href=#timed-track-cue-line-position title="timed track cue line position">line
+ <p>Otherwise, <a href=#text-track-cue-line-position title="text track cue line position">line
position</a> percentages are relative to the width of the
- video, and <a href=#timed-track-cue-text-position title="timed track cue text position">text
- position</a> and <a href=#timed-track-cue-size title="timed track cue size">size</a>
+ video, and <a href=#text-track-cue-text-position title="text track cue text position">text
+ position</a> and <a href=#text-track-cue-size title="text track cue size">size</a>
percentages are relative to the height of the video.</p>
<!--TTVTT-->
</dd>
<!--TTVTT-->
- <dt><dfn id=timed-track-cue-snap-to-lines-flag title="timed track cue snap-to-lines flag">A snap-to-lines flag</dfn>
+ <dt><dfn id=text-track-cue-snap-to-lines-flag title="text track cue snap-to-lines flag">A snap-to-lines flag</dfn>
<dd>
- <p>A boolean indicating whether the <a href=#timed-track-cue-line-position title="timed track cue
+ <p>A boolean indicating whether the <a href=#text-track-cue-line-position title="text track cue
line position">line's position</a> is a line position
(positioned to a multiple of the line dimensions of the first line
of the cue), or whether it is a percentage of the dimension of the
video.</p>
</dd>
- <dt><dfn id=timed-track-cue-line-position title="timed track cue line position">A line position</dfn>
+ <dt><dfn id=text-track-cue-line-position title="text track cue line position">A line position</dfn>
<dd>
<p>Either a number giving the position of the lines of the cue, to
- be interpreted as defined by the <a href=#timed-track-cue-writing-direction title="timed track cue
- writing direction">writing direction</a> and <a href=#timed-track-cue-snap-to-lines-flag title="timed
+ be interpreted as defined by the <a href=#text-track-cue-writing-direction title="text track cue
+ writing direction">writing direction</a> and <a href=#text-track-cue-snap-to-lines-flag title="text
track cue snap-to-lines flag">snap-to-lines flag</a> of the
- cue, or the special value <dfn id=timed-track-cue-automatic-line-position title="timed track cue automatic line
+ cue, or the special value <dfn id=text-track-cue-automatic-line-position title="text track cue automatic line
position">auto</dfn>, which means the position is to depend on
the other active tracks.</p>
</dd>
- <dt><dfn id=timed-track-cue-text-position title="timed track cue text position">A text position</dfn>
+ <dt><dfn id=text-track-cue-text-position title="text track cue text position">A text position</dfn>
<dd>
<p>A number giving the position of the text of the cue within each
line, to be interpreted as a percentage of the video, as defined
- by the <a href=#timed-track-cue-writing-direction title="timed track cue writing direction">writing
+ by the <a href=#text-track-cue-writing-direction title="text track cue writing direction">writing
direction</a>.</p>
</dd>
<!--TTVTT-->
- <dt><dfn id=timed-track-cue-size title="timed track cue size">A size</dfn>
+ <dt><dfn id=text-track-cue-size title="text track cue size">A size</dfn>
<dd>
<p>A number giving the size of the box within which the text of
each line of the cue is to be aligned, to be interpreted as a
- percentage of the video, as defined by the <a href=#timed-track-cue-writing-direction title="timed
+ percentage of the video, as defined by the <a href=#text-track-cue-writing-direction title="text
track cue writing direction">writing direction</a>.</p>
</dd>
<!--TTVTT-->
- <dt><dfn id=timed-track-cue-alignment title="timed track cue alignment">An alignment</dfn>
+ <dt><dfn id=text-track-cue-alignment title="text track cue alignment">An alignment</dfn>
<dd>
- <p>An alignment for the text of each line of the cue, either <dfn id=timed-track-cue-start-alignment title="timed track cue start alignment">start alignment</dfn> (the
- text is aligned towards its start side), <dfn id=timed-track-cue-middle-alignment title="timed track
+ <p>An alignment for the text of each line of the cue, either <dfn id=text-track-cue-start-alignment title="text track cue start alignment">start alignment</dfn> (the
+ text is aligned towards its start side), <dfn id=text-track-cue-middle-alignment title="text track
cue middle alignment">middle alignment</dfn> (the text is aligned
- centered between its start and end sides), <dfn id=timed-track-cue-end-alignment title="timed track
+ centered between its start and end sides), <dfn id=text-track-cue-end-alignment title="text track
cue end alignment">end alignment</dfn> (the text is aligned
towards its end side). Which sides are the start and end sides
- depends on the Unicode bidirectional algorithm and the <a href=#timed-track-cue-writing-direction title="timed track cue writing direction">writing
+ depends on the Unicode bidirectional algorithm and the <a href=#text-track-cue-writing-direction title="text track cue writing direction">writing
direction</a>. <a href=#refsBIDI>[BIDI]</a></p>
</dd>
<!--TTVTT-->
- <dt><dfn id=timed-track-cue-text title="timed track cue text">The text of the cue</dfn>
+ <dt><dfn id=text-track-cue-text title="text track cue text">The text of the cue</dfn>
<dd>
<p>The raw text of the cue, and rules for its interpretation,
allowing the text to be rendered and converted to a DOM fragment.</p>
</dd>
- </dl><p>A <a href=#timed-track-cue>timed track cue</a> is immutable.</p>
+ </dl><p>A <a href=#text-track-cue>text track cue</a> is immutable.</p>
- <p>Each <a href=#timed-track-cue>timed track cue</a> has a corresponding
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> object, and can be associated with a
- particular <a href=#timed-track>timed track</a>. Once a <a href=#timed-track-cue>timed track
- cue</a> is associated with a particular <a href=#timed-track>timed track</a>,
+ <p>Each <a href=#text-track-cue>text track cue</a> has a corresponding
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object, and can be associated with a
+ particular <a href=#text-track>text track</a>. Once a <a href=#text-track-cue>text track
+ cue</a> is associated with a particular <a href=#text-track>text track</a>,
the association is permanent.</p>
- <p>In addition, each <a href=#timed-track-cue>timed track cue</a> has two pieces of
+ <p>In addition, each <a href=#text-track-cue>text track cue</a> has two pieces of
dynamic information:</p>
- <dl><dt>The <dfn id=timed-track-cue-active-flag title="timed track cue active flag">active flag</dfn>
+ <dl><dt>The <dfn id=text-track-cue-active-flag title="text track cue active flag">active flag</dfn>
<dd>
<p>This flag must be initially unset. The flag is used to ensure
@@ -27831,60 +27829,60 @@
inactive, and to make sure the right cues are rendered.</p>
<p>The user agent must synchronously unset this flag whenever the
- <a href=#timed-track-cue>timed track cue</a> is removed from its <a href=#timed-track>timed
- track</a>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>; whenever the
- <a href=#timed-track>timed track</a> itself is removed from its <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a> or has its
- <a href=#timed-track-mode>timed track mode</a> changed to <a href=#timed-track-disabled title="timed track
+ <a href=#text-track-cue>text track cue</a> is removed from its <a href=#text-track>text
+ track</a>'s <a href=#text-track-list-of-cues>text track list of cues</a>; whenever the
+ <a href=#text-track>text track</a> itself is removed from its <a href=#media-element>media
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a> or has its
+ <a href=#text-track-mode>text track mode</a> changed to <a href=#text-track-disabled title="text track
disabled">disabled</a>; and whenever the <a href=#media-element>media
element</a>'s <code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> is changed back to
<code title=dom-media-HAVE_NOTHING><a href=#dom-media-have_nothing>HAVE_NOTHING</a></code>. When the
- flag is unset in this way for one or more cues in <a href=#timed-track title="timed track">timed tracks</a> that were <a href=#timed-track-showing title="timed track showing">showing</a> or <a href=#timed-track-showing-by-default title="timed
+ flag is unset in this way for one or more cues in <a href=#text-track title="text track">text tracks</a> that were <a href=#text-track-showing title="text track showing">showing</a> or <a href=#text-track-showing-by-default title="text
track showing by default">showing by default</a> prior to the
relevant incident, the user agent must, after having unset the
- flag for all the affected cues, apply the <a href=#rules-for-updating-the-timed-track-rendering>rules for updating
- the timed track rendering</a> of those <a href=#timed-track title="timed
- track">timed tracks</a>.
+ flag for all the affected cues, apply the <a href=#rules-for-updating-the-text-track-rendering>rules for updating
+ the text track rendering</a> of those <a href=#text-track title="text
+ track">text tracks</a>.
<!--TTVTT-->
- For example, for <a href=#timed-track title="timed track">timed tracks</a>
- based on <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the
- display of WebVTT timed tracks</a>.</p>
+ For example, for <a href=#text-track title="text track">text tracks</a>
+ based on <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the
+ display of WebVTT text tracks</a>.</p>
<!--TTVTT-->
</dd>
- <dt>The <dfn id=timed-track-cue-display-state title="timed track cue display state">display state</dfn>
+ <dt>The <dfn id=text-track-cue-display-state title="text track cue display state">display state</dfn>
<dd>
<p>This is used as part of the rendering model, to keep cues in a
consistent position. It must initially be empty. Whenever the
- <a href=#timed-track-cue-active-flag>timed track cue active flag</a> is unset, the user agent
- must empty the <a href=#timed-track-cue-display-state>timed track cue display state</a>.</p>
+ <a href=#text-track-cue-active-flag>text track cue active flag</a> is unset, the user agent
+ must empty the <a href=#text-track-cue-display-state>text track cue display state</a>.</p>
</dd>
- </dl><p>The <a href=#timed-track-cue title="timed track cue">timed track cues</a> of a
- <a href=#media-element>media element</a>'s <a href=#timed-track title="timed track">timed
- tracks</a> are ordered relative to each other in the <dfn id=timed-track-cue-order>timed
+ </dl><p>The <a href=#text-track-cue title="text track cue">text track cues</a> of a
+ <a href=#media-element>media element</a>'s <a href=#text-track title="text track">text
+ tracks</a> are ordered relative to each other in the <dfn id=text-track-cue-order>text
track cue order</dfn>, which is determined as follows: first group
- the <a href=#timed-track-cue title="timed track cue">cues</a> by their <a href=#timed-track>timed
+ the <a href=#text-track-cue title="text track cue">cues</a> by their <a href=#text-track>text
track</a>, with the groups being sorted in the same order as
- their <a href=#timed-track title="timed track">timed tracks</a> appear in the
- <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>;
- then, within each group, <a href=#timed-track-cue title="timed track cue">cues</a>
- must be sorted by their <a href=#timed-track-cue-start-time title="timed track cue start
- time">start time</a>, earliest first; then, any <a href=#timed-track-cue title="timed track cue">cues</a> with the same <a href=#timed-track-cue-start-time title="timed
+ their <a href=#text-track title="text track">text tracks</a> appear in the
+ <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>;
+ then, within each group, <a href=#text-track-cue title="text track cue">cues</a>
+ must be sorted by their <a href=#text-track-cue-start-time title="text track cue start
+ time">start time</a>, earliest first; then, any <a href=#text-track-cue title="text track cue">cues</a> with the same <a href=#text-track-cue-start-time title="text
track cue start time">start time</a> must be sorted by their
- <a href=#timed-track-cue-end-time title="timed track cue end time">end time</a>, earliest
- first; and finally, any <a href=#timed-track-cue title="timed track cue">cues</a>
- with identical <a href=#timed-track-cue-end-time title="timed track cue end time">end
+ <a href=#text-track-cue-end-time title="text track cue end time">end time</a>, earliest
+ first; and finally, any <a href=#text-track-cue title="text track cue">cues</a>
+ with identical <a href=#text-track-cue-end-time title="text track cue end time">end
times</a> must be sorted in the order they were created (so
e.g. for cues from a <a href=#webvtt>WebVTT</a> file, that would be the
order in which the cues were listed in the file).</p>
- <h6 id=sourcing-in-band-timed-tracks><span class=secno>4.8.10.10.2 </span>Sourcing in-band timed tracks</h6>
+ <h6 id=sourcing-in-band-text-tracks><span class=secno>4.8.10.10.2 </span>Sourcing in-band text tracks</h6>
- <p>A <dfn id=media-resource-specific-timed-track>media-resource-specific timed track</dfn> is a <a href=#timed-track>timed
+ <p>A <dfn id=media-resource-specific-text-track>media-resource-specific text track</dfn> is a <a href=#text-track>text
track</a> that corresponds to data found in the <a href=#media-resource>media
resource</a>.</p>
@@ -27896,62 +27894,62 @@
if the <a href=#media-resource>media resource</a> is a video.</p>
<p>When a <a href=#media-resource>media resource</a> contains data that the user
- agent recognises and supports as being equivalent to a <a href=#timed-track>timed
+ agent recognises and supports as being equivalent to a <a href=#text-track>text
track</a>, the user agent <a href=#found-a-media-resource-specific-timed-track>runs</a> the
- <dfn id=steps-to-expose-a-media-resource-specific-timed-track>steps to expose a media-resource-specific timed track</dfn>
+ <dfn id=steps-to-expose-a-media-resource-specific-text-track>steps to expose a media-resource-specific text track</dfn>
with the relevant data, as follows:</p>
- <ol><li><p>Associate the relevant data with a new <a href=#timed-track>timed
- track</a> and its corresponding new <code><a href=#timedtrack>TimedTrack</a></code>
- object. The <a href=#timed-track>timed track</a> is a
- <a href=#media-resource-specific-timed-track>media-resource-specific timed track</a>.</li>
+ <ol><li><p>Associate the relevant data with a new <a href=#text-track>text
+ track</a> and its corresponding new <code><a href=#texttrack>TextTrack</a></code>
+ object. The <a href=#text-track>text track</a> is a
+ <a href=#media-resource-specific-text-track>media-resource-specific text track</a>.</li>
- <li><p>Set the new <a href=#timed-track>timed track</a>'s <a href=#timed-track-kind title="timed track
- kind">kind</a>, <a href=#timed-track-label title="timed track label">label</a>,
- and <a href=#timed-track-language title="timed track language">language</a> based on the
+ <li><p>Set the new <a href=#text-track>text track</a>'s <a href=#text-track-kind title="text track
+ kind">kind</a>, <a href=#text-track-label title="text track label">label</a>,
+ and <a href=#text-track-language title="text track language">language</a> based on the
semantics of the relevant data, as defined by the relevant
specification.</li>
- <li><p>Populate the new <a href=#timed-track>timed track</a>'s <a href=#timed-track-list-of-cues title="timed track list of cues">list of cues</a> with the cues
- parsed so far, folllowing the <a href=#guidelines-for-exposing-cues-in-various-formats-as-timed-track-cues>guidelines for exposing
+ <li><p>Populate the new <a href=#text-track>text track</a>'s <a href=#text-track-list-of-cues title="text track list of cues">list of cues</a> with the cues
+ parsed so far, folllowing the <a href=#guidelines-for-exposing-cues-in-various-formats-as-text-track-cues>guidelines for exposing
cues</a>, and begin updating it dynamically as
necessary.</li>
<li>
- <p>Set the new <a href=#timed-track>timed track</a>'s <a href=#timed-track-readiness-state title="timed track
+ <p>Set the new <a href=#text-track>text track</a>'s <a href=#text-track-readiness-state title="text track
readiness state">readiness state</a> to the value that most
correctly describes the current state, and begin updating it
dynamically as necessary.</p>
<p class=example>For example, if the relevant data in the
<a href=#media-resource>media resource</a> has been fully parsed and completely
- describes the cues, then the <a href=#timed-track>timed track</a> would be
- <a href=#timed-track-loaded title="timed track loaded">loaded</a>. On the other hand,
+ describes the cues, then the <a href=#text-track>text track</a> would be
+ <a href=#text-track-loaded title="text track loaded">loaded</a>. On the other hand,
if the data for the cues is interleaved with the <a href=#media-data>media
data</a>, and the <a href=#media-resource>media resource</a> as a whole is
- still being downloaded, then the <a href=#timed-track-loading title="timed track
+ still being downloaded, then the <a href=#text-track-loading title="text track
loading">loading</a> state might be more accurate.</p>
</li>
- <li><p>Set the new <a href=#timed-track>timed track</a>'s <a href=#timed-track-mode title="timed
+ <li><p>Set the new <a href=#text-track>text track</a>'s <a href=#text-track-mode title="text
track mode">mode</a> to the mode consistent with the user's
preferences and the requirements of the relevant specification for
the data.</li>
- <li><p>Leave the <a href=#timed-track-list-of-cues>timed track list of cues</a> empty, and
- associate with it the <a href=#rules-for-updating-the-timed-track-rendering>rules for updating the timed track
+ <li><p>Leave the <a href=#text-track-list-of-cues>text track list of cues</a> empty, and
+ associate with it the <a href=#rules-for-updating-the-text-track-rendering>rules for updating the text track
rendering</a> appropriate for the format in question.</p>
- <li><p>Add the new <a href=#timed-track>timed track</a> to the <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>.</li>
+ <li><p>Add the new <a href=#text-track>text track</a> to the <a href=#media-element>media
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>.</li>
- </ol><p>When a <a href=#media-element>media element</a> is to <dfn id="forget-the-media-element's-media-resource-specific-timed-tracks">forget the media
- element's media-resource-specific timed tracks</dfn>, the user
- agent must remove from the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list
- of timed tracks</a> all the <a href=#media-resource-specific-timed-track title="media-resource-specific
- timed track">media-resource-specific timed tracks</a>.</p>
+ </ol><p>When a <a href=#media-element>media element</a> is to <dfn id="forget-the-media-element's-media-resource-specific-text-tracks">forget the media
+ element's media-resource-specific text tracks</dfn>, the user
+ agent must remove from the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list
+ of text tracks</a> all the <a href=#media-resource-specific-text-track title="media-resource-specific
+ text track">media-resource-specific text tracks</a>.</p>
</div>
@@ -27959,108 +27957,108 @@
<div class=impl>
- <h6 id=sourcing-out-of-band-timed-tracks><span class=secno>4.8.10.10.3 </span>Sourcing out-of-band timed tracks</h6>
+ <h6 id=sourcing-out-of-band-text-tracks><span class=secno>4.8.10.10.3 </span>Sourcing out-of-band text tracks</h6>
<p>When a <code><a href=#the-track-element>track</a></code> element is created, it must be
- associated with a new <a href=#timed-track>timed track</a> (with its value set
- as defined below) and its corresponding new <code><a href=#timedtrack>TimedTrack</a></code>
+ associated with a new <a href=#text-track>text track</a> (with its value set
+ as defined below) and its corresponding new <code><a href=#texttrack>TextTrack</a></code>
object.</p>
- <p>The <a href=#timed-track-kind>timed track kind</a> is determined from the state of
+ <p>The <a href=#text-track-kind>text track kind</a> is determined from the state of
the element's <code title=attr-track-kind><a href=#attr-track-kind>kind</a></code> attribute
according to the following table; for a state given in a cell of the
- first column, the <a href=#timed-track-kind title="timed track kind">kind</a> is the
+ first column, the <a href=#text-track-kind title="text track kind">kind</a> is the
string given in the second column:</p>
<table><thead><tr><th>State
<th>String
<tbody><tr><td><a href=#attr-track-kind-subtitles title=attr-track-kind-subtitles>Subtitles</a>
- <td><code title=dom-timedtrack-kind-subtitles><a href=#dom-timedtrack-kind-subtitles>subtitles</a></code>
+ <td><code title=dom-timedtrack-kind-subtitles>subtitles</code>
<tr><td><a href=#attr-track-kind-captions title=attr-track-kind-captions>Captions</a>
- <td><code title=dom-timedtrack-kind-captions><a href=#dom-timedtrack-kind-captions>captions</a></code>
+ <td><code title=dom-timedtrack-kind-captions>captions</code>
<tr><td><a href=#attr-track-kind-descriptions title=attr-track-kind-descriptions>Descriptions</a>
- <td><code title=dom-timedtrack-kind-descriptions><a href=#dom-timedtrack-kind-descriptions>descriptions</a></code>
+ <td><code title=dom-timedtrack-kind-descriptions>descriptions</code>
<tr><td><a href=#attr-track-kind-chapters title=attr-track-kind-chapters>Chapters</a>
- <td><code title=dom-timedtrack-kind-chapters><a href=#dom-timedtrack-kind-chapters>chapters</a></code>
+ <td><code title=dom-timedtrack-kind-chapters>chapters</code>
<tr><td><a href=#attr-track-kind-metadata title=attr-track-kind-metadata>Metadata</a>
- <td><code title=dom-timedtrack-kind-metadata><a href=#dom-timedtrack-kind-metadata>metadata</a></code>
- </table><p>The <a href=#timed-track-label>timed track label</a> is the element's <a href=#track-label>track
+ <td><code title=dom-timedtrack-kind-metadata>metadata</code>
+ </table><p>The <a href=#text-track-label>text track label</a> is the element's <a href=#track-label>track
label</a>.</p>
- <p>The <a href=#timed-track-language>timed track language</a> is the element's
+ <p>The <a href=#text-track-language>text track language</a> is the element's
<a href=#track-language>track language</a>, if any, or the empty string
otherwise.</p>
<p>As the <code title=attr-track-kind><a href=#attr-track-kind>kind</a></code>, <code title=attr-track-label><a href=#attr-track-label>label</a></code>, and <code title=attr-track-srclang><a href=#attr-track-srclang>srclang</a></code> attributes are added,
- removed, or changed, the <a href=#timed-track>timed track</a> must update
+ removed, or changed, the <a href=#text-track>text track</a> must update
accordingly, as per the definitions above.</p>
<p class=note>Changes to the <a href=#track-url>track URL</a> are handled in
the algorithm below.</p>
- <p>The <a href=#timed-track-list-of-cues>timed track list of cues</a> is initially empty. It
+ <p>The <a href=#text-track-list-of-cues>text track list of cues</a> is initially empty. It
is dynamically modified when the referenced file is parsed.
- Associated with the list are the <a href=#rules-for-updating-the-timed-track-rendering>rules for updating the timed
+ Associated with the list are the <a href=#rules-for-updating-the-text-track-rendering>rules for updating the text
track rendering</a> appropriate for the format in question; for
- <a href=#webvtt>WebVTT</a>, this is the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the
- display of WebVTT timed tracks</a>.</p>
+ <a href=#webvtt>WebVTT</a>, this is the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the
+ display of WebVTT text tracks</a>.</p>
<p>When a <code><a href=#the-track-element>track</a></code> element's parent element changes and
the new parent is a <a href=#media-element>media element</a>, then the user agent
- must add the <code><a href=#the-track-element>track</a></code> element's corresponding <a href=#timed-track>timed
- track</a> to the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed
+ must add the <code><a href=#the-track-element>track</a></code> element's corresponding <a href=#text-track>text
+ track</a> to the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text
tracks</a>.</p>
<p>When a <code><a href=#the-track-element>track</a></code> element's parent element changes and
the old parent was a <a href=#media-element>media element</a>, then the user agent
must remove the <code><a href=#the-track-element>track</a></code> element's corresponding
- <a href=#timed-track>timed track</a> from the <a href=#media-element>media element</a>'s
- <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ <a href=#text-track>text track</a> from the <a href=#media-element>media element</a>'s
+ <a href=#list-of-text-tracks>list of text tracks</a>.</p>
- <p>When a <a href=#timed-track>timed track</a> corresponding to a
+ <p>When a <a href=#text-track>text track</a> corresponding to a
<code><a href=#the-track-element>track</a></code> element is added to a <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>, the user agent
- must set the <a href=#timed-track-mode>timed track mode</a> appropriately, as
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>, the user agent
+ must set the <a href=#text-track-mode>text track mode</a> appropriately, as
determined by the following conditions:</p>
- <dl class=switch><dt>If the <a href=#timed-track-kind>timed track kind</a> is <code title=dom-TimedTrack-kind-subtitles><a href=#dom-timedtrack-kind-subtitles>subtitles</a></code> or <code title=dom-TimedTrack-kind-captions><a href=#dom-timedtrack-kind-captions>captions</a></code> and the user
- has indicated an interest in having a track with this <a href=#timed-track-kind>timed
- track kind</a>, <a href=#timed-track-language>timed track language</a>, and
- <a href=#timed-track-label>timed track label</a> enabled, and there is no other
- <a href=#timed-track>timed track</a> in the <a href=#media-element>media element</a>'s
- <a href=#list-of-timed-tracks>list of timed tracks</a> with a <a href=#timed-track-kind>timed track
- kind</a> of either <code title=dom-TimedTrack-kind-subtitles><a href=#dom-timedtrack-kind-subtitles>subtitles</a></code> or <code title=dom-TimedTrack-kind-captions><a href=#dom-timedtrack-kind-captions>captions</a></code> whose
- <a href=#timed-track-mode>timed track mode</a> is <a href=#timed-track-showing title="timed track
+ <dl class=switch><dt>If the <a href=#text-track-kind>text track kind</a> is <code title=dom-TextTrack-kind-subtitles><a href=#dom-texttrack-kind-subtitles>subtitles</a></code> or <code title=dom-TextTrack-kind-captions><a href=#dom-texttrack-kind-captions>captions</a></code> and the user
+ has indicated an interest in having a track with this <a href=#text-track-kind>text
+ track kind</a>, <a href=#text-track-language>text track language</a>, and
+ <a href=#text-track-label>text track label</a> enabled, and there is no other
+ <a href=#text-track>text track</a> in the <a href=#media-element>media element</a>'s
+ <a href=#list-of-text-tracks>list of text tracks</a> with a <a href=#text-track-kind>text track
+ kind</a> of either <code title=dom-TextTrack-kind-subtitles><a href=#dom-texttrack-kind-subtitles>subtitles</a></code> or <code title=dom-TextTrack-kind-captions><a href=#dom-texttrack-kind-captions>captions</a></code> whose
+ <a href=#text-track-mode>text track mode</a> is <a href=#text-track-showing title="text track
showing">showing</a></dt>
- <dt>If the <a href=#timed-track-kind>timed track kind</a> is <code title=dom-TimedTrack-kind-descriptions><a href=#dom-timedtrack-kind-descriptions>descriptions</a></code> and
+ <dt>If the <a href=#text-track-kind>text track kind</a> is <code title=dom-TextTrack-kind-descriptions><a href=#dom-texttrack-kind-descriptions>descriptions</a></code> and
the user has indicated an interest in having text descriptions with
- this <a href=#timed-track-language>timed track language</a> and <a href=#timed-track-label>timed track
- label</a> enabled, and there is no other <a href=#timed-track>timed
- track</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of
- timed tracks</a> with a <a href=#timed-track-kind>timed track kind</a> of <code title=dom-TimedTrack-kind-descriptions><a href=#dom-timedtrack-kind-descriptions>descriptions</a></code> whose
- <a href=#timed-track-mode>timed track mode</a> is <a href=#timed-track-showing title="timed track
+ this <a href=#text-track-language>text track language</a> and <a href=#text-track-label>text track
+ label</a> enabled, and there is no other <a href=#text-track>text
+ track</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of
+ text tracks</a> with a <a href=#text-track-kind>text track kind</a> of <code title=dom-TextTrack-kind-descriptions><a href=#dom-texttrack-kind-descriptions>descriptions</a></code> whose
+ <a href=#text-track-mode>text track mode</a> is <a href=#text-track-showing title="text track
showing">showing</a></dt>
- <dt>If the <a href=#timed-track-kind>timed track kind</a> is <code title=dom-TimedTrack-kind-chapters><a href=#dom-timedtrack-kind-chapters>chapters</a></code> and the
- <a href=#timed-track-language>timed track language</a> is one that the user agent has
+ <dt>If the <a href=#text-track-kind>text track kind</a> is <code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code> and the
+ <a href=#text-track-language>text track language</a> is one that the user agent has
reason to believe is appropriate for the user, and there is no
- other <a href=#timed-track>timed track</a> in the <a href=#media-element>media element</a>'s
- <a href=#list-of-timed-tracks>list of timed tracks</a> with a <a href=#timed-track-kind>timed track
- kind</a> of <code title=dom-TimedTrack-kind-chapters><a href=#dom-timedtrack-kind-chapters>chapters</a></code> whose
- <a href=#timed-track-mode>timed track mode</a> is <a href=#timed-track-showing title="timed track
+ other <a href=#text-track>text track</a> in the <a href=#media-element>media element</a>'s
+ <a href=#list-of-text-tracks>list of text tracks</a> with a <a href=#text-track-kind>text track
+ kind</a> of <code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code> whose
+ <a href=#text-track-mode>text track mode</a> is <a href=#text-track-showing title="text track
showing">showing</a></dt>
<dd>
- <p>Let the <a href=#timed-track-mode>timed track mode</a> be <a href=#timed-track-showing title="timed
+ <p>Let the <a href=#text-track-mode>text track mode</a> be <a href=#text-track-showing title="text
track showing">showing</a>.</p>
- <p>If there is a <a href=#timed-track>timed track</a> in the <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a> whose
- <a href=#timed-track-mode>timed track mode</a> is <a href=#timed-track-showing-by-default title="timed track showing
+ <p>If there is a <a href=#text-track>text track</a> in the <a href=#media-element>media
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a> whose
+ <a href=#text-track-mode>text track mode</a> is <a href=#text-track-showing-by-default title="text track showing
by default">showing by default</a>, the user agent must
- furthermore change <em>that</em> <a href=#timed-track>timed track</a>'s
- <a href=#timed-track-mode>timed track mode</a> to <a href=#timed-track-hidden title="timed track
+ furthermore change <em>that</em> <a href=#text-track>text track</a>'s
+ <a href=#text-track-mode>text track mode</a> to <a href=#text-track-hidden title="text track
hidden">hidden</a>.</p> <!-- so that we still get events and
stuff: we can expect authors to forget that default doesn't mean
that it'll always be turned on, and that they'll still rely on
@@ -28069,34 +28067,34 @@
</dd>
<dt>If the <code><a href=#the-track-element>track</a></code> element has a <code title=attr-track-default><a href=#attr-track-default>default</a></code> attribute specified, and
- there is no other <a href=#timed-track>timed track</a> in the <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a> whose
- <a href=#timed-track-mode>timed track mode</a> is <a href=#timed-track-showing title="timed track
- showing">showing</a> or <a href=#timed-track-showing-by-default title="timed track
+ there is no other <a href=#text-track>text track</a> in the <a href=#media-element>media
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a> whose
+ <a href=#text-track-mode>text track mode</a> is <a href=#text-track-showing title="text track
+ showing">showing</a> or <a href=#text-track-showing-by-default title="text track
showing by default">showing by default</a></dt>
<dd>
- <p>Let the <a href=#timed-track-mode>timed track mode</a> be <a href=#timed-track-showing-by-default title="timed
+ <p>Let the <a href=#text-track-mode>text track mode</a> be <a href=#text-track-showing-by-default title="text
track showing by default">showing by default</a>.</p>
</dd>
<dt>Otherwise</dt>
<dd>
- <p>Let the <a href=#timed-track-mode>timed track mode</a> be <a href=#timed-track-disabled title="timed
+ <p>Let the <a href=#text-track-mode>text track mode</a> be <a href=#text-track-disabled title="text
track disabled">disabled</a>.</p>
</dd>
- </dl><p>When a <a href=#timed-track>timed track</a> corresponding to a
- <code><a href=#the-track-element>track</a></code> element is created with <a href=#timed-track-mode>timed track
- mode</a> set to <a href=#timed-track-hidden title="timed track hidden">hidden</a>,
- <a href=#timed-track-showing title="timed track showing">showing</a>, or <a href=#timed-track-showing-by-default title="timed track showing by default">showing by default</a>,
- and when a <a href=#timed-track>timed track</a> corresponding to a
- <code><a href=#the-track-element>track</a></code> element is created with <a href=#timed-track-mode>timed track
- mode</a> set to <a href=#timed-track-disabled title="timed track
- disabled">disabled</a> and subsequently changes its <a href=#timed-track-mode>timed
- track mode</a> to <a href=#timed-track-hidden title="timed track hidden">hidden</a>,
- <a href=#timed-track-showing title="timed track showing">showing</a>, or <a href=#timed-track-showing-by-default title="timed track showing by default">showing by default</a> for
+ </dl><p>When a <a href=#text-track>text track</a> corresponding to a
+ <code><a href=#the-track-element>track</a></code> element is created with <a href=#text-track-mode>text track
+ mode</a> set to <a href=#text-track-hidden title="text track hidden">hidden</a>,
+ <a href=#text-track-showing title="text track showing">showing</a>, or <a href=#text-track-showing-by-default title="text track showing by default">showing by default</a>,
+ and when a <a href=#text-track>text track</a> corresponding to a
+ <code><a href=#the-track-element>track</a></code> element is created with <a href=#text-track-mode>text track
+ mode</a> set to <a href=#text-track-disabled title="text track
+ disabled">disabled</a> and subsequently changes its <a href=#text-track-mode>text
+ track mode</a> to <a href=#text-track-hidden title="text track hidden">hidden</a>,
+ <a href=#text-track-showing title="text track showing">showing</a>, or <a href=#text-track-showing-by-default title="text track showing by default">showing by default</a> for
the first time, the user agent must immediately and synchronously
run the following algorithm. This algorithm interacts closely with
the <a href=#event-loop>event loop</a> mechanism; in particular, it has a
@@ -28104,14 +28102,14 @@
<a href=#event-loop>event loop</a> algorithm). The step in that section is
marked with ⌛.</p>
- <ol><li><p>Set the <a href=#timed-track-readiness-state>timed track readiness state</a> to <a href=#timed-track-loading title="timed track loading">loading</a>.</li>
+ <ol><li><p>Set the <a href=#text-track-readiness-state>text track readiness state</a> to <a href=#text-track-loading title="text track loading">loading</a>.</li>
<li><p>Let <var title="">URL</var> be the <a href=#track-url>track URL</a> of
the <code><a href=#the-track-element>track</a></code> element.</li>
<li><p>Asynchronously run the remaining steps, while continuing
- with whatever task was responsible for creating the <a href=#timed-track>timed
- track</a> or changing the <a href=#timed-track-mode>timed track
+ with whatever task was responsible for creating the <a href=#text-track>text
+ track</a> or changing the <a href=#text-track-mode>text track
mode</a>.</li>
<li>
@@ -28130,16 +28128,16 @@
process the data as it is being fetched must examine the
resource's <a href=#content-type title=Content-Type>Content Type
metadata</a>, once it is available, if it ever is. If no <a href=#content-type title=Content-Type>Content Type metadata</a> is ever
- available, or if the type is not recognised as a timed track
+ available, or if the type is not recognised as a text track
format, then the resource's format must be assumed to be
unsupported (this causes the load to fail, as described below). If
- a type is obtained, and represents a supported timed track format,
+ a type is obtained, and represents a supported text track format,
then the resource's data must be passed to the appropriate parser
<!--TTVTT-->
(e.g. the <a href=#webvtt-parser>WebVTT parser</a> if the <a href=#content-type title=Content-Type>Content Type metadata</a> is
<code><a href=#text/vtt>text/vtt</a></code>)
<!--TTVTT-->
- as it is received, with the <a href=#timed-track-list-of-cues>timed
+ as it is received, with the <a href=#text-track-list-of-cues>text
track list of cues</a> being used for that parser's output.</p>
<p>If the <a href=#fetch title=fetch>fetching algorithm</a> fails for
@@ -28148,8 +28146,8 @@
the empty string or has the wrong <a href=#origin>origin</a> as
determined by the condition at the start of this step, or if the
fetched resource is not in a supported format, then <a href=#queue-a-task>queue a
- task</a> to first change the <a href=#timed-track-readiness-state>timed track readiness
- state</a> to <a href=#timed-track-failed-to-load title="timed track failed to load">failed to
+ task</a> to first change the <a href=#text-track-readiness-state>text track readiness
+ state</a> to <a href=#text-track-failed-to-load title="text track failed to load">failed to
load</a> and then <a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-error>error</code> at the <code><a href=#the-track-element>track</a></code>
element; and then, once that <a href=#concept-task title=concept-task>task</a> is <a href=#queue-a-task title="queue a
task">queued</a>, move on to the step below labeled
@@ -28157,7 +28155,7 @@
<p>If the <a href=#fetch title=fetch>fetching algorithm</a> does not
fail, then, when it completes, <a href=#queue-a-task>queue a task</a> to first
- change the <a href=#timed-track-readiness-state>timed track readiness state</a> to <a href=#timed-track-loaded title="timed track loaded">loaded</a> and then <a href=#fire-a-simple-event>fire a
+ change the <a href=#text-track-readiness-state>text track readiness state</a> to <a href=#text-track-loaded title="text track loaded">loaded</a> and then <a href=#fire-a-simple-event>fire a
simple event</a> named <code title=event-load>load</code> at
the <code><a href=#the-track-element>track</a></code> element; and then, once that <a href=#concept-task title=concept-task>task</a> is <a href=#queue-a-task title="queue a
task">queued</a>, move on to the step below labeled
@@ -28167,14 +28165,14 @@
active, either:</p>
<ul><li>the <a href=#track-url>track URL</a> changes so that it is no longer
- equal to <var title="">URL</var>, while the <a href=#timed-track-mode>timed track
- mode</a> is set to <a href=#timed-track-hidden title="timed track
- hidden">hidden</a>, <a href=#timed-track-showing title="timed track
- showing">showing</a>, or <a href=#timed-track-showing-by-default title="timed track showing by
+ equal to <var title="">URL</var>, while the <a href=#text-track-mode>text track
+ mode</a> is set to <a href=#text-track-hidden title="text track
+ hidden">hidden</a>, <a href=#text-track-showing title="text track
+ showing">showing</a>, or <a href=#text-track-showing-by-default title="text track showing by
default">showing by default</a>; or</li>
- <li>the <a href=#timed-track-mode>timed track mode</a> changes to <a href=#timed-track-hidden title="timed track hidden">hidden</a>, <a href=#timed-track-showing title="timed
- track showing">showing</a>, or <a href=#timed-track-showing-by-default title="timed track
+ <li>the <a href=#text-track-mode>text track mode</a> changes to <a href=#text-track-hidden title="text track hidden">hidden</a>, <a href=#text-track-showing title="text
+ track showing">showing</a>, or <a href=#text-track-showing-by-default title="text track
showing by default">showing by default</a>, while the
<a href=#track-url>track URL</a> is not equal to <var title="">URL</var></li>
@@ -28200,21 +28198,21 @@
<li><p><i>Monitoring</i>: Wait until the <a href=#track-url>track URL</a> is
no longer equal to <var title="">URL</var>, at the same time as the
- <a href=#timed-track-mode>timed track mode</a> is set to <a href=#timed-track-hidden title="timed track
- hidden">hidden</a>, <a href=#timed-track-showing title="timed track
- showing">showing</a>, or <a href=#timed-track-showing-by-default title="timed track showing by
+ <a href=#text-track-mode>text track mode</a> is set to <a href=#text-track-hidden title="text track
+ hidden">hidden</a>, <a href=#text-track-showing title="text track
+ showing">showing</a>, or <a href=#text-track-showing-by-default title="text track showing by
default">showing by default</a>.</li>
- <li><p>Wait until the <a href=#timed-track-readiness-state>timed track readiness state</a> is
- no longer set to <a href=#timed-track-loading title="timed track
+ <li><p>Wait until the <a href=#text-track-readiness-state>text track readiness state</a> is
+ no longer set to <a href=#text-track-loading title="text track
loading">loading</a>.</li>
<li><p><a href=#await-a-stable-state>Await a stable state</a>. The <a href=#synchronous-section>synchronous
section</a> consists of the following step. (The step in the
<a href=#synchronous-section>synchronous section</a> is marked with ⌛.)</li>
- <li><p>⌛ Set the <a href=#timed-track-readiness-state>timed track readiness state</a> to
- <a href=#timed-track-loading title="timed track loading">loading</a>.</li>
+ <li><p>⌛ Set the <a href=#text-track-readiness-state>text track readiness state</a> to
+ <a href=#text-track-loading title="text track loading">loading</a>.</li>
<!-- if you add more, change the grammar of the sentences above to
be plural with respect to the number of synchronous steps (both in
@@ -28231,53 +28229,53 @@
<!--TTVTT-->
<div class=impl>
- <h6 id=guidelines-for-exposing-cues-in-various-formats-as-timed-track-cues><span class=secno>4.8.10.10.4 </span><dfn>Guidelines for exposing cues</dfn> in various formats as
- <a href=#timed-track-cue title="timed track cue">timed track cues</a></h6>
+ <h6 id=guidelines-for-exposing-cues-in-various-formats-as-text-track-cues><span class=secno>4.8.10.10.4 </span><dfn>Guidelines for exposing cues</dfn> in various formats as
+ <a href=#text-track-cue title="text track cue">text track cues</a></h6>
- <p>How a specific format's timed track cues are to be interpreted
+ <p>How a specific format's text track cues are to be interpreted
for the purposes of processing by an HTML user agent is defined by
that format. In the absence of such a specification, this section
provides some constraints within which implementations can attempt
to consistently expose such formats.</p>
- <p>To support the <a href=#timed-track>timed track</a> model of HTML, each unit
- of timed data is converted to a <a href=#timed-track-cue>timed track cue</a>. Where
- the mapping of the format's features to the aspects of a <a href=#timed-track-cue>timed
+ <p>To support the <a href=#text-track>text track</a> model of HTML, each unit
+ of timed data is converted to a <a href=#text-track-cue>text track cue</a>. Where
+ the mapping of the format's features to the aspects of a <a href=#text-track-cue>text
track cue</a> as defined in this specification are not defined,
implementations must ensure that the mapping is consistent with the
- definitions of the aspects of a <a href=#timed-track-cue>timed track cue</a> as
+ definitions of the aspects of a <a href=#text-track-cue>text track cue</a> as
defined above, as well as with the following constraints:</p>
- <dl><dt>The <a href=#timed-track-cue-identifier>timed track cue identifier</a>
+ <dl><dt>The <a href=#text-track-cue-identifier>text track cue identifier</a>
<dd>
<p>Should be set to the empty string if the format has no
obvious analogue to a per-cue identifier.</p>
</dd>
- <dt>The <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit flag</a>
+ <dt>The <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit flag</a>
<dd>
<p>Should be set to false.</p>
</dd>
- <dt>The <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a>
+ <dt>The <a href=#text-track-cue-writing-direction>text track cue writing direction</a>
<dd>
- <p>Should be set to <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing
+ <p>Should be set to <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing
direction">horizontal</a> if the concept of writing direction
doesn't really apply (e.g. the cue consists of a bitmap
image).</p>
</dd>
- <dt>The <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a>
+ <dt>The <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a>
<dd>
<p>Should be set to false unless the format uses a rendering and
positioning model for cues that is largely consistent with the
<a href=#webvtt-cue-text-rendering-rules>WebVTT cue text rendering rules</a>.</p>
</dd>
- <dt>The <a href=#timed-track-cue-line-position>timed track cue line position</a>
- <dt>The <a href=#timed-track-cue-text-position>timed track cue text position</a>
- <dt>The <a href=#timed-track-cue-size>timed track cue size</a>
- <dt>The <a href=#timed-track-cue-alignment>timed track cue alignment</a>
+ <dt>The <a href=#text-track-cue-line-position>text track cue line position</a>
+ <dt>The <a href=#text-track-cue-text-position>text track cue text position</a>
+ <dt>The <a href=#text-track-cue-size>text track cue size</a>
+ <dt>The <a href=#text-track-cue-alignment>text track cue alignment</a>
</dt></dt></dt><dd>
<p>If the format uses a rendering and positioning model for
cues that can be largely simulated using the <a href=#webvtt-cue-text-rendering-rules>WebVTT cue text
@@ -28290,21 +28288,21 @@
<!--TTVTT-->
- <h6 id=timed-track-api><span class=secno>4.8.10.10.5 </span>Timed track API</h6>
+ <h6 id=text-track-api><span class=secno>4.8.10.10.5 </span>Text track API</h6>
<dl class=domintro><dt><var title="">media</var> . <code title=dom-media-tracks><a href=#dom-media-tracks>tracks</a></code> . <code title="">length</code></dt>
<dd>
- <p>Returns the number of <a href=#timed-track title="timed track">timed tracks</a> associated with the <a href=#media-element>media element</a> (e.g. from <code><a href=#the-track-element>track</a></code> elements). This is the number of <a href=#timed-track title="timed track">timed tracks</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ <p>Returns the number of <a href=#text-track title="text track">text tracks</a> associated with the <a href=#media-element>media element</a> (e.g. from <code><a href=#the-track-element>track</a></code> elements). This is the number of <a href=#text-track title="text track">text tracks</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>.</p>
</dd>
<dt><var title="">media</var> . <code title=dom-media-tracks><a href=#dom-media-tracks>tracks[</a></code> <var title="">n</var> <code title="">]</code></dt>
<dd>
- <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object representing the <var title="">n</var>th <a href=#timed-track>timed track</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ <p>Returns the <code><a href=#texttrack>TextTrack</a></code> object representing the <var title="">n</var>th <a href=#text-track>text track</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>.</p>
</dd>
<dt><var title="">track</var> . <code title=dom-track-track><a href=#dom-track-track>track</a></code></dt>
<dd>
- <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object representing the <code><a href=#the-track-element>track</a></code> element's <a href=#timed-track>timed track</a>.</p>
+ <p>Returns the <code><a href=#texttrack>TextTrack</a></code> object representing the <code><a href=#the-track-element>track</a></code> element's <a href=#text-track>text track</a>.</p>
</dd>
</dl><div class=impl>
@@ -28312,150 +28310,150 @@
<p>The <dfn id=dom-media-tracks title=dom-media-tracks><code>tracks</code></dfn>
attribute of <a href=#media-element title="media element">media elements</a> must
return an <span title="array host objects">array host object</span>
- for objects of type <code><a href=#timedtrack>TimedTrack</a></code> that is <i>fixed
+ for objects of type <code><a href=#texttrack>TextTrack</a></code> that is <i>fixed
length</i> and <i>read only</i>. The same object must be returned
each time the attribute is accessed. <a href=#refsWEBIDL>[WEBIDL]</a></p>
- <p>The array must contain the <code><a href=#timedtrack>TimedTrack</a></code> objects of the
- <a href=#timed-track title="timed track">timed tracks</a> in the <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>, in the same
- order as in the <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ <p>The array must contain the <code><a href=#texttrack>TextTrack</a></code> objects of the
+ <a href=#text-track title="text track">text tracks</a> in the <a href=#media-element>media
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>, in the same
+ order as in the <a href=#list-of-text-tracks>list of text tracks</a>.</p>
</div>
- <hr><pre class=idl>interface <dfn id=timedtrack>TimedTrack</dfn> {
- readonly attribute DOMString <a href=#dom-timedtrack-kind title=dom-TimedTrack-kind>kind</a>;
- readonly attribute DOMString <a href=#dom-timedtrack-label title=dom-TimedTrack-label>label</a>;
- readonly attribute DOMString <a href=#dom-timedtrack-language title=dom-TimedTrack-language>language</a>;
+ <hr><pre class=idl>interface <dfn id=texttrack>TextTrack</dfn> {
+ readonly attribute DOMString <a href=#dom-texttrack-kind title=dom-TextTrack-kind>kind</a>;
+ readonly attribute DOMString <a href=#dom-texttrack-label title=dom-TextTrack-label>label</a>;
+ readonly attribute DOMString <a href=#dom-texttrack-language title=dom-TextTrack-language>language</a>;
- const unsigned short <a href=#dom-timedtrack-none title=dom-TimedTrack-NONE>NONE</a> = 0;
- const unsigned short <a href=#dom-timedtrack-loading title=dom-TimedTrack-LOADING>LOADING</a> = 1;
- const unsigned short <a href=#dom-timedtrack-loaded title=dom-TimedTrack-LOADED>LOADED</a> = 2;
- const unsigned short <a href=#dom-timedtrack-error title=dom-TimedTrack-ERROR>ERROR</a> = 3;
- readonly attribute unsigned short <a href=#dom-timedtrack-readystate title=dom-TimedTrack-readyState>readyState</a>;
- readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrack-onload title=handler-TimedTrack-onload>onload</a>;
- readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrack-onerror title=handler-TimedTrack-onerror>onerror</a>;
+ const unsigned short <a href=#dom-texttrack-none title=dom-TextTrack-NONE>NONE</a> = 0;
+ const unsigned short <a href=#dom-texttrack-loading title=dom-TextTrack-LOADING>LOADING</a> = 1;
+ const unsigned short <a href=#dom-texttrack-loaded title=dom-TextTrack-LOADED>LOADED</a> = 2;
+ const unsigned short <a href=#dom-texttrack-error title=dom-TextTrack-ERROR>ERROR</a> = 3;
+ readonly attribute unsigned short <a href=#dom-texttrack-readystate title=dom-TextTrack-readyState>readyState</a>;
+ readonly attribute <a href=#function>Function</a> <a href=#handler-texttrack-onload title=handler-TextTrack-onload>onload</a>;
+ readonly attribute <a href=#function>Function</a> <a href=#handler-texttrack-onerror title=handler-TextTrack-onerror>onerror</a>;
- const unsigned short <a href=#dom-timedtrack-off title=dom-TimedTrack-OFF>OFF</a> = 0;
- const unsigned short <a href=#dom-timedtrack-hidden title=dom-TimedTrack-HIDDEN>HIDDEN</a> = 1;
- const unsigned short <a href=#dom-timedtrack-showing title=dom-TimedTrack-SHOWING>SHOWING</a> = 2;
- attribute unsigned short <a href=#dom-timedtrack-mode title=dom-TimedTrack-mode>mode</a>;
+ const unsigned short <a href=#dom-texttrack-off title=dom-TextTrack-OFF>OFF</a> = 0;
+ const unsigned short <a href=#dom-texttrack-hidden title=dom-TextTrack-HIDDEN>HIDDEN</a> = 1;
+ const unsigned short <a href=#dom-texttrack-showing title=dom-TextTrack-SHOWING>SHOWING</a> = 2;
+ attribute unsigned short <a href=#dom-texttrack-mode title=dom-TextTrack-mode>mode</a>;
- readonly attribute <a href=#timedtrackcuelist>TimedTrackCueList</a> <a href=#dom-timedtrack-cues title=dom-TimedTrack-cues>cues</a>;
- readonly attribute <a href=#timedtrackcuelist>TimedTrackCueList</a> <a href=#dom-timedtrack-activecues title=dom-TimedTrack-activeCues>activeCues</a>;
+ readonly attribute <a href=#texttrackcuelist>TextTrackCueList</a> <a href=#dom-texttrack-cues title=dom-TextTrack-cues>cues</a>;
+ readonly attribute <a href=#texttrackcuelist>TextTrackCueList</a> <a href=#dom-texttrack-activecues title=dom-TextTrack-activeCues>activeCues</a>;
- readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrack-oncuechange title=handler-TimedTrack-oncuechange>oncuechange</a>;
+ readonly attribute <a href=#function>Function</a> <a href=#handler-texttrack-oncuechange title=handler-TextTrack-oncuechange>oncuechange</a>;
};</pre>
- <dl class=domintro><dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-kind><a href=#dom-timedtrack-kind>kind</a></code></dt>
+ <dl class=domintro><dt><var title="">timedTrack</var> . <code title=dom-TextTrack-kind><a href=#dom-texttrack-kind>kind</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-kind>timed track kind</a> string.</p>
+ <p>Returns the <a href=#text-track-kind>text track kind</a> string.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-label><a href=#dom-timedtrack-label>label</a></code></dt>
+ <dt><var title="">timedTrack</var> . <code title=dom-TextTrack-label><a href=#dom-texttrack-label>label</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-label>timed track label</a>.</p>
+ <p>Returns the <a href=#text-track-label>text track label</a>.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-language><a href=#dom-timedtrack-language>language</a></code></dt>
+ <dt><var title="">timedTrack</var> . <code title=dom-TextTrack-language><a href=#dom-texttrack-language>language</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-language>timed track language</a> string.</p>
+ <p>Returns the <a href=#text-track-language>text track language</a> string.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-readyState><a href=#dom-timedtrack-readystate>readyState</a></code></dt>
+ <dt><var title="">timedTrack</var> . <code title=dom-TextTrack-readyState><a href=#dom-texttrack-readystate>readyState</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-readiness-state>timed track readiness state</a>,
+ <p>Returns the <a href=#text-track-readiness-state>text track readiness state</a>,
represented by a number from the following list:</p>
- <dl><dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-NONE><a href=#dom-timedtrack-none>NONE</a></code> (0)</dt>
+ <dl><dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-NONE><a href=#dom-texttrack-none>NONE</a></code> (0)</dt>
<dd>
- <p>The <a href=#timed-track-not-loaded>timed track not loaded</a> state.</p>
+ <p>The <a href=#text-track-not-loaded>text track not loaded</a> state.</p>
</dd>
- <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-LOADING><a href=#dom-timedtrack-loading>LOADING</a></code> (1)</dt>
+ <dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-LOADING><a href=#dom-texttrack-loading>LOADING</a></code> (1)</dt>
<dd>
- <p>The <a href=#timed-track-loading>timed track loading</a> state.</p>
+ <p>The <a href=#text-track-loading>text track loading</a> state.</p>
</dd>
- <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-LOADED><a href=#dom-timedtrack-loaded>LOADED</a></code> (2)</dt>
+ <dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-LOADED><a href=#dom-texttrack-loaded>LOADED</a></code> (2)</dt>
<dd>
- <p>The <a href=#timed-track-loaded>timed track loaded</a> state.</p>
+ <p>The <a href=#text-track-loaded>text track loaded</a> state.</p>
</dd>
- <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-ERROR><a href=#dom-timedtrack-error>ERROR</a></code> (3)</dt>
+ <dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-ERROR><a href=#dom-texttrack-error>ERROR</a></code> (3)</dt>
<dd>
- <p>The <a href=#timed-track-failed-to-load>timed track failed to load</a> state.</p>
+ <p>The <a href=#text-track-failed-to-load>text track failed to load</a> state.</p>
</dd>
</dl></dd>
- <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-mode><a href=#dom-timedtrack-mode>mode</a></code></dt>
+ <dt><var title="">timedTrack</var> . <code title=dom-TextTrack-mode><a href=#dom-texttrack-mode>mode</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-mode>timed track mode</a>, represented by a
+ <p>Returns the <a href=#text-track-mode>text track mode</a>, represented by a
number from the following list:</p>
- <dl><dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-OFF><a href=#dom-timedtrack-off>OFF</a></code> (0)</dt>
+ <dl><dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-OFF><a href=#dom-texttrack-off>OFF</a></code> (0)</dt>
<dd>
- <p>The <a href=#timed-track-disabled>timed track disabled</a> mode.</p>
+ <p>The <a href=#text-track-disabled>text track disabled</a> mode.</p>
</dd>
- <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-HIDDEN><a href=#dom-timedtrack-hidden>HIDDEN</a></code> (1)</dt>
+ <dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-HIDDEN><a href=#dom-texttrack-hidden>HIDDEN</a></code> (1)</dt>
<dd>
- <p>The <a href=#timed-track-hidden>timed track hidden</a> mode.</p>
+ <p>The <a href=#text-track-hidden>text track hidden</a> mode.</p>
</dd>
- <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-SHOWING><a href=#dom-timedtrack-showing>SHOWING</a></code> (2)</dt>
+ <dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-SHOWING><a href=#dom-texttrack-showing>SHOWING</a></code> (2)</dt>
<dd>
- <p>The <a href=#timed-track-showing>timed track showing</a> and <a href=#timed-track-showing-by-default title="timed track showing by default">showing by default</a> modes.</p>
+ <p>The <a href=#text-track-showing>text track showing</a> and <a href=#text-track-showing-by-default title="text track showing by default">showing by default</a> modes.</p>
</dd>
</dl><p>Can be set, to change the mode.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-cues><a href=#dom-timedtrack-cues>cues</a></code></dt>
+ <dt><var title="">timedTrack</var> . <code title=dom-TextTrack-cues><a href=#dom-texttrack-cues>cues</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-list-of-cues>timed track list of cues</a>, as a <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+ <p>Returns the <a href=#text-track-list-of-cues>text track list of cues</a>, as a <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-activeCues><a href=#dom-timedtrack-activecues>activeCues</a></code></dt>
+ <dt><var title="">timedTrack</var> . <code title=dom-TextTrack-activeCues><a href=#dom-texttrack-activecues>activeCues</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue title="timed track cue">timed track cues</a> from the <a href=#timed-track-list-of-cues>timed track list of cues</a> that are currently active (i.e. that start before the <a href=#current-playback-position>current playback position</a> and end after it), as a <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+ <p>Returns the <a href=#text-track-cue title="text track cue">text track cues</a> from the <a href=#text-track-list-of-cues>text track list of cues</a> that are currently active (i.e. that start before the <a href=#current-playback-position>current playback position</a> and end after it), as a <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object.</p>
</dd>
</dl><div class=impl>
- <p>The <dfn id=dom-timedtrack-kind title=dom-TimedTrack-kind><code>kind</code></dfn>
- attribute must return the <a href=#timed-track-kind>timed track kind</a> of the
- <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
+ <p>The <dfn id=dom-texttrack-kind title=dom-TextTrack-kind><code>kind</code></dfn>
+ attribute must return the <a href=#text-track-kind>text track kind</a> of the
+ <a href=#text-track>text track</a> that the <code><a href=#texttrack>TextTrack</a></code> object
represents.</p>
- <p>The <dfn id=dom-timedtrack-label title=dom-TimedTrack-label><code>label</code></dfn>
- attribute must return the <a href=#timed-track-label>timed track label</a> of the
- <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
+ <p>The <dfn id=dom-texttrack-label title=dom-TextTrack-label><code>label</code></dfn>
+ attribute must return the <a href=#text-track-label>text track label</a> of the
+ <a href=#text-track>text track</a> that the <code><a href=#texttrack>TextTrack</a></code> object
represents.</p>
- <p>The <dfn id=dom-timedtrack-language title=dom-TimedTrack-language><code>language</code></dfn>
- attribute must return the <a href=#timed-track-language>timed track language</a> of the
- <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
+ <p>The <dfn id=dom-texttrack-language title=dom-TextTrack-language><code>language</code></dfn>
+ attribute must return the <a href=#text-track-language>text track language</a> of the
+ <a href=#text-track>text track</a> that the <code><a href=#texttrack>TextTrack</a></code> object
represents.</p>
- <p>The <dfn id=dom-timedtrack-readystate title=dom-TimedTrack-readyState><code>readyState</code></dfn>
+ <p>The <dfn id=dom-texttrack-readystate title=dom-TextTrack-readyState><code>readyState</code></dfn>
attribute must return the numeric value corresponding to the
- <a href=#timed-track-readiness-state>timed track readiness state</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents, as
+ <a href=#text-track-readiness-state>text track readiness state</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents, as
defined by the following list:</p>
- <dl><dt><dfn id=dom-timedtrack-none title=dom-TimedTrack-NONE><code>NONE</code></dfn> (numeric value 0)</dt>
- <dd>The <a href=#timed-track-not-loaded>timed track not loaded</a> state.</dd>
- <dt><dfn id=dom-timedtrack-loading title=dom-TimedTrack-LOADING><code>LOADING</code></dfn> (numeric value 1)</dt>
- <dd>The <a href=#timed-track-loading>timed track loading</a> state.</dd>
- <dt><dfn id=dom-timedtrack-loaded title=dom-TimedTrack-LOADED><code>LOADED</code></dfn> (numeric value 2)</dt>
- <dd>The <a href=#timed-track-loaded>timed track loaded</a> state.</dd>
- <dt><dfn id=dom-timedtrack-error title=dom-TimedTrack-ERROR><code>ERROR</code></dfn> (numeric value 3)</dt>
- <dd>The <a href=#timed-track-failed-to-load>timed track failed to load</a> state.</dd>
- </dl><p>The <dfn id=dom-timedtrack-mode title=dom-TimedTrack-mode><code>mode</code></dfn>
+ <dl><dt><dfn id=dom-texttrack-none title=dom-TextTrack-NONE><code>NONE</code></dfn> (numeric value 0)</dt>
+ <dd>The <a href=#text-track-not-loaded>text track not loaded</a> state.</dd>
+ <dt><dfn id=dom-texttrack-loading title=dom-TextTrack-LOADING><code>LOADING</code></dfn> (numeric value 1)</dt>
+ <dd>The <a href=#text-track-loading>text track loading</a> state.</dd>
+ <dt><dfn id=dom-texttrack-loaded title=dom-TextTrack-LOADED><code>LOADED</code></dfn> (numeric value 2)</dt>
+ <dd>The <a href=#text-track-loaded>text track loaded</a> state.</dd>
+ <dt><dfn id=dom-texttrack-error title=dom-TextTrack-ERROR><code>ERROR</code></dfn> (numeric value 3)</dt>
+ <dd>The <a href=#text-track-failed-to-load>text track failed to load</a> state.</dd>
+ </dl><p>The <dfn id=dom-texttrack-mode title=dom-TextTrack-mode><code>mode</code></dfn>
attribute, on getting, must return the numeric value corresponding
- to the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed track</a>
- that the <code><a href=#timedtrack>TimedTrack</a></code> object represents, as defined by
+ to the <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text track</a>
+ that the <code><a href=#texttrack>TextTrack</a></code> object represents, as defined by
the following list:</p>
- <dl><dt><dfn id=dom-timedtrack-off title=dom-TimedTrack-OFF><code>OFF</code></dfn> (numeric value 0)</dt>
- <dd>The <a href=#timed-track-disabled>timed track disabled</a> mode.</dd>
- <dt><dfn id=dom-timedtrack-hidden title=dom-TimedTrack-HIDDEN><code>HIDDEN</code></dfn> (numeric value 1)</dt>
- <dd>The <a href=#timed-track-hidden>timed track hidden</a> mode.</dd>
- <dt><dfn id=dom-timedtrack-showing title=dom-TimedTrack-SHOWING><code>SHOWING</code></dfn> (numeric value 2)</dt>
- <dd>The <a href=#timed-track-showing>timed track showing</a> and <a href=#timed-track-showing-by-default title="timed track showing by default">showing by default</a> modes.</dd>
+ <dl><dt><dfn id=dom-texttrack-off title=dom-TextTrack-OFF><code>OFF</code></dfn> (numeric value 0)</dt>
+ <dd>The <a href=#text-track-disabled>text track disabled</a> mode.</dd>
+ <dt><dfn id=dom-texttrack-hidden title=dom-TextTrack-HIDDEN><code>HIDDEN</code></dfn> (numeric value 1)</dt>
+ <dd>The <a href=#text-track-hidden>text track hidden</a> mode.</dd>
+ <dt><dfn id=dom-texttrack-showing title=dom-TextTrack-SHOWING><code>SHOWING</code></dfn> (numeric value 2)</dt>
+ <dd>The <a href=#text-track-showing>text track showing</a> and <a href=#text-track-showing-by-default title="text track showing by default">showing by default</a> modes.</dd>
</dl><p>On setting, if the new value is not either 0, 1, or 2, the user
agent must throw an <code><a href=#invalid_access_err>INVALID_ACCESS_ERR</a></code>
exception. Otherwise, if the new value isn't equal to what the
@@ -28466,9 +28464,9 @@
<dd>
- <p>Set the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents to
- the <a href=#timed-track-disabled>timed track disabled</a> mode.</p>
+ <p>Set the <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents to
+ the <a href=#text-track-disabled>text track disabled</a> mode.</p>
</dd>
@@ -28476,9 +28474,9 @@
<dd>
- <p>Set the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents to
- the <a href=#timed-track-hidden>timed track hidden</a> mode.</p>
+ <p>Set the <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents to
+ the <a href=#text-track-hidden>text track hidden</a> mode.</p>
</dd>
@@ -28486,28 +28484,28 @@
<dd>
- <p>Set the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents to
- the <a href=#timed-track-showing>timed track showing</a> mode.</p>
+ <p>Set the <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents to
+ the <a href=#text-track-showing>text track showing</a> mode.</p>
- <p class=note>If the mode had been <a href=#timed-track-showing-by-default title="timed track
+ <p class=note>If the mode had been <a href=#text-track-showing-by-default title="text track
showing by default">showing by default</a>, this will change it
- to <a href=#timed-track-showing title="timed track showing">showing</a>, even though
- the value of <code title=dom-TimedTrack-mode><a href=#dom-timedtrack-mode>mode</a></code> would
+ to <a href=#text-track-showing title="text track showing">showing</a>, even though
+ the value of <code title=dom-TextTrack-mode><a href=#dom-texttrack-mode>mode</a></code> would
appear not to change.</p>
</dd>
- </dl><p>If the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents is
- not the <a href=#timed-track-disabled>timed track disabled</a> mode, then the <dfn id=dom-timedtrack-cues title=dom-TimedTrack-cues><code>cues</code></dfn> attribute must
- return a <a href=#live>live</a> <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object
- that represents the subset of the <a href=#timed-track-list-of-cues>timed track list of
- cues</a> of the <a href=#timed-track>timed track</a> that the
- <code><a href=#timedtrack>TimedTrack</a></code> object represents whose <a href=#timed-track-cue-start-time title="timed
+ </dl><p>If the <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents is
+ not the <a href=#text-track-disabled>text track disabled</a> mode, then the <dfn id=dom-texttrack-cues title=dom-TextTrack-cues><code>cues</code></dfn> attribute must
+ return a <a href=#live>live</a> <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object
+ that represents the subset of the <a href=#text-track-list-of-cues>text track list of
+ cues</a> of the <a href=#text-track>text track</a> that the
+ <code><a href=#texttrack>TextTrack</a></code> object represents whose <a href=#text-track-cue-start-time title="text
track cue start time">start times</a> occur before the
<a href=#earliest-possible-position-when-the-script-started>earliest possible position when the script started</a>, in
- <a href=#timed-track-cue-order>timed track cue order</a>. Otherwise, it must return
+ <a href=#text-track-cue-order>text track cue order</a>. Otherwise, it must return
null. When an object is returned, the same object must be returned
each time.</p>
@@ -28515,45 +28513,45 @@
is whatever the <a href=#earliest-possible-position>earliest possible position</a> was the last
time the <a href=#event-loop>event loop</a> reached step 1.</p>
- <p>If the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents is
- not the <a href=#timed-track-disabled>timed track disabled</a> mode, then the <dfn id=dom-timedtrack-activecues title=dom-TimedTrack-activeCues><code>activeCues</code></dfn>
+ <p>If the <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents is
+ not the <a href=#text-track-disabled>text track disabled</a> mode, then the <dfn id=dom-texttrack-activecues title=dom-TextTrack-activeCues><code>activeCues</code></dfn>
attribute must return a <a href=#live>live</a>
- <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object that represents the subset of
- the <a href=#timed-track-list-of-cues>timed track list of cues</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents
+ <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object that represents the subset of
+ the <a href=#text-track-list-of-cues>text track list of cues</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents
whose <a href=#active-flag-was-set-when-the-script-started>active flag was set when the script started</a>, in
- <a href=#timed-track-cue-order>timed track cue order</a>. Otherwise, it must return
+ <a href=#text-track-cue-order>text track cue order</a>. Otherwise, it must return
null. When an object is returned, the same object must be returned
each time.</p>
- <p>A <a href=#timed-track-cue>timed track cue</a>'s <dfn id=active-flag-was-set-when-the-script-started>active flag was set when
- the script started</dfn> if its <a href=#timed-track-cue-active-flag>timed track cue active
+ <p>A <a href=#text-track-cue>text track cue</a>'s <dfn id=active-flag-was-set-when-the-script-started>active flag was set when
+ the script started</dfn> if its <a href=#text-track-cue-active-flag>text track cue active
flag</a> was set the last time the <a href=#event-loop>event loop</a>
reached step 1.</p>
</div>
- <hr><pre class=idl>interface <dfn id=mutabletimedtrack>MutableTimedTrack</dfn> : <a href=#timedtrack>TimedTrack</a> {
- void <a href=#dom-mutabletimedtrack-addcue title=dom-MutableTimedTrack-addCue>addCue</a>(in <a href=#timedtrackcue>TimedTrackCue</a> cue);
- void <a href=#dom-mutabletimedtrack-removecue title=dom-MutableTimedTrack-removeCue>removeCue</a>(in <a href=#timedtrackcue>TimedTrackCue</a> cue);
+ <hr><pre class=idl>interface <dfn id=mutabletexttrack>MutableTextTrack</dfn> : <a href=#texttrack>TextTrack</a> {
+ void <a href=#dom-mutabletexttrack-addcue title=dom-MutableTextTrack-addCue>addCue</a>(in <a href=#texttrackcue>TextTrackCue</a> cue);
+ void <a href=#dom-mutabletexttrack-removecue title=dom-MutableTextTrack-removeCue>removeCue</a>(in <a href=#texttrackcue>TextTrackCue</a> cue);
};</pre>
- <dl class=domintro><dt><var title="">mutableTimedTrack</var> = <var title="">media</var> . <code title=dom-media-addTrack><a href=#dom-media-addtrack>addTrack</a></code>( <var title="">kind</var> [, <var title="">label</var> [, <var title="">language</var> ] ] )</dt>
+ <dl class=domintro><dt><var title="">mutableTextTrack</var> = <var title="">media</var> . <code title=dom-media-addTrack><a href=#dom-media-addtrack>addTrack</a></code>( <var title="">kind</var> [, <var title="">label</var> [, <var title="">language</var> ] ] )</dt>
<dd>
- <p>Creates and returns a new <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object, which is also added to the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ <p>Creates and returns a new <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object, which is also added to the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>.</p>
</dd>
- <dt><var title="">mutableTimedTrack</var> . <code title=dom-MutableTimedTrack-addCue><a href=#dom-mutabletimedtrack-addcue>addCue</a></code>( <var title="">cue</var> )</dt>
+ <dt><var title="">mutableTextTrack</var> . <code title=dom-MutableTextTrack-addCue><a href=#dom-mutabletexttrack-addcue>addCue</a></code>( <var title="">cue</var> )</dt>
<dd>
- <p>Adds the given cue to <var title="">mutableTimedTrack</var>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>.</p>
- <p>Raises an exception if the argument is null, associated with another <a href=#timed-track>timed track</a>, or already in the list of cues.</p>
+ <p>Adds the given cue to <var title="">mutableTextTrack</var>'s <a href=#text-track-list-of-cues>text track list of cues</a>.</p>
+ <p>Raises an exception if the argument is null, associated with another <a href=#text-track>text track</a>, or already in the list of cues.</p>
</dd>
- <dt><var title="">mutableTimedTrack</var> . <code title=dom-MutableTimedTrack-removeCue><a href=#dom-mutabletimedtrack-removecue>removeCue</a></code>( <var title="">cue</var> )</dt>
+ <dt><var title="">mutableTextTrack</var> . <code title=dom-MutableTextTrack-removeCue><a href=#dom-mutabletexttrack-removecue>removeCue</a></code>( <var title="">cue</var> )</dt>
<dd>
- <p>Removes the given cue from <var title="">mutableTimedTrack</var>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>.</p>
- <p>Raises an exception if the argument is null, associated with another <a href=#timed-track>timed track</a>, or not in the list of cues.</p>
+ <p>Removes the given cue from <var title="">mutableTextTrack</var>'s <a href=#text-track-list-of-cues>text track list of cues</a>.</p>
+ <p>Raises an exception if the argument is null, associated with another <a href=#text-track>text track</a>, or not in the list of cues.</p>
</dd>
</dl><div class=impl>
@@ -28568,11 +28566,11 @@
strings, then throw a <code><a href=#syntax_err>SYNTAX_ERR</a></code> exception and abort
these steps:</p>
- <ul class=brief><li><code title=dom-TimedTrack-kind-subtitles><a href=#dom-timedtrack-kind-subtitles>subtitles</a></code>
- <li><code title=dom-TimedTrack-kind-captions><a href=#dom-timedtrack-kind-captions>captions</a></code>
- <li><code title=dom-TimedTrack-kind-descriptions><a href=#dom-timedtrack-kind-descriptions>descriptions</a></code>
- <li><code title=dom-TimedTrack-kind-chapters><a href=#dom-timedtrack-kind-chapters>chapters</a></code>
- <li><code title=dom-TimedTrack-kind-metadata><a href=#dom-timedtrack-kind-metadata>metadata</a></code>
+ <ul class=brief><li><code title=dom-TextTrack-kind-subtitles><a href=#dom-texttrack-kind-subtitles>subtitles</a></code>
+ <li><code title=dom-TextTrack-kind-captions><a href=#dom-texttrack-kind-captions>captions</a></code>
+ <li><code title=dom-TextTrack-kind-descriptions><a href=#dom-texttrack-kind-descriptions>descriptions</a></code>
+ <li><code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code>
+ <li><code title=dom-TextTrack-kind-metadata><a href=#dom-texttrack-kind-metadata>metadata</a></code>
</ul></li>
<li>
@@ -28590,18 +28588,18 @@
<li>
- <p>Create a new <a href=#timed-track>timed track</a>, and set its <a href=#timed-track-kind>timed
- track kind</a> to <var title="">kind</var>, its <a href=#timed-track-label>timed
- track label</a> to <var title="">label</var>, its <a href=#timed-track-language>timed
+ <p>Create a new <a href=#text-track>text track</a>, and set its <a href=#text-track-kind>text
+ track kind</a> to <var title="">kind</var>, its <a href=#text-track-label>text
+ track label</a> to <var title="">label</var>, its <a href=#text-track-language>text
track language</a> to <var title="">language</var>, its
- <a href=#timed-track-readiness-state>timed track readiness state</a> to the <a href=#timed-track-loaded>timed track
- loaded</a> state, its <a href=#timed-track-mode>timed track mode</a> to the
- <a href=#timed-track-hidden>timed track hidden</a> mode, and its <a href=#timed-track-list-of-cues>timed track
+ <a href=#text-track-readiness-state>text track readiness state</a> to the <a href=#text-track-loaded>text track
+ loaded</a> state, its <a href=#text-track-mode>text track mode</a> to the
+ <a href=#text-track-hidden>text track hidden</a> mode, and its <a href=#text-track-list-of-cues>text track
list of cues</a> to an empty list.
<!--TTVTT-->
- Associate the <a href=#timed-track-list-of-cues>timed track list of cues</a> with the
- <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the display of WebVTT timed tracks</a>
- as its <a href=#rules-for-updating-the-timed-track-rendering>rules for updating the timed track rendering</a>.
+ Associate the <a href=#text-track-list-of-cues>text track list of cues</a> with the
+ <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the display of WebVTT text tracks</a>
+ as its <a href=#rules-for-updating-the-text-track-rendering>rules for updating the text track rendering</a>.
<!--TTVTT-->
</p>
@@ -28609,11 +28607,11 @@
<li>
- <p>Add the new <a href=#timed-track>timed track</a> to the <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ <p>Add the new <a href=#text-track>text track</a> to the <a href=#media-element>media
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>.</p>
- </ol><p>The <dfn id=dom-mutabletimedtrack-addcue title=dom-MutableTimedTrack-addCue><code>addCue(<var title="">cue</var>)</code></dfn> method of
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> objects, when invoked, must run the
+ </ol><p>The <dfn id=dom-mutabletexttrack-addcue title=dom-MutableTextTrack-addCue><code>addCue(<var title="">cue</var>)</code></dfn> method of
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> objects, when invoked, must run the
following steps:</p>
<ol><li><p>If <var title="">cue</var> is null, then throw an
@@ -28621,27 +28619,27 @@
steps.</li>
<li><p>If the given <var title="">cue</var> is already associated
- with a <a href=#timed-track>timed track</a> other than the method's
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed track</a>,
+ with a <a href=#text-track>text track</a> other than the method's
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text track</a>,
then throw an <code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code> exception and abort
these steps.</li>
<li><p>Associate <var title="">cue</var> with the method's
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed track</a>,
- if it is not currently associated with a <a href=#timed-track>timed
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text track</a>,
+ if it is not currently associated with a <a href=#text-track>text
track</a>.</li>
<li><p>If the given <var title="">cue</var> is already listed in
- the method's <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed
- track</a>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>, then throw an
+ the method's <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text
+ track</a>'s <a href=#text-track-list-of-cues>text track list of cues</a>, then throw an
<code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code> exception.</li>
<li><p>Add <var title="">cue</var> to the method's
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed track</a>'s
- <a href=#timed-track-list-of-cues>timed track list of cues</a>.</li>
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text track</a>'s
+ <a href=#text-track-list-of-cues>text track list of cues</a>.</li>
- </ol><p>The <dfn id=dom-mutabletimedtrack-removecue title=dom-MutableTimedTrack-removeCue><code>removeCue(<var title="">cue</var>)</code></dfn> method of
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> objects, when invoked, must run the
+ </ol><p>The <dfn id=dom-mutabletexttrack-removecue title=dom-MutableTextTrack-removeCue><code>removeCue(<var title="">cue</var>)</code></dfn> method of
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> objects, when invoked, must run the
following steps:</p>
<ol><li><p>If <var title="">cue</var> is null, then throw an
@@ -28649,18 +28647,18 @@
steps.</li>
<li><p>If the given <var title="">cue</var> is not associated with
- the method's <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed
+ the method's <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text
track</a>, then throw an <code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code>
exception.</li>
<li><p>If the given <var title="">cue</var> is not currently listed
- in the method's <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed
- track</a>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>, then throw a
+ in the method's <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text
+ track</a>'s <a href=#text-track-list-of-cues>text track list of cues</a>, then throw a
<code><a href=#not_found_err>NOT_FOUND_ERR</a></code> exception.</li>
<li><p>Remove <var title="">cue</var> from the method's
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed track</a>'s
- <a href=#timed-track-list-of-cues>timed track list of cues</a>.</li>
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text track</a>'s
+ <a href=#text-track-list-of-cues>text track list of cues</a>.</li>
</ol></div>
@@ -28677,8 +28675,8 @@
<pre>var sfx = new Audio('sfx.wav');
var sounds = a.addTrack('metadata');
// add sounds we care about
-sounds.addCue(new TimedTrackCue('dog bark', 12.783, 13.612, '', '', '', true));
-sounds.addCue(new TimedTrackCue('kitten mew', 13.612, 15.091, '', '', '', true));
+sounds.addCue(new TextTrackCue('dog bark', 12.783, 13.612, '', '', '', true));
+sounds.addCue(new TextTrackCue('kitten mew', 13.612, 15.091, '', '', '', true));
function playSound(id) {
sfx.currentTime = sounds.getCueById(id).startTime;
@@ -28695,56 +28693,56 @@
</div>
- <hr><pre class=idl>interface <dfn id=timedtrackcuelist>TimedTrackCueList</dfn> {
- readonly attribute unsigned long <a href=#dom-timedtrackcuelist-length title=dom-TimedTrackCueList-length>length</a>;
- getter <a href=#timedtrackcue>TimedTrackCue</a> (in unsigned long index);
- <a href=#timedtrackcue>TimedTrackCue</a> <a href=#dom-timedtrackcuelist-getcuebyid title=dom-TimedTrackCueList-getCueById>getCueById</a>(in DOMString id);
+ <hr><pre class=idl>interface <dfn id=texttrackcuelist>TextTrackCueList</dfn> {
+ readonly attribute unsigned long <a href=#dom-texttrackcuelist-length title=dom-TextTrackCueList-length>length</a>;
+ getter <a href=#texttrackcue>TextTrackCue</a> (in unsigned long index);
+ <a href=#texttrackcue>TextTrackCue</a> <a href=#dom-texttrackcuelist-getcuebyid title=dom-TextTrackCueList-getCueById>getCueById</a>(in DOMString id);
};</pre>
- <dl class=domintro><dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-length><a href=#dom-timedtrackcuelist-length>length</a></code></dt>
+ <dl class=domintro><dt><var title="">cuelist</var> . <code title=dom-TextTrackCueList-length><a href=#dom-texttrackcuelist-length>length</a></code></dt>
<dd>
- <p>Returns the number of <a href=#timed-track-cue title="timed track cue">cues</a> in the list.</p>
+ <p>Returns the number of <a href=#text-track-cue title="text track cue">cues</a> in the list.</p>
</dd>
<dt><var title="">cuelist</var>[<var title="">index</var>]</dt>
<dd>
- <p>Returns the <a href=#timed-track-cue>timed track cue</a> with index <var title="">index</var> in the list. The cues are sorted in <a href=#timed-track-cue-order>timed track cue order</a>.</p>
+ <p>Returns the <a href=#text-track-cue>text track cue</a> with index <var title="">index</var> in the list. The cues are sorted in <a href=#text-track-cue-order>text track cue order</a>.</p>
</dd>
- <dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-getCueById><a href=#dom-timedtrackcuelist-getcuebyid>getCueById</a></code>( <var title="">id</var> )</dt>
+ <dt><var title="">cuelist</var> . <code title=dom-TextTrackCueList-getCueById><a href=#dom-texttrackcuelist-getcuebyid>getCueById</a></code>( <var title="">id</var> )</dt>
<dd>
- <p>Returns the first <a href=#timed-track-cue>timed track cue</a> (in <a href=#timed-track-cue-order>timed track cue order</a>) with <a href=#timed-track-cue-identifier>timed track cue identifier</a> <var title="">id</var>.</p>
+ <p>Returns the first <a href=#text-track-cue>text track cue</a> (in <a href=#text-track-cue-order>text track cue order</a>) with <a href=#text-track-cue-identifier>text track cue identifier</a> <var title="">id</var>.</p>
<p>Returns null if none of the cues have the given identifier or if the argument is the empty string.</p>
</dd>
</dl><div class=impl>
- <p>A <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object represents a dynamically
- updating list of <a href=#timed-track-cue title="timed track cue">timed track
+ <p>A <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object represents a dynamically
+ updating list of <a href=#text-track-cue title="text track cue">text track
cues</a> in a given order.</p>
- <p>The <dfn id=dom-timedtrackcuelist-length title=dom-TimedTrackCueList-length><code>length</code></dfn>
- attribute must return the number of <a href=#timed-track-cue title="timed track
+ <p>The <dfn id=dom-texttrackcuelist-length title=dom-TextTrackCueList-length><code>length</code></dfn>
+ attribute must return the number of <a href=#text-track-cue title="text track
cue">cues</a> in the list represented by the
- <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+ <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object.</p>
<p>The <span>supported property indicies</span> of a
- <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object at any instant are the numbers
- from zero to the number of <a href=#timed-track-cue title="timed track cue">cues</a>
- in the list represented by the <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object
- minus one, if any. If there are no <a href=#timed-track-cue title="timed track
+ <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object at any instant are the numbers
+ from zero to the number of <a href=#text-track-cue title="text track cue">cues</a>
+ in the list represented by the <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object
+ minus one, if any. If there are no <a href=#text-track-cue title="text track
cue">cues</a> in the list, there are no <span>supported property
indicies</span>.</p>
<p>To <span>determine the value of an indexed property</span> for a
given index <var title="">index</var>, the user agent must return
- the <var title="">index</var>th <a href=#timed-track-cue>timed track cue</a> in the
- list represented by the <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+ the <var title="">index</var>th <a href=#text-track-cue>text track cue</a> in the
+ list represented by the <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object.</p>
- <p>The <dfn id=dom-timedtrackcuelist-getcuebyid title=dom-TimedTrackCueList-getCueById><code>getCueById(<var title="">id</var>)</code></dfn> method, when called with an argument
- other than the empty string, must return the first <a href=#timed-track-cue>timed track
+ <p>The <dfn id=dom-texttrackcuelist-getcuebyid title=dom-TextTrackCueList-getCueById><code>getCueById(<var title="">id</var>)</code></dfn> method, when called with an argument
+ other than the empty string, must return the first <a href=#text-track-cue>text track
cue</a> in the list represented by the
- <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object whose <a href=#timed-track-cue-identifier>timed track cue
+ <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object whose <a href=#text-track-cue-identifier>text track cue
identifier</a> is <var title="">id</var>, if any, or null
otherwise. If the argument is the empty string, then the method must
return null.</p>
@@ -28753,153 +28751,153 @@
<hr><pre class=idl>
<!--TTVTT-->
-[<a href=#dom-timedtrackcue title=dom-TimedTrackCue>Constructor</a>(in DOMString id, in double startTime, in double endTime, in DOMString text, in optional DOMString settings, in optional boolean pauseOnExit)]
+[<a href=#dom-texttrackcue title=dom-TextTrackCue>Constructor</a>(in DOMString id, in double startTime, in double endTime, in DOMString text, in optional DOMString settings, in optional boolean pauseOnExit)]
<!--TTVTT-->
-interface <dfn id=timedtrackcue>TimedTrackCue</dfn> {
- readonly attribute <a href=#timedtrack>TimedTrack</a> <a href=#dom-timedtrackcue-track title=dom-TimedTrackCue-track>track</a>;
- readonly attribute DOMString <a href=#dom-timedtrackcue-id title=dom-TimedTrackCue-id>id</a>;
+interface <dfn id=texttrackcue>TextTrackCue</dfn> {
+ readonly attribute <a href=#texttrack>TextTrack</a> <a href=#dom-texttrackcue-track title=dom-TextTrackCue-track>track</a>;
+ readonly attribute DOMString <a href=#dom-texttrackcue-id title=dom-TextTrackCue-id>id</a>;
- readonly attribute double <a href=#dom-timedtrackcue-starttime title=dom-TimedTrackCue-startTime>startTime</a>;
- readonly attribute double <a href=#dom-timedtrackcue-endtime title=dom-TimedTrackCue-endTime>endTime</a>;
- readonly attribute boolean <a href=#dom-timedtrackcue-pauseonexit title=dom-TimedTrackCue-pauseOnExit>pauseOnExit</a>;
+ readonly attribute double <a href=#dom-texttrackcue-starttime title=dom-TextTrackCue-startTime>startTime</a>;
+ readonly attribute double <a href=#dom-texttrackcue-endtime title=dom-TextTrackCue-endTime>endTime</a>;
+ readonly attribute boolean <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a>;
<!--TTVTT-->
- readonly attribute DOMString <a href=#dom-timedtrackcue-direction title=dom-TimedTrackCue-direction>direction</a>;
- readonly attribute boolean <a href=#dom-timedtrackcue-snaptolines title=dom-TimedTrackCue-snapToLines>snapToLines</a>;
- readonly attribute long <a href=#dom-timedtrackcue-lineposition title=dom-TimedTrackCue-linePosition>linePosition</a>;
- readonly attribute long <a href=#dom-timedtrackcue-textposition title=dom-TimedTrackCue-textPosition>textPosition</a>;
- readonly attribute long <a href=#dom-timedtrackcue-size title=dom-TimedTrackCue-size>size</a>;
- readonly attribute DOMString <a href=#dom-timedtrackcue-alignment title=dom-TimedTrackCue-alignment>alignment</a>;
+ readonly attribute DOMString <a href=#dom-texttrackcue-direction title=dom-TextTrackCue-direction>direction</a>;
+ readonly attribute boolean <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a>;
+ readonly attribute long <a href=#dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition>linePosition</a>;
+ readonly attribute long <a href=#dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition>textPosition</a>;
+ readonly attribute long <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a>;
+ readonly attribute DOMString <a href=#dom-texttrackcue-alignment title=dom-TextTrackCue-alignment>alignment</a>;
<!--TTVTT-->
- DOMString <a href=#dom-timedtrackcue-getcueassource() title=dom-TimedTrackCue-getCueAsSource()>getCueAsSource</a>();
- <a href=#documentfragment>DocumentFragment</a> <a href=#dom-timedtrackcue-getcueashtml() title=dom-TimedTrackCue-getCueAsHTML()>getCueAsHTML</a>();
+ DOMString <a href=#dom-texttrackcue-getcueassource title=dom-TextTrackCue-getCueAsSource>getCueAsSource</a>();
+ <a href=#documentfragment>DocumentFragment</a> <a href=#dom-texttrackcue-getcueashtml title=dom-TextTrackCue-getCueAsHTML>getCueAsHTML</a>();
- readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrackcue-onenter title=handler-TimedTrackCue-onenter>onenter</a>;
- readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrackcue-onexit title=handler-TimedTrackCue-onexit>onexit</a>;
+ readonly attribute <a href=#function>Function</a> <a href=#handler-texttrackcue-onenter title=handler-TextTrackCue-onenter>onenter</a>;
+ readonly attribute <a href=#function>Function</a> <a href=#handler-texttrackcue-onexit title=handler-TextTrackCue-onexit>onexit</a>;
};</pre>
- <dl class=domintro><!--TTVTT--><dt><var title="">cue</var> = new <code title=dom-TimedTrackCue><a href=#dom-timedtrackcue>TimedTrackCue</a></code>( <var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var> [, <var title="">settings</var> [, <var title="">pauseOnExit</var> ] ] )</dt>
+ <dl class=domintro><!--TTVTT--><dt><var title="">cue</var> = new <code title=dom-TextTrackCue><a href=#dom-texttrackcue>TextTrackCue</a></code>( <var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var> [, <var title="">settings</var> [, <var title="">pauseOnExit</var> ] ] )</dt>
<dd>
- <p>Returns a new <code><a href=#timedtrackcue>TimedTrackCue</a></code> object, for use with the <code title=dom-MutableTimedTrack-addCue><a href=#dom-mutabletimedtrack-addcue>addCue()</a></code> method.</p>
- <p>The <var title="">id</var> argument sets the <a href=#timed-track-cue-identifier>timed track cue identifier</a>.</p>
- <p>The <var title="">startTime</var> argument sets the <a href=#timed-track-cue-start-time>timed track cue start time</a>.</p>
- <p>The <var title="">endTime</var> argument sets the <a href=#timed-track-cue-end-time>timed track cue end time</a>.</p>
- <p>The <var title="">text</var> argument sets the <a href=#timed-track-cue-text>timed track cue text</a>.</p>
+ <p>Returns a new <code><a href=#texttrackcue>TextTrackCue</a></code> object, for use with the <code title=dom-MutableTextTrack-addCue><a href=#dom-mutabletexttrack-addcue>addCue()</a></code> method.</p>
+ <p>The <var title="">id</var> argument sets the <a href=#text-track-cue-identifier>text track cue identifier</a>.</p>
+ <p>The <var title="">startTime</var> argument sets the <a href=#text-track-cue-start-time>text track cue start time</a>.</p>
+ <p>The <var title="">endTime</var> argument sets the <a href=#text-track-cue-end-time>text track cue end time</a>.</p>
+ <p>The <var title="">text</var> argument sets the <a href=#text-track-cue-text>text track cue text</a>.</p>
<p>The <var title="">settings</var> argument is a string in the format of <a href=#webvtt-cue-settings>WebVTT cue settings</a>. If omitted, the empty string is assumed.</p>
- <p>The <var title="">pauseOnExit</var> argument sets the <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit flag</a>. If omitted, false is assumed.</p>
+ <p>The <var title="">pauseOnExit</var> argument sets the <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit flag</a>. If omitted, false is assumed.</p>
</dd>
<!--TTVTT-->
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-track title=dom-TimedTrackCue-track>track</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-track title=dom-TextTrackCue-track>track</a></dt>
<dd>
- <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object to which this
- <a href=#timed-track-cue>timed track cue</a> belongs, if any, or null
+ <p>Returns the <code><a href=#texttrack>TextTrack</a></code> object to which this
+ <a href=#text-track-cue>text track cue</a> belongs, if any, or null
otherwise.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-id title=dom-TimedTrackCue-id>id</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-id title=dom-TextTrackCue-id>id</a></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-identifier>timed track cue identifier</a>.</p>
+ <p>Returns the <a href=#text-track-cue-identifier>text track cue identifier</a>.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-starttime title=dom-TimedTrackCue-startTime>startTime</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-starttime title=dom-TextTrackCue-startTime>startTime</a></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-start-time>timed track cue start time</a>, in seconds.</p>
+ <p>Returns the <a href=#text-track-cue-start-time>text track cue start time</a>, in seconds.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-endtime title=dom-TimedTrackCue-endTime>endTime</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-endtime title=dom-TextTrackCue-endTime>endTime</a></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-end-time>timed track cue end time</a>, in seconds.</p>
+ <p>Returns the <a href=#text-track-cue-end-time>text track cue end time</a>, in seconds.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-pauseonexit title=dom-TimedTrackCue-pauseOnExit>pauseOnExit</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a></dt>
<dd>
- <p>Returns true if the <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit flag</a> is set, false otherwise.</p>
+ <p>Returns true if the <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit flag</a> is set, false otherwise.</p>
</dd>
<!--TTVTT-->
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-direction title=dom-TimedTrackCue-direction>direction</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-direction title=dom-TextTrackCue-direction>direction</a></dt>
<dd>
- <p>Returns a string representing the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a>, as follows:</p>
- <dl class=switch><dt>If it is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a></dt>
+ <p>Returns a string representing the <a href=#text-track-cue-writing-direction>text track cue writing direction</a>, as follows:</p>
+ <dl class=switch><dt>If it is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a></dt>
<dd><p>The string "<code title="">horizontal</code>".</dd>
- <dt>If it is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a></dt>
+ <dt>If it is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a></dt>
<dd><p>The string "<code title="">vertical</code>".</dd>
- <dt>If it is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a></dt>
+ <dt>If it is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a></dt>
<dd><p>The string "<code title="">vertical-lr</code>".</dd>
</dl></dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-snaptolines title=dom-TimedTrackCue-snapToLines>snapToLines</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a></dt>
<dd>
- <p>Returns true if the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is set, false otherwise.</p>
+ <p>Returns true if the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is set, false otherwise.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-lineposition title=dom-TimedTrackCue-linePosition>linePosition</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition>linePosition</a></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-line-position>timed track cue line position</a>. In the
- case of the value being <a href=#timed-track-cue-automatic-line-position title="timed track cue automatic
+ <p>Returns the <a href=#text-track-cue-line-position>text track cue line position</a>. In the
+ case of the value being <a href=#text-track-cue-automatic-line-position title="text track cue automatic
line position">auto</a>, the appropriate default is returned.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-textposition title=dom-TimedTrackCue-textPosition>textPosition</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition>textPosition</a></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-text-position>timed track cue text position</a>.</p>
+ <p>Returns the <a href=#text-track-cue-text-position>text track cue text position</a>.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-size title=dom-TimedTrackCue-size>size</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-size>timed track cue size</a>.</p>
+ <p>Returns the <a href=#text-track-cue-size>text track cue size</a>.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-alignment title=dom-TimedTrackCue-alignment>alignment</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-alignment title=dom-TextTrackCue-alignment>alignment</a></dt>
<dd>
- <p>Returns a string representing the <a href=#timed-track-cue-alignment>timed track cue alignment</a>, as follows:</p>
- <dl class=switch><dt>If it is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start alignment</a></dt>
+ <p>Returns a string representing the <a href=#text-track-cue-alignment>text track cue alignment</a>, as follows:</p>
+ <dl class=switch><dt>If it is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start alignment</a></dt>
<dd><p>The string "<code title="">start</code>".</dd>
- <dt>If it is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle alignment</a></dt>
+ <dt>If it is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle alignment</a></dt>
<dd><p>The string "<code title="">middle</code>".</dd>
- <dt>If it is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end alignment</a></dt>
+ <dt>If it is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end alignment</a></dt>
<dd><p>The string "<code title="">end</code>".</dd>
</dl></dd>
<!--TTVTT-->
- <dt><var title="">source</var> = <var title="">cue</var> . <span title=dom-TimedTrackCue-getCueAsSource>getCueAsSource</span>()</dt>
+ <dt><var title="">source</var> = <var title="">cue</var> . <a href=#dom-texttrackcue-getcueassource title=dom-TextTrackCue-getCueAsSource>getCueAsSource</a>()</dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-text>timed track cue text</a> in raw unparsed form.</p>
+ <p>Returns the <a href=#text-track-cue-text>text track cue text</a> in raw unparsed form.</p>
</dd>
- <dt><var title="">fragment</var> = <var title="">cue</var> . <span title=dom-TimedTrackCue-getCueAsHTML>getCueAsHTML</span>()</dt>
+ <dt><var title="">fragment</var> = <var title="">cue</var> . <a href=#dom-texttrackcue-getcueashtml title=dom-TextTrackCue-getCueAsHTML>getCueAsHTML</a>()</dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-text>timed track cue text</a> as a <code><a href=#documentfragment>DocumentFragment</a></code> of <a href=#html-elements>HTML elements</a> and other DOM nodes.</p>
+ <p>Returns the <a href=#text-track-cue-text>text track cue text</a> as a <code><a href=#documentfragment>DocumentFragment</a></code> of <a href=#html-elements>HTML elements</a> and other DOM nodes.</p>
</dd>
</dl><div class=impl>
<!--TTVTT-->
- <p>The <dfn id=dom-timedtrackcue title=dom-TimedTrackCue><code>TimedTrackCue(<var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var>, <var title="">settings</var>, <var title="">pauseOnExit</var>)</code></dfn> constructor, when invoked,
+ <p>The <dfn id=dom-texttrackcue title=dom-TextTrackCue><code>TextTrackCue(<var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var>, <var title="">settings</var>, <var title="">pauseOnExit</var>)</code></dfn> constructor, when invoked,
must run the following steps:</p>
- <ol><li><p>Create a new <a href=#timed-track-cue>timed track cue</a> that is not
- associated with any <a href=#timed-track>timed track</a>. Let <var title="">cue</var> be that <a href=#timed-track-cue>timed track cue</a>.</li>
+ <ol><li><p>Create a new <a href=#text-track-cue>text track cue</a> that is not
+ associated with any <a href=#text-track>text track</a>. Let <var title="">cue</var> be that <a href=#text-track-cue>text track cue</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-identifier>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-identifier>text track cue
identifier</a> be the value of the <var title="">id</var>
argument.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-start-time>timed track cue start
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-start-time>text track cue start
time</a> be the value of the <var title="">startTime</var>
argument, interpreted as a time in seconds.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-end-time>timed track cue end
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-end-time>text track cue end
time</a> be the value of the <var title="">endTime</var>
argument, interpreted as a time in seconds.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-pause-on-exit-flag>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-pause-on-exit-flag>text track cue
pause-on-exit flag</a> be true if the <var title="">pauseOnExit</var> is present and true. Otherwise, let it
be false.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-text>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-text>text track cue
text</a> be the value of the <var title="">text</var> argument,
and let the rules for its interpretation be the <a href=#webvtt-cue-text-parsing-rules>WebVTT cue
text parsing rules</a>, the <a href=#webvtt-cue-text-rendering-rules>WebVTT cue text rendering
@@ -28908,25 +28906,25 @@
<!-- default settings -->
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-writing-direction>timed track cue
- writing direction</a> be <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-writing-direction>text track cue
+ writing direction</a> be <a href=#text-track-cue-horizontal-writing-direction title="text track cue
horizontal writing direction">horizontal</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-snap-to-lines-flag>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-snap-to-lines-flag>text track cue
snap-to-lines flag</a> be true.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-line-position>timed track cue line
- position</a> be <a href=#timed-track-cue-automatic-line-position title="timed track cue automatic line
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-line-position>text track cue line
+ position</a> be <a href=#text-track-cue-automatic-line-position title="text track cue automatic line
position">auto</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-text-position>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-text-position>text track cue
text position</a> be 50.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-size>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-size>text track cue
size</a> be 100.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-alignment>timed track cue
- alignment</a> be <a href=#timed-track-cue-middle-alignment title="timed track cue middle
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-alignment>text track cue
+ alignment</a> be <a href=#text-track-cue-middle-alignment title="text track cue middle
alignment">middle alignment</a>.</li>
<li><p>Let <var title="">input</var> be the string given by the
@@ -28937,100 +28935,100 @@
<li><p><a href=#parse-the-webvtt-settings>Parse the WebVTT settings</a> for <var title="">cue</var>.</li>
- <li><p>Return the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object representing
+ <li><p>Return the <code><a href=#texttrackcue>TextTrackCue</a></code> object representing
<var title="">cue</var>.</li>
- </ol><!--TTVTT--><p>The <dfn id=dom-timedtrackcue-track title=dom-TimedTrackCue-track><code>track</code></dfn>
- attribute must return the <code><a href=#timedtrack>TimedTrack</a></code> object of the
- <a href=#timed-track>timed track</a> with which the <a href=#timed-track-cue>timed track cue</a>
- that the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents is associated,
+ </ol><!--TTVTT--><p>The <dfn id=dom-texttrackcue-track title=dom-TextTrackCue-track><code>track</code></dfn>
+ attribute must return the <code><a href=#texttrack>TextTrack</a></code> object of the
+ <a href=#text-track>text track</a> with which the <a href=#text-track-cue>text track cue</a>
+ that the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is associated,
if any; or null otherwise.</p>
- <p>The <dfn id=dom-timedtrackcue-id title=dom-TimedTrackCue-id><code>id</code></dfn>
- attribute must return the <a href=#timed-track-cue-identifier>timed track cue identifier</a> of
- the <a href=#timed-track-cue>timed track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code>
+ <p>The <dfn id=dom-texttrackcue-id title=dom-TextTrackCue-id><code>id</code></dfn>
+ attribute must return the <a href=#text-track-cue-identifier>text track cue identifier</a> of
+ the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
object represents.</p>
- <p>The <dfn id=dom-timedtrackcue-starttime title=dom-TimedTrackCue-startTime><code>startTime</code></dfn>
- attribute must return the <a href=#timed-track-cue-start-time>timed track cue start time</a> of
- the <a href=#timed-track-cue>timed track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code>
+ <p>The <dfn id=dom-texttrackcue-starttime title=dom-TextTrackCue-startTime><code>startTime</code></dfn>
+ attribute must return the <a href=#text-track-cue-start-time>text track cue start time</a> of
+ the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
object represents, in seconds.</p>
- <p>The <dfn id=dom-timedtrackcue-endtime title=dom-TimedTrackCue-endTime><code>endTime</code></dfn>
- attribute must return the <a href=#timed-track-cue-end-time>timed track cue end time</a> of
- the <a href=#timed-track-cue>timed track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code>
+ <p>The <dfn id=dom-texttrackcue-endtime title=dom-TextTrackCue-endTime><code>endTime</code></dfn>
+ attribute must return the <a href=#text-track-cue-end-time>text track cue end time</a> of
+ the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
object represents, in seconds.</p>
- <p>The <dfn id=dom-timedtrackcue-pauseonexit title=dom-TimedTrackCue-pauseOnExit><code>pauseOnExit</code></dfn>
- attribute must return true if the <a href=#timed-track-cue-pause-on-exit-flag>timed track cue
- pause-on-exit flag</a> of the <a href=#timed-track-cue>timed track cue</a> that
- the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents is set; or false
+ <p>The <dfn id=dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit><code>pauseOnExit</code></dfn>
+ attribute must return true if the <a href=#text-track-cue-pause-on-exit-flag>text track cue
+ pause-on-exit flag</a> of the <a href=#text-track-cue>text track cue</a> that
+ the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is set; or false
otherwise.</p>
- <p>The <dfn id=dom-timedtrackcue-direction title=dom-TimedTrackCue-direction><code>direction</code></dfn>
- attribute must return the <a href=#timed-track-cue-writing-direction>timed track cue writing
- direction</a> of the <a href=#timed-track-cue>timed track cue</a> that the
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents.</p>
+ <p>The <dfn id=dom-texttrackcue-direction title=dom-TextTrackCue-direction><code>direction</code></dfn>
+ attribute must return the <a href=#text-track-cue-writing-direction>text track cue writing
+ direction</a> of the <a href=#text-track-cue>text track cue</a> that the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object represents.</p>
<!--TTVTT-->
- <p>The <dfn id=dom-timedtrackcue-snaptolines title=dom-TimedTrackCue-snapToLines><code>snapToLines</code></dfn>
- attribute must return true if the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue
- snap-to-lines flag</a> of the <a href=#timed-track-cue>timed track cue</a> that
- the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents is set; or false
+ <p>The <dfn id=dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines><code>snapToLines</code></dfn>
+ attribute must return true if the <a href=#text-track-cue-snap-to-lines-flag>text track cue
+ snap-to-lines flag</a> of the <a href=#text-track-cue>text track cue</a> that
+ the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is set; or false
otherwise.</p>
- <p>The <dfn id=dom-timedtrackcue-lineposition title=dom-TimedTrackCue-linePosition><code>linePosition</code></dfn>
- attribute must return the <a href=#timed-track-cue-line-position>timed track cue line position</a>
- of the <a href=#timed-track-cue>timed track cue</a> that the
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents, if that value is
- numeric. Otherwise, the value is the special value <a href=#timed-track-cue-automatic-line-position title="timed track cue automatic line position">auto</a>; if the
- <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> of the <a href=#timed-track-cue>timed
- track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object
+ <p>The <dfn id=dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition><code>linePosition</code></dfn>
+ attribute must return the <a href=#text-track-cue-line-position>text track cue line position</a>
+ of the <a href=#text-track-cue>text track cue</a> that the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object represents, if that value is
+ numeric. Otherwise, the value is the special value <a href=#text-track-cue-automatic-line-position title="text track cue automatic line position">auto</a>; if the
+ <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> of the <a href=#text-track-cue>text
+ track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object
represents is not set, the attribute must return the value 100;
otherwise, it must return the value returned by the following
algorithm:</p>
- <ol><li><p>Let <var title="">cue</var> be the <a href=#timed-track-cue>timed track
- cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object
+ <ol><li><p>Let <var title="">cue</var> be the <a href=#text-track-cue>text track
+ cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object
represents.</li>
<li><p>If <var title="">cue</var> is not associated with a
- <a href=#timed-track>timed track</a>, return −1 and abort these
+ <a href=#text-track>text track</a>, return −1 and abort these
steps.</li>
- <li><p>Let <var title="">track</var> be the <a href=#timed-track>timed
+ <li><p>Let <var title="">track</var> be the <a href=#text-track>text
track</a> that the <var title="">cue</var> is associated
with.</li>
- <li><p>Let <var title="">n</var> be the number of <a href=#timed-track title="timed track">timed tracks</a> whose <a href=#timed-track-mode>timed track
- mode</a> is <a href=#timed-track-showing title="timed track showing">showing</a> or
- <a href=#timed-track-showing-by-default title="timed track showing by default">showing by
+ <li><p>Let <var title="">n</var> be the number of <a href=#text-track title="text track">text tracks</a> whose <a href=#text-track-mode>text track
+ mode</a> is <a href=#text-track-showing title="text track showing">showing</a> or
+ <a href=#text-track-showing-by-default title="text track showing by default">showing by
default</a> and that are in the <a href=#media-element>media element</a>'s
- <a href=#list-of-timed-tracks>list of timed tracks</a> before <var title="">track</var>.</li>
+ <a href=#list-of-text-tracks>list of text tracks</a> before <var title="">track</var>.</li>
<li><p>Return <var title="">n</var>.</li>
- </ol><p>The <dfn id=dom-timedtrackcue-textposition title=dom-TimedTrackCue-textPosition><code>textPosition</code></dfn>
- attribute must return the <a href=#timed-track-cue-text-position>timed track cue text position</a>
- of the <a href=#timed-track-cue>timed track cue</a> that the
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents.</p>
+ </ol><p>The <dfn id=dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition><code>textPosition</code></dfn>
+ attribute must return the <a href=#text-track-cue-text-position>text track cue text position</a>
+ of the <a href=#text-track-cue>text track cue</a> that the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object represents.</p>
- <p>The <dfn id=dom-timedtrackcue-size title=dom-TimedTrackCue-size><code>size</code></dfn>
- attribute must return the <a href=#timed-track-cue-size>timed track cue size</a> of the
- <a href=#timed-track-cue>timed track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code>
+ <p>The <dfn id=dom-texttrackcue-size title=dom-TextTrackCue-size><code>size</code></dfn>
+ attribute must return the <a href=#text-track-cue-size>text track cue size</a> of the
+ <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
object represents.</p>
- <p>The <dfn id=dom-timedtrackcue-alignment title=dom-TimedTrackCue-alignment><code>alignment</code></dfn>
- attribute must return the <a href=#timed-track-cue-alignment>timed track cue alignment</a> of
- the <a href=#timed-track-cue>timed track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code>
+ <p>The <dfn id=dom-texttrackcue-alignment title=dom-TextTrackCue-alignment><code>alignment</code></dfn>
+ attribute must return the <a href=#text-track-cue-alignment>text track cue alignment</a> of
+ the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
object represents.</p>
<!--TTVTT-->
- <p>The <dfn id=dom-timedtrackcue-getcueassource() title=dom-TimedTrackCue-getCueAsSource()><code>getCueAsSource()</code></dfn>
- method must return the raw <a href=#timed-track-cue-text>timed track cue text</a>.</p>
+ <p>The <dfn id=dom-texttrackcue-getcueassource title=dom-TextTrackCue-getCueAsSource><code>getCueAsSource()</code></dfn>
+ method must return the raw <a href=#text-track-cue-text>text track cue text</a>.</p>
- <p>The <dfn id=dom-timedtrackcue-getcueashtml() title=dom-TimedTrackCue-getCueAsHTML()><code>getCueAsHTML()</code></dfn>
- method must convert the <a href=#timed-track-cue-text>timed track cue text</a> to a
+ <p>The <dfn id=dom-texttrackcue-getcueashtml title=dom-TextTrackCue-getCueAsHTML><code>getCueAsHTML()</code></dfn>
+ method must convert the <a href=#text-track-cue-text>text track cue text</a> to a
<code><a href=#documentfragment>DocumentFragment</a></code> for the <a href=#media-element>media element</a>'s
<code><a href=#document>Document</a></code>, using the appropriate rules for doing
so.
@@ -29050,19 +29048,19 @@
<p>The following are the <a href=#event-handlers>event handlers</a> that must be
supported, as IDL attributes, by all objects implementing the
- <code><a href=#timedtrack>TimedTrack</a></code> interface:</p>
+ <code><a href=#texttrack>TextTrack</a></code> interface:</p>
<table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
- <tbody><tr><td><dfn id=handler-timedtrack-onload title=handler-TimedTrack-onload><code>onload</code></dfn> <td> <code title=event-load>load</code>
- <tr><td><dfn id=handler-timedtrack-onerror title=handler-TimedTrack-onerror><code>onerror</code></dfn> <td> <code title=event-error>error</code>
- <tr><td><dfn id=handler-timedtrack-oncuechange title=handler-TimedTrack-oncuechange><code>oncuechange</code></dfn> <td> <code title=event-cuechange>cuechange</code>
+ <tbody><tr><td><dfn id=handler-texttrack-onload title=handler-TextTrack-onload><code>onload</code></dfn> <td> <code title=event-load>load</code>
+ <tr><td><dfn id=handler-texttrack-onerror title=handler-TextTrack-onerror><code>onerror</code></dfn> <td> <code title=event-error>error</code>
+ <tr><td><dfn id=handler-texttrack-oncuechange title=handler-TextTrack-oncuechange><code>oncuechange</code></dfn> <td> <code title=event-cuechange>cuechange</code>
</table><p>The following are the <a href=#event-handlers>event handlers</a> that must be
supported, as IDL attributes, by all objects implementing the
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> interface:</p>
+ <code><a href=#texttrackcue>TextTrackCue</a></code> interface:</p>
<table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
- <tbody><tr><td><dfn id=handler-timedtrackcue-onenter title=handler-TimedTrackCue-onenter><code>onenter</code></dfn> <td> <code title=event-enter>enter</code>
- <tr><td><dfn id=handler-timedtrackcue-onexit title=handler-TimedTrackCue-onexit><code>onexit</code></dfn> <td> <code title=event-exit>exit</code>
+ <tbody><tr><td><dfn id=handler-texttrackcue-onenter title=handler-TextTrackCue-onenter><code>onenter</code></dfn> <td> <code title=event-enter>enter</code>
+ <tr><td><dfn id=handler-texttrackcue-onexit title=handler-TextTrackCue-onexit><code>onexit</code></dfn> <td> <code title=event-exit>exit</code>
</table></div>
<!--KEEP-START w3c-html--><!--TT-->
@@ -29070,8 +29068,8 @@
<h5 id=webvtt-0><span class=secno>4.8.10.11 </span>WebVTT</h5>
- <p>The <dfn id=webvtt>WebVTT</dfn> format (Web Subtitle Resource Tracks) is a
- format intended for marking up external timed track resources.</p>
+ <p>The <dfn id=webvtt>WebVTT</dfn> format (Web Video Text Tracks) is a
+ format intended for marking up external text track resources.</p>
<h6 id=syntax-0><span class=secno>4.8.10.11.1 </span>Syntax</h6>
@@ -29118,7 +29116,7 @@
validating <a href=#webvtt>WebVTT</a> files, may offer to restrict all cues
to only having <a href=#webvtt-cue-text>WebVTT cue text</a> as their <a href=#cue-payload>cue
payload</a>; <a href=#webvtt-metadata-text>WebVTT metadata text</a> cues are only
- useful for scripted applications (using the <code title=dom-timedtrack-kind-metadata><a href=#dom-timedtrack-kind-metadata>metadata</a></code> <a href=#timed-track-kind>timed
+ useful for scripted applications (using the <code title=dom-timedtrack-kind-metadata>metadata</code> <a href=#text-track-kind>text
track kind</a>).</p>
<p>A <a href=#webvtt-file>WebVTT file</a> whose cues all have a <a href=#cue-payload>cue
@@ -29429,12 +29427,12 @@
<h6 id=parsing-0><span class=secno>4.8.10.11.2 </span>Parsing</h6>
<p>A <dfn id=webvtt-parser>WebVTT parser</dfn>, given an input byte stream and a
- <a href=#timed-track-list-of-cues>timed track list of cues</a> <var title="">output</var>,
+ <a href=#text-track-list-of-cues>text track list of cues</a> <var title="">output</var>,
must <a href=#decoded-as-utf-8,-with-error-handling title="decoded as UTF-8, with error handling">decode the
byte stream as UTF-8, with error handling</a>, and then must
parse the resulting string according to the <a href=#webvtt-parser-algorithm>WebVTT parser
- algorithm</a> below. This results in <a href=#timed-track-cue title="timed track
- cue">timed track cues</a> being added to <var title="">output</var>. <a href=#refsRFC3629>[RFC3629]</a></p>
+ algorithm</a> below. This results in <a href=#text-track-cue title="text track
+ cue">text track cues</a> being added to <var title="">output</var>. <a href=#refsRFC3629>[RFC3629]</a></p>
<p>A <a href=#webvtt-parser>WebVTT parser</a>, specifically its conversion and
parsing steps, is typically run asynchronously, with the input byte
@@ -29531,38 +29529,38 @@
characters</a> that are either U+000D CARRIAGE RETURN (CR) or
U+000A LINE FEED (LF) characters.</li>
- <li><p>Let <var title="">cue</var> be a new <a href=#timed-track-cue>timed track
- cue</a> associated with <var title="">output</var>'s <a href=#timed-track>timed
+ <li><p>Let <var title="">cue</var> be a new <a href=#text-track-cue>text track
+ cue</a> associated with <var title="">output</var>'s <a href=#text-track>text
track</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-identifier>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-identifier>text track cue
identifier</a> be the empty string.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-pause-on-exit-flag>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-pause-on-exit-flag>text track cue
pause-on-exit flag</a> be false.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-writing-direction>timed track cue
- writing direction</a> be <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-writing-direction>text track cue
+ writing direction</a> be <a href=#text-track-cue-horizontal-writing-direction title="text track cue
horizontal writing direction">horizontal</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-snap-to-lines-flag>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-snap-to-lines-flag>text track cue
snap-to-lines flag</a> be true.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-line-position>timed track cue line
- position</a> be <a href=#timed-track-cue-automatic-line-position title="timed track cue automatic line
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-line-position>text track cue line
+ position</a> be <a href=#text-track-cue-automatic-line-position title="text track cue automatic line
position">auto</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-text-position>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-text-position>text track cue
text position</a> be 50.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-size>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-size>text track cue
size</a> be 100.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-alignment>timed track cue
- alignment</a> be <a href=#timed-track-cue-middle-alignment title="timed track cue middle
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-alignment>text track cue
+ alignment</a> be <a href=#text-track-cue-middle-alignment title="text track cue middle
alignment">middle alignment</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-text>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-text>text track cue
text</a> be the empty string.</li>
<li><p><a href=#collect-a-sequence-of-characters>Collect a sequence of characters</a> that are
@@ -29579,7 +29577,7 @@
HYPHEN-MINUS, U+003E GREATER-THAN SIGN), then jump to the step
labeled <i>timings</i> below.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-identifier>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-identifier>text track cue
identifier</a> be <var title="">line</var>.<p></li>
<li><p>If <var title="">position</var> is past the end of <var title="">input</var>, then discard <var title="">cue</var> and jump
@@ -29640,14 +29638,14 @@
<li><p>Return to the step labeled <i>cue text loop</i>.</li>
- <li><p><i>Cue text processing</i>: Let the <a href=#timed-track-cue-text>timed track cue
+ <li><p><i>Cue text processing</i>: Let the <a href=#text-track-cue-text>text track cue
text</a> of <var title="">cue</var> be <var title="">cue
text</var>, and let the rules for its interpretation be the
<a href=#webvtt-cue-text-parsing-rules>WebVTT cue text parsing rules</a>, the <a href=#webvtt-cue-text-rendering-rules>WebVTT cue
text rendering rules</a>, and the <a href=#webvtt-cue-text-dom-construction-rules>WebVTT cue text DOM
construction rules</a>.</li>
- <li><p>Add <var title="">cue</var> to the <a href=#timed-track-list-of-cues>timed track list of
+ <li><p>Add <var title="">cue</var> to the <a href=#text-track-list-of-cues>text track list of
cues</a> <var title="">output</var>.</li>
<li><p>Jump to the step labeled <i>cue loop</i>.</li>
@@ -29685,7 +29683,7 @@
</ol><p>When the algorithm above requires that the user agent
<dfn id=collect-webvtt-cue-timings-and-settings>collect WebVTT cue timings and settings</dfn> from a string
- <var title="">input</var> for a <a href=#timed-track-cue>timed track cue</a> <var title="">cue</var>, the user agent must run the following
+ <var title="">input</var> for a <a href=#text-track-cue>text track cue</a> <var title="">cue</var>, the user agent must run the following
algorithm.</p>
<ol><li><p>Let <var title="">input</var> be the string being
@@ -29698,7 +29696,7 @@
<li><p><a href=#collect-a-webvtt-timestamp>Collect a WebVTT timestamp</a>. If that algorithm
fails, then abort these steps and return failure. Otherwise, let
- <var title="">cue</var>'s <a href=#timed-track-cue-start-time>timed track cue start time</a>
+ <var title="">cue</var>'s <a href=#text-track-cue-start-time>text track cue start time</a>
be the collected time.</li>
<li><p><a href=#skip-whitespace>Skip whitespace</a>.</li>
@@ -29723,7 +29721,7 @@
<li><p><a href=#collect-a-webvtt-timestamp>Collect a WebVTT timestamp</a>. If that algorithm
fails, then abort these steps and return failure. Otherwise, let
- <var title="">cue</var>'s <a href=#timed-track-cue-end-time>timed track cue end time</a>
+ <var title="">cue</var>'s <a href=#text-track-cue-end-time>text track cue end time</a>
be the collected time.</li>
<li><p><a href=#skip-whitespace>Skip whitespace</a>.</li>
@@ -29731,7 +29729,7 @@
<li><p><a href=#parse-the-webvtt-settings>Parse the WebVTT settings</a> for <var title="">cue</var>.</li>
</ol><p>When the user agent is to <dfn id=parse-the-webvtt-settings>parse the WebVTT settings</dfn>
- for a <a href=#timed-track-cue>timed track cue</a> <var title="">cue</var>, the
+ for a <a href=#text-track-cue>text track cue</a> <var title="">cue</var>, the
user agent must run the following steps:</p>
<ol><li><p>Let <var title="">input</var> and <var title="">position</var> be the same variables as those of the same
@@ -29770,12 +29768,12 @@
<li><p>If <var title="">value</var> is a
<a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">vertical</code>", then let <var title="">cue</var>'s
- <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> be <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing
+ <a href=#text-track-cue-writing-direction>text track cue writing direction</a> be <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing
direction">vertical growing left</a>.</li>
<li><p>Otherwise, if <var title="">value</var> is a
- <a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">vertical-lr</code>", then let <var title="">cue</var>'s <a href=#timed-track-cue-writing-direction>timed track cue writing
- direction</a> be <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical
+ <a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">vertical-lr</code>", then let <var title="">cue</var>'s <a href=#text-track-cue-writing-direction>text track cue writing
+ direction</a> be <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical
growing right writing direction">vertical growing
right</a>.</li>
@@ -29816,7 +29814,7 @@
<i>settings</i>.</li>
<li><p>If the last character in <var title="">value</var> is a
- U+0025 PERCENT SIGN character (%), then let <var title="">cue</var>'s <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines
+ U+0025 PERCENT SIGN character (%), then let <var title="">cue</var>'s <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines
flag</a> to true.</li>
<li><p>Ignoring the trailing percent sign, if any, interpret
@@ -29827,7 +29825,7 @@
the range 0 ≤ <var title="">number</var> ≤ 100, then jump back to the
step labeled <i>settings</i>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-line-position>timed track cue line
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-line-position>text track cue line
position</a> be <var title="">number</var>.</li>
</ol></dd>
@@ -29867,7 +29865,7 @@
0 ≤ <var title="">number</var> ≤ 100,
then jump back to the step labeled <i>settings</i>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-text-position>timed track cue text
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-text-position>text track cue text
position</a> be <var title="">number</var>.</li>
</ol></dd>
@@ -29907,7 +29905,7 @@
0 ≤ <var title="">number</var> ≤ 100,
then jump back to the step labeled <i>settings</i>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-size>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-size>text track cue
size</a> be <var title="">number</var>.</li>
</ol></dd>
@@ -29923,17 +29921,17 @@
<li><p>If <var title="">value</var> is a
<a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">start</code>", then let <var title="">cue</var>'s
- <a href=#timed-track-cue-alignment>timed track cue alignment</a> be <a href=#timed-track-cue-start-alignment title="timed
+ <a href=#text-track-cue-alignment>text track cue alignment</a> be <a href=#text-track-cue-start-alignment title="text
track cue start alignment">start alignment</a>.</li>
<li><p>If <var title="">value</var> is a
<a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">middle</code>", then let <var title="">cue</var>'s
- <a href=#timed-track-cue-alignment>timed track cue alignment</a> be <a href=#timed-track-cue-middle-alignment title="timed
+ <a href=#text-track-cue-alignment>text track cue alignment</a> be <a href=#text-track-cue-middle-alignment title="text
track cue middle alignment">middle alignment</a>.</li>
<li><p>If <var title="">value</var> is a
<a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">end</code>", then let <var title="">cue</var>'s
- <a href=#timed-track-cue-alignment>timed track cue alignment</a> be <a href=#timed-track-cue-end-alignment title="timed
+ <a href=#text-track-cue-alignment>text track cue alignment</a> be <a href=#text-track-cue-end-alignment title="text
track cue end alignment">end alignment</a>.</li>
</ol></dd>
@@ -30725,7 +30723,7 @@
<p>Where possible (specifically, for starting, stopping, pausing,
and unpausing playback, for seeking,
<!--KEEP-END w3c-html--><!--TT-->
- for listing, enabling, and disabling timed tracks,
+ for listing, enabling, and disabling text tracks,
<!--KEEP-START w3c-html--><!--TT-->
and for muting or changing the volume of the audio), user interface
features exposed by the user agent must be implemented in terms of
@@ -30734,14 +30732,14 @@
<!--KEEP-END w3c-html--><!--TT-->
<p>For the purposes of listing chapters in the <a href=#media-resource>media
- resource</a>, only <a href=#timed-track title="timed track">timed tracks</a>
- in the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed
- tracks</a> <a href=#timed-track-showing title="timed track showing">showing</a> or
- <a href=#timed-track-showing-by-default title="timed track showing by default">showing by
- default</a> and whose <a href=#timed-track-kind>timed track kind</a> is <code title=dom-timedtrack-kind-chapters><a href=#dom-timedtrack-kind-chapters>chapters</a></code> should be used.
- Each <a href=#timed-track-cue title="timed track cue">cue</a> in such a <a href=#timed-track>timed
- track</a> represents a chapter starting at the cue's <a href=#timed-track-cue-start-time title="timed track cue start time">start time</a>. The name of
- the chapter is the <a href=#timed-track-cue-text>timed track cue text</a>, interpreted
+ resource</a>, only <a href=#text-track title="text track">text tracks</a>
+ in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text
+ tracks</a> <a href=#text-track-showing title="text track showing">showing</a> or
+ <a href=#text-track-showing-by-default title="text track showing by default">showing by
+ default</a> and whose <a href=#text-track-kind>text track kind</a> is <code title=dom-timedtrack-kind-chapters>chapters</code> should be used.
+ Each <a href=#text-track-cue title="text track cue">cue</a> in such a <a href=#text-track>text
+ track</a> represents a chapter starting at the cue's <a href=#text-track-cue-start-time title="text track cue start time">start time</a>. The name of
+ the chapter is the <a href=#text-track-cue-text>text track cue text</a>, interpreted
literally.</p>
<!--KEEP-START w3c-html--><!--TT-->
@@ -31005,7 +31003,7 @@
<td><code><a href=#event>Event</a></code>
<td>The user agent has just determined the duration and dimensions of the <a href=#media-resource>media resource</a>
<!--KEEP-END w3c-html--><!--TT-->
- and <a href=#the-timed-tracks-are-ready>the timed tracks are ready</a>.
+ and <a href=#the-text-tracks-are-ready>the text tracks are ready</a>.
<!--KEEP-START w3c-html--><!--TT-->
<td><code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> is newly equal to <code title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code> or greater for the first time.
<tr><td><dfn id=event-media-loadeddata title=event-media-loadeddata><code>loadeddata</code></dfn>
@@ -85352,12 +85350,12 @@
<p>When the user agent starts <a href=#expose-a-user-interface-to-the-user title="expose a user interface
to the user">exposing a user interface</a> for a
- <code><a href=#video>video</a></code> element, user agents should run the <a href=#rules-for-updating-the-timed-track-rendering>rules
- for updating the timed track rendering</a> of each of the <a href=#timed-track title="timed track">timed tracks</a> in the <code><a href=#video>video</a></code>
- element's <a href=#list-of-timed-tracks>list of timed tracks</a> that are <a href=#timed-track-showing title="timed track showing">showing</a> or <a href=#timed-track-showing-by-default title="timed
- track showing by default">showing by default</a> (e.g., for <a href=#timed-track title="timed track">timed tracks</a> based on
- <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the display of
- WebVTT timed tracks</a>).</p>
+ <code><a href=#video>video</a></code> element, user agents should run the <a href=#rules-for-updating-the-text-track-rendering>rules
+ for updating the text track rendering</a> of each of the <a href=#text-track title="text track">text tracks</a> in the <code><a href=#video>video</a></code>
+ element's <a href=#list-of-text-tracks>list of text tracks</a> that are <a href=#text-track-showing title="text track showing">showing</a> or <a href=#text-track-showing-by-default title="text
+ track showing by default">showing by default</a> (e.g., for <a href=#text-track title="text track">text tracks</a> based on
+ <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the display of
+ WebVTT text tracks</a>).</p>
<!--KEEP-START w3c-html--><!--TT-->
<p class=note>Resizing <code><a href=#video>video</a></code> and <code><a href=#the-canvas-element>canvas</a></code>
@@ -85376,7 +85374,7 @@
<!--<div data-component="other Hixie drafts (editor: Ian Hickson)">-->
<div class=impl>
- <h4 id=timed-tracks><span class=secno>14.3.2 </span>Timed tracks</h4>
+ <h4 id=timed-text-tracks-0><span class=secno>14.3.2 </span>Timed text tracks</h4>
<p class=note>This section is intended to be moved to its own CSS
module once an editor is found to run with it.</p>
@@ -85384,11 +85382,11 @@
<h5 id=webvtt-cue-text-rendering-rules><span class=secno>14.3.2.1 </span><dfn>WebVTT cue text rendering rules</dfn></h5>
- <p>The <dfn id=rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the display of WebVTT timed
- tracks</dfn> render the <a href=#timed-track title="timed track">timed
+ <p>The <dfn id=rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the display of WebVTT text
+ tracks</dfn> render the <a href=#text-track title="text track">text
tracks</a> of a <a href=#media-element>media element</a> (specifically, a
<code><a href=#video>video</a></code> element), or of another playback mechanism, by
- applying the steps below. All the <a href=#timed-track title="timed track">timed
+ applying the steps below. All the <a href=#text-track title="text track">text
tracks</a> that use these rules for a given <a href=#media-element>media
element</a>, or other playback mechanism, are rendered together,
to avoid overlapping subtitles from multiple tracks.</p>
@@ -85420,35 +85418,35 @@
user interface</a> for <var title="">video</var>, but now it is,
let <var title="">reset</var> be true. Otherwise, let <var title="">reset</var> be false.</p>
- <li><p>Let <var title="">tracks</var> be the subset of <var title="">video</var>'s <a href=#list-of-timed-tracks>list of timed tracks</a> that have
- as their <a href=#rules-for-updating-the-timed-track-rendering>rules for updating the timed track rendering</a>
- these <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the display of WebVTT timed
- tracks</a>, and whose <a href=#timed-track-mode>timed track mode</a> is <a href=#timed-track-showing title="timed track showing">showing</a> or <a href=#timed-track-showing-by-default title="timed
+ <li><p>Let <var title="">tracks</var> be the subset of <var title="">video</var>'s <a href=#list-of-text-tracks>list of text tracks</a> that have
+ as their <a href=#rules-for-updating-the-text-track-rendering>rules for updating the text track rendering</a>
+ these <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the display of WebVTT text
+ tracks</a>, and whose <a href=#text-track-mode>text track mode</a> is <a href=#text-track-showing title="text track showing">showing</a> or <a href=#text-track-showing-by-default title="text
track showing by default">showing by default</a>.</li>
- <li><p>Let <var title="">cues</var> be an empty list of <a href=#timed-track-cue title="timed track cue">timed track cues</a>.</li>
+ <li><p>Let <var title="">cues</var> be an empty list of <a href=#text-track-cue title="text track cue">text track cues</a>.</li>
<li><p>For each track <var title="">track</var> in <var title="">tracks</var>, append to <var title="">cues</var> all the
- <a href=#timed-track-cue title="timed track cue">cues</a> from <var title="">track</var>'s <a href=#timed-track-list-of-cues title="timed track list of cues">list
- of cues</a> that have their <a href=#timed-track-cue-active-flag>timed track cue active
+ <a href=#text-track-cue title="text track cue">cues</a> from <var title="">track</var>'s <a href=#text-track-list-of-cues title="text track list of cues">list
+ of cues</a> that have their <a href=#text-track-cue-active-flag>text track cue active
flag</a> set.</li>
<li><p>If <var title="">reset</var> is false, then, for each
- <a href=#timed-track-cue>timed track cue</a> <var title="">cue</var> in <var title="">cues</var>: if <var title="">cue</var>'s <a href=#timed-track-cue-display-state>timed track
+ <a href=#text-track-cue>text track cue</a> <var title="">cue</var> in <var title="">cues</var>: if <var title="">cue</var>'s <a href=#text-track-cue-display-state>text track
cue display state</a> has a set of CSS boxes, then add those
boxes to <var title="">output</var>, and remove <var title="">cue</var> from <var title="">cues</var>.</li>
<li>
- <p>For each <a href=#timed-track-cue>timed track cue</a> <var title="">cue</var>
+ <p>For each <a href=#text-track-cue>text track cue</a> <var title="">cue</var>
in <var title="">cues</var> that has not yet had corresponding CSS
- boxes added to <var title="">output</var>, in <a href=#timed-track-cue-order>timed track
+ boxes added to <var title="">output</var>, in <a href=#text-track-cue-order>text track
cue order</a>, run the following substeps:</p>
<ol><li><p>Let <var title="">nodes</var> be the <a href=#list-of-webvtt-node-objects>list of WebVTT
Node Objects</a> obtained by applying the <a href=#webvtt-cue-text-parsing-rules>WebVTT cue
text parsing rules</a> to the <var title="">cue</var>'s
- <a href=#timed-track-cue-text>timed track cue text</a>.</p>
+ <a href=#text-track-cue-text>text track cue text</a>.</p>
<li>
@@ -85475,14 +85473,14 @@
</li>
- <li><p>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is
- <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing
- direction">horizontal</a>, then let <var title="">block-flow</var> be 'tb'. Otherwise, if the <a href=#timed-track-cue-writing-direction>timed
- track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track
+ <li><p>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is
+ <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing
+ direction">horizontal</a>, then let <var title="">block-flow</var> be 'tb'. Otherwise, if the <a href=#text-track-cue-writing-direction>text
+ track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track
cue vertical growing left writing direction">vertical growing
left</a>, then let <var title="">block-flow</var> be
- 'lr'. Otherwise, the <a href=#timed-track-cue-writing-direction>timed track cue writing
- direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing
+ 'lr'. Otherwise, the <a href=#text-track-cue-writing-direction>text track cue writing
+ direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing
right writing direction">vertical growing right</a>; let <var title="">block-flow</var> be 'rl'.</li>
<li>
@@ -85491,77 +85489,77 @@
<var title="">cue</var> as per the appropriate rules from the
following list:</p>
- <dl class=switch><dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a>,
+ <dl class=switch><dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a>,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a>,
and <var title="">direction</var> is 'rtl'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a></dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a></dt>
<dd>
- <p>Let <var title="">maximum size</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> subtracted from 100.</p>
+ <p>Let <var title="">maximum size</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> subtracted from 100.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a>,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a>,
and <var title="">direction</var> is 'rtl'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a></dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a></dt>
<dd>
- <p>Let <var title="">maximum size</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a>.</p>
+ <p>Let <var title="">maximum size</var> be the <a href=#text-track-cue-text-position>text track cue text position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- the <a href=#timed-track-cue-text-position>timed track cue text position</a> is less than or equal to 50,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ the <a href=#text-track-cue-text-position>text track cue text position</a> is less than or equal to 50,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- the <a href=#timed-track-cue-text-position>timed track cue text position</a> is greater than <!-- or equal to --> 50,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ the <a href=#text-track-cue-text-position>text track cue text position</a> is greater than <!-- or equal to --> 50,
and <var title="">direction</var> is 'rtl'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- and the <a href=#timed-track-cue-text-position>timed track cue text position</a> is less than or equal to 50</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- and the <a href=#timed-track-cue-text-position>timed track cue text position</a> is less than or equal to 50</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ and the <a href=#text-track-cue-text-position>text track cue text position</a> is less than or equal to 50</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ and the <a href=#text-track-cue-text-position>text track cue text position</a> is less than or equal to 50</dt>
<dd>
- <p>Let <var title="">maximum size</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> multiplied by two.</p>
+ <p>Let <var title="">maximum size</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> multiplied by two.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- the <a href=#timed-track-cue-text-position>timed track cue text position</a> is greater than <!-- or equal to --> 50,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ the <a href=#text-track-cue-text-position>text track cue text position</a> is greater than <!-- or equal to --> 50,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- the <a href=#timed-track-cue-text-position>timed track cue text position</a> is less than or equal to 50,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ the <a href=#text-track-cue-text-position>text track cue text position</a> is less than or equal to 50,
and <var title="">direction</var> is 'rtl'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- and the <a href=#timed-track-cue-text-position>timed track cue text position</a> is greater than <!-- or equal to --> 50</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- and the <a href=#timed-track-cue-text-position>timed track cue text position</a> is greater than <!-- or equal to --> 50</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ and the <a href=#text-track-cue-text-position>text track cue text position</a> is greater than <!-- or equal to --> 50</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ and the <a href=#text-track-cue-text-position>text track cue text position</a> is greater than <!-- or equal to --> 50</dt>
<dd>
- <p>Let <var title="">maximum size</var> be the result of subtracting <a href=#timed-track-cue-text-position>timed track cue text position</a> from 100 and then multiplying the result by two.</p>
+ <p>Let <var title="">maximum size</var> be the result of subtracting <a href=#text-track-cue-text-position>text track cue text position</a> from 100 and then multiplying the result by two.</p>
</dd>
</dl></li>
- <li><p>If the <a href=#timed-track-cue-size>timed track cue size</a> is less than <var title="">maximum size</var>, then let <var title="">size</var> be
- <a href=#timed-track-cue-size>timed track cue size</a>. Otherwise, let <var title="">size</var> be <var title="">maximum size</var>.</li>
+ <li><p>If the <a href=#text-track-cue-size>text track cue size</a> is less than <var title="">maximum size</var>, then let <var title="">size</var> be
+ <a href=#text-track-cue-size>text track cue size</a>. Otherwise, let <var title="">size</var> be <var title="">maximum size</var>.</li>
- <li><p>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is
- <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing
+ <li><p>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is
+ <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing
direction">horizontal</a>, then let <var title="">width</var>
be '<var title="">size</var> vw' and <var title="">height</var> be 'auto'. Otherwise, let <var title="">width</var> be 'auto' and <var title="">height</var> be
'<var title="">size</var> vh'. (These are CSS values used
@@ -85573,63 +85571,63 @@
<p>Determine the value of <var title="">x-position</var> or <var title="">y-position</var> for <var title="">cue</var> as per the
appropriate rules from the following list:</p>
- <dl class=switch><dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a>,
+ <dl class=switch><dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a>,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a>,
and <var title="">direction</var> is 'rtl'</dt>
<dd>
- <p>Let <var title="">x-position</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a>.</p>
+ <p>Let <var title="">x-position</var> be the <a href=#text-track-cue-text-position>text track cue text position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a>,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a>,
and <var title="">direction</var> is 'rtl'</dt>
<dd>
- <p>Let <var title="">x-position</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> subtracted from 100.</p>
+ <p>Let <var title="">x-position</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> subtracted from 100.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a></dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a></dt>
<dd>
- <p>Let <var title="">y-position</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a>.</p>
+ <p>Let <var title="">y-position</var> be the <a href=#text-track-cue-text-position>text track cue text position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a></dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a></dt>
<dd>
- <p>Let <var title="">y-position</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> subtracted from 100.</p>
+ <p>Let <var title="">y-position</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> subtracted from 100.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
and <var title="">direction</var> is 'ltr'</dt>
<dd>
- <p>Let <var title="">x-position</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> minus half of <var title="">size</var>.</p>
+ <p>Let <var title="">x-position</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> minus half of <var title="">size</var>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
and <var title="">direction</var> is 'rtl'</dt>
<dd>
- <p>Let <var title="">x-position-reverse</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> minus half of <var title="">size</var>.</p>
+ <p>Let <var title="">x-position-reverse</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> minus half of <var title="">size</var>.</p>
<p>Let <var title="">x-position</var> be <var title="">x-position-reverse</var> subtracted from 100.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a></dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a></dt>
<dd>
- <p>Let <var title="">y-position</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> minus half of <var title="">size</var>.</p>
+ <p>Let <var title="">y-position</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> minus half of <var title="">size</var>.</p>
</dd>
</dl></li>
@@ -85640,32 +85638,32 @@
not yet calculated for <var title="">cue</var> as per the
appropriate rules from the following list:</p>
- <dl class=switch><dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- and the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is set</dt>
+ <dl class=switch><dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ and the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is set</dt>
<dd>
<p>Let <var title="">y-position</var> be zero.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- and the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is not set</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ and the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is not set</dt>
<dd>
- <p>Let <var title="">y-position</var> be the <a href=#timed-track-cue-line-position>timed track cue line position</a>.</p>
+ <p>Let <var title="">y-position</var> be the <a href=#text-track-cue-line-position>text track cue line position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is set</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is set</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is set</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is set</dt>
<dd>
<p>Let <var title="">x-position</var> be zero.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is not set</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is not set</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is not set</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is not set</dt>
<dd>
- <p>Let <var title="">x-position</var> be the <a href=#timed-track-cue-line-position>timed track cue line position</a>.</p>
+ <p>Let <var title="">x-position</var> be the <a href=#text-track-cue-line-position>text track cue line position</a>.</p>
</dd>
</dl></li>
@@ -85735,26 +85733,26 @@
<p>Adjust the positions of <var title="">boxes</var> according
to the appropriate steps from the following list:</p>
- <dl class=switch><dt>If <var title="">cue</var>'s <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is set</dt>
+ <dl class=switch><dt>If <var title="">cue</var>'s <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is set</dt>
<dd>
<p>Many of the steps in this algorithm vary according to the
- <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a>. Steps labeled
+ <a href=#text-track-cue-writing-direction>text track cue writing direction</a>. Steps labeled
"<strong>Horizontal</strong>" must be followed only when the
- <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing
+ <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing
direction">horizontal</a>, steps labeled
"<strong>Vertical</strong>" must be followed when the
- <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is either <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing
- direction">vertical growing left</a> or <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed
+ <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is either <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing
+ direction">vertical growing left</a> or <a href=#text-track-cue-vertical-growing-right-writing-direction title="text
track cue vertical growing right writing direction">vertical
growing right</a>, steps labeled "<strong>Vertical Growing
- Left</strong>" must be followed only when the <a href=#timed-track-cue-writing-direction>timed
- track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track
+ Left</strong>" must be followed only when the <a href=#text-track-cue-writing-direction>text
+ track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track
cue vertical growing left writing direction">vertical growing
left</a>, and steps labeled "<strong>Vertical Growing
- Right</strong>" must be followed only when the <a href=#timed-track-cue-writing-direction>timed
- track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track
+ Right</strong>" must be followed only when the <a href=#text-track-cue-writing-direction>text
+ track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track
cue vertical growing right writing direction">vertical growing
right</a>.</p>
@@ -85772,7 +85770,7 @@
step labeled <i>done positioning</i> below.</li>
<li><p>Let <var title="">line position</var> be the
- <a href=#timed-track-cue-line-position>timed track cue line position</a>.</li>
+ <a href=#text-track-cue-line-position>text track cue line position</a>.</li>
<li><p><strong>Vertical Growing Left</strong>: Add one to
<var title="">line position</var> then negate it.</li>
@@ -85861,7 +85859,7 @@
</ol></dd>
- <dt>If <var title="">cue</var>'s <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is not set</dt>
+ <dt>If <var title="">cue</var>'s <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is not set</dt>
<dd>
<ol><li>
@@ -85869,35 +85867,35 @@
<p>Set up <var title="">x</var> and <var title="">y</var> as
follows:</p>
- <dl class=switch><dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
+ <dl class=switch><dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
and <var title="">direction</var> is 'ltr'</dt>
<dd>
<p>Let <var title="">x</var> be a percentage given by the
- <a href=#timed-track-cue-text-position>timed track cue text position</a>, and let <var title="">y</var> be a percentage given by the <a href=#timed-track-cue-line-position>timed
+ <a href=#text-track-cue-text-position>text track cue text position</a>, and let <var title="">y</var> be a percentage given by the <a href=#text-track-cue-line-position>text
track cue line position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
and <var title="">direction</var> is 'rtl'</dt>
<dd>
<p>Let <var title="">x</var> be a percentage given by the
- <a href=#timed-track-cue-text-position>timed track cue text position</a> subtracted from
+ <a href=#text-track-cue-text-position>text track cue text position</a> subtracted from
100, and let <var title="">y</var> be a percentage given
- by the <a href=#timed-track-cue-line-position>timed track cue line position</a>.</p>
+ by the <a href=#text-track-cue-line-position>text track cue line position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a></dt>
<dd>
<p>Let <var title="">x</var> be a percentage given by the
- <a href=#timed-track-cue-line-position>timed track cue line position</a> subtracted from
+ <a href=#text-track-cue-line-position>text track cue line position</a> subtracted from
100, and let <var title="">y</var> be a percentage given
- by the <a href=#timed-track-cue-text-position>timed track cue text position</a>.</p>
+ by the <a href=#text-track-cue-text-position>text track cue text position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a></dt>
<dd>
<p>Let <var title="">x</var> be a percentage given by the
- <a href=#timed-track-cue-line-position>timed track cue line position</a>, and let <var title="">y</var> be a percentage given by the <a href=#timed-track-cue-text-position>timed
+ <a href=#text-track-cue-line-position>text track cue line position</a>, and let <var title="">y</var> be a percentage given by the <a href=#text-track-cue-text-position>text
track cue text position</a>.</p>
</dd>
@@ -85942,7 +85940,7 @@
not completely fit inside <var title="">video</var>'s rendering
area, remove those offending line boxes from <var title="">boxes</var>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-display-state>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-display-state>text track cue
display state</a> have the CSS boxes in <var title="">boxes</var>.</li>
<li><p>Add the CSS boxes in <var title="">boxes</var> to <var title="">output</var>.</li>
@@ -85953,8 +85951,8 @@
</ol><h5 id=applying-css-properties-to-webvtt-node-objects><span class=secno>14.3.2.2 </span>Applying CSS properties to <a href=#webvtt-node-object title="WebVTT Node Object">WebVTT Node Objects</a></h5>
- <p>When following the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the display of WebVTT
- timed tracks</a>, user agents must set properties of <a href=#webvtt-node-object title="WebVTT Node Object">WebVTT Node Objects</a> as defined in
+ <p>When following the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the display of WebVTT
+ text tracks</a>, user agents must set properties of <a href=#webvtt-node-object title="WebVTT Node Object">WebVTT Node Objects</a> as defined in
this section. <a href=#refsCSS>[CSS]</a></p>
<p>On the (root) <a href=#list-of-webvtt-node-objects>List of WebVTT Node Objects</a>, the
@@ -85965,9 +85963,9 @@
'left' property must be set to <var title="">left</var>, the 'width'
property must be set to <var title="">width</var>, and the 'height'
property must be set to <var title="">height</var>, where <var title="">direction</var>, <var title="">block-flow</var>, <var title="">top</var>, <var title="">left</var>, <var title="">width</var>, and <var title="">height</var> are the values
- with those names determined by the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the
- display of WebVTT timed tracks</a> for the <a href=#timed-track-cue>timed track
- cue</a> from whose <a href=#timed-track-cue-text title="timed track cue text">text</a>
+ with those names determined by the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the
+ display of WebVTT text tracks</a> for the <a href=#text-track-cue>text track
+ cue</a> from whose <a href=#text-track-cue-text title="text track cue text">text</a>
the <a href=#list-of-webvtt-node-objects>List of WebVTT Node Objects</a> was constructed.</p>
<p>The 'font' shorthand property on the (root) <a href=#list-of-webvtt-node-objects>List of WebVTT
@@ -86002,9 +86000,9 @@
<p>All other non-inherited properties must be set to their initial
values; inherited properties on the root <a href=#list-of-webvtt-node-objects>List of WebVTT Node
Objects</a> must inherit their values from the <a href=#media-element>media
- element</a> for which the <a href=#timed-track-cue>timed track cue</a> is being
+ element</a> for which the <a href=#text-track-cue>text track cue</a> is being
rendered, if any. If there is no <a href=#media-element>media element</a> (i.e. if
- the <a href=#timed-track>timed track</a> is being rendered for another media
+ the <a href=#text-track>text track</a> is being rendered for another media
playback mechanism), then inherited properties on the root
<a href=#list-of-webvtt-node-objects>List of WebVTT Node Objects</a> must take their initial
values.</p>
@@ -86012,14 +86010,14 @@
<h5 id=css-extensions><span class=secno>14.3.2.3 </span>CSS extensions</h5>
- <p>When a user agent is rendering one or more <a href=#timed-track-cue title="timed
- track cue">timed track cues</a> according to the <a href=#webvtt-cue-text-rendering-rules>WebVTT cue
+ <p>When a user agent is rendering one or more <a href=#text-track-cue title="text
+ track cue">text track cues</a> according to the <a href=#webvtt-cue-text-rendering-rules>WebVTT cue
text rendering rules</a>, <a href=#webvtt-node-object title="WebVTT Node Object">WebVTT
Node Objects</a> in the <a href=#list-of-webvtt-node-objects>list of WebVTT Node Objects</a>
used in the rendering can be matched by certain pseudo-selectors as
defined below. These selectors can begin or stop matching individual
<a href=#webvtt-node-object title="WebVTT Node Object">WebVTT Node Objects</a> while a
- <a href=#timed-track-cue title="timed track cue">cue</a> is being rendered, even in
+ <a href=#text-track-cue title="text track cue">cue</a> is being rendered, even in
between applications of the <a href=#webvtt-cue-text-rendering-rules>WebVTT cue text rendering
rules</a> (which are only run when the set of active cues
changes). User agents that support the pseudo-element described
@@ -86028,16 +86026,16 @@
<p>Pseudo-elements apply to elements that are matched by
selectors. For the purpose of this section, that element is the
<i>matched element</i>. The pseudo-elements defined in the following
- sections affect the styling of parts of <a href=#timed-track-cue title="timed track
- cue">timed track cues</a> that are being rendered for the
+ sections affect the styling of parts of <a href=#text-track-cue title="text track
+ cue">text track cues</a> that are being rendered for the
<i>matched element</i>.</p>
<p class=note>If the <i>matched element</i> is not a
<code><a href=#video>video</a></code> element, the pseudo-elements defined below won't
have any effect according to this specification.</p>
- <p>A CSS user agent that implements the <a href=#timed-track title="timed
- track">timed tracks</a> model must implement the '::cue' and
+ <p>A CSS user agent that implements the <a href=#text-track title="text
+ track">text tracks</a> model must implement the '::cue' and
'::cue(<var title="">selector</var>)' pseudo-elements, and the
':past' and ':future' pseudo-classes.</p>
@@ -86184,7 +86182,7 @@
<p>A <a href=#webvtt-node-object>WebVTT Node Object</a> <var title="">c</var> is
<dfn id=in-the-past>in the past</dfn> if, in a pre-order, depth-first traversal of
- the <a href=#timed-track-cue>timed track cue</a>'s <a href=#list-of-webvtt-node-objects>List of WebVTT Node
+ the <a href=#text-track-cue>text track cue</a>'s <a href=#list-of-webvtt-node-objects>List of WebVTT Node
Objects</a>, there exists a <a href=#webvtt-timestamp-object>WebVTT Timestamp Object</a>
whose value is less than the <a href=#current-playback-position>current playback position</a>
of the <a href=#media-element>media element</a> that is the <i>matched
@@ -86195,7 +86193,7 @@
<p>A <a href=#webvtt-node-object>WebVTT Node Object</a> <var title="">c</var> is
<dfn id=in-the-future>in the future</dfn> if, in a pre-order, depth-first traversal
- of the <a href=#timed-track-cue>timed track cue</a>'s <a href=#list-of-webvtt-node-objects>List of WebVTT Node
+ of the <a href=#text-track-cue>text track cue</a>'s <a href=#list-of-webvtt-node-objects>List of WebVTT Node
Objects</a>, there exists a <a href=#webvtt-timestamp-object>WebVTT Timestamp Object</a>
whose value is greater than the <a href=#current-playback-position>current playback
position</a> of the <a href=#media-element>media element</a> that is the
@@ -89558,10 +89556,10 @@
<dd>Must always be UTF-8.</dd>
<dt>Security considerations:</dt>
<dd>
- <p>Timed track files themselves pose no immediate risk unless
+ <p>Text track files themselves pose no immediate risk unless
sensitive information is included within the
data. Implementations, however, are required to follow specific
- rules when processing timed tracks, to ensure that certain
+ rules when processing text tracks, to ensure that certain
origin-based restrictions are honored. Failure to correctly
implement these rules can result in information leakage,
cross-site scripting attacks, and the like.</p>
@@ -90820,7 +90818,7 @@
<td><a href=#global-attributes title="global attributes">globals</a></td>
<td><code><a href=#htmltablerowelement>HTMLTableRowElement</a></code></td>
</tr><!--KEEP-END w3c-html--><!--TT--><tr><th><code><a href=#the-track-element>track</a></code></th>
- <td>Timed track</td>
+ <td>Timed text track</td>
<td>none</td>
<td><code><a href=#audio>audio</a></code>;
<code><a href=#video>video</a></code></td>
@@ -91331,7 +91329,7 @@
<td> <a href=#valid-date-or-time-string>Valid date or time string</a>*
<tr><th> <code title="">default</code>
<td> <code title=attr-track-default><a href=#attr-track-default>track</a></code>
- <td> Enable the track if no other <a href=#timed-track>timed track</a> is more suitable.
+ <td> Enable the track if no other <a href=#text-track>text track</a> is more suitable.
<td> <a href=#boolean-attribute>Boolean attribute</a>
<tr><th> <code title="">defer</code>
<td> <code title=attr-script-defer><a href=#attr-script-defer>script</a></code>
@@ -91504,7 +91502,7 @@
<!--KEEP-END w3c-html--><!--TT-->
<tr><th> <code title="">kind</code>
<td> <code title=attr-track-kind><a href=#attr-track-kind>track</a></code>
- <td> The type of timed track
+ <td> The type of text track
<td> "<code title=attr-track-kind-subtitles><a href=#attr-track-kind-subtitles>subtitles</a></code>";
"<code title=attr-track-kind-captions><a href=#attr-track-kind-captions>captions</a></code>";
"<code title=attr-track-kind-descriptions><a href=#attr-track-kind-descriptions>descriptions</a></code>";
@@ -91761,7 +91759,7 @@
<!--KEEP-END w3c-html--><!--TT-->
<tr><th> <code title="">srclang</code>
<td> <code title=attr-track-srclang><a href=#attr-track-srclang>track</a></code>
- <td> Language of the timed track
+ <td> Language of the text track
<td> Valid BCP 47 language tag
<!--KEEP-START w3c-html--><!--TT-->
<tr><th> <code title="">start</code>
@@ -93845,7 +93843,7 @@
<!--TT-->
<p>Thanks to the SubRip community, including in particular Zuggy and
ai4spam, for their work on the SubRip software program whose SRT
- file format was used as the basis for the WebVTT timed track file
+ file format was used as the basis for the WebVTT text track file
format.</p>
<!--TT-->
Modified: index
===================================================================
--- index 2010-12-25 06:42:53 UTC (rev 5722)
+++ index 2010-12-25 06:56:43 UTC (rev 5723)
@@ -576,14 +576,14 @@
<li><a href=#the-ready-states><span class=secno>4.8.10.7 </span>The ready states</a></li>
<li><a href=#playing-the-media-resource><span class=secno>4.8.10.8 </span>Playing the media resource</a></li>
<li><a href=#seeking><span class=secno>4.8.10.9 </span>Seeking</a></li>
- <li><a href=#text-timed-tracks><span class=secno>4.8.10.10 </span>Text timed tracks</a>
+ <li><a href=#timed-text-tracks><span class=secno>4.8.10.10 </span>Timed text tracks</a>
<ol>
- <li><a href=#timed-track-model><span class=secno>4.8.10.10.1 </span>Timed track model</a></li>
- <li><a href=#sourcing-in-band-timed-tracks><span class=secno>4.8.10.10.2 </span>Sourcing in-band timed tracks</a></li>
- <li><a href=#sourcing-out-of-band-timed-tracks><span class=secno>4.8.10.10.3 </span>Sourcing out-of-band timed tracks</a></li>
- <li><a href=#guidelines-for-exposing-cues-in-various-formats-as-timed-track-cues><span class=secno>4.8.10.10.4 </span>Guidelines for exposing cues in various formats as
- timed track cues</a></li>
- <li><a href=#timed-track-api><span class=secno>4.8.10.10.5 </span>Timed track API</a></li>
+ <li><a href=#text-track-model><span class=secno>4.8.10.10.1 </span>Text track model</a></li>
+ <li><a href=#sourcing-in-band-text-tracks><span class=secno>4.8.10.10.2 </span>Sourcing in-band text tracks</a></li>
+ <li><a href=#sourcing-out-of-band-text-tracks><span class=secno>4.8.10.10.3 </span>Sourcing out-of-band text tracks</a></li>
+ <li><a href=#guidelines-for-exposing-cues-in-various-formats-as-text-track-cues><span class=secno>4.8.10.10.4 </span>Guidelines for exposing cues in various formats as
+ text track cues</a></li>
+ <li><a href=#text-track-api><span class=secno>4.8.10.10.5 </span>Text track API</a></li>
<li><a href=#cue-events><span class=secno>4.8.10.10.6 </span>Event definitions</a></ol></li>
<li><a href=#webvtt-0><span class=secno>4.8.10.11 </span>WebVTT</a>
<ol>
@@ -1183,7 +1183,7 @@
<li><a href=#replaced-elements><span class=secno>12.3 </span>Replaced elements</a>
<ol>
<li><a href=#embedded-content-2><span class=secno>12.3.1 </span>Embedded content</a></li>
- <li><a href=#timed-tracks><span class=secno>12.3.2 </span>Timed tracks</a>
+ <li><a href=#timed-text-tracks-0><span class=secno>12.3.2 </span>Timed text tracks</a>
<ol>
<li><a href=#webvtt-cue-text-rendering-rules><span class=secno>12.3.2.1 </span>WebVTT cue text rendering rules</a></li>
<li><a href=#applying-css-properties-to-webvtt-node-objects><span class=secno>12.3.2.2 </span>Applying CSS properties to WebVTT Node Objects</a></li>
@@ -1308,7 +1308,7 @@
<ul class=brief><li>The <code><a href=#devices>device</a></code> element.</li> <!--DEVICE-->
<li>The <code title=attr-hyperlink-ping><a href=#ping>ping</a></code> attribute and related <a href=#hyperlink-auditing>hyperlink auditing</a> features.</li> <!--PING-->
- <li>The <a href=#webvtt>WebVTT</a> format and some <a href=#timed-track>timed track</a> API features.</li> <!--TT--> <!--TTVTT-->
+ <li>The <a href=#webvtt>WebVTT</a> format and some <a href=#text-track>text track</a> API features.</li> <!--TT--> <!--TTVTT-->
<li>Rules for <a href=#atom>converting HTML to Atom</a>.</li> <!--MD-->
<li>The <code title=dom-document-cssElementMap><a href=#dom-document-csselementmap>cssElementMap</a></code> feature for defining <span title="CSS element reference identifier">CSS element reference identifiers</span>.</li> <!--CSSREF-->
</ul><p>Features that are part of HTML (and this specification) but that
@@ -24396,10 +24396,10 @@
<!--KEEP-END w3c-html--><!--TT-->
<p>The <code><a href=#video>video</a></code> element also <a href=#represents>represents</a> any
- <a href=#timed-track-cue title="timed track cue">timed track cues</a> whose
- <a href=#timed-track-cue-active-flag>timed track cue active flag</a> is set and whose
- <a href=#timed-track>timed track</a> is in the <a href=#timed-track-showing title="timed track
- showing">showing</a> or <a href=#timed-track-showing-by-default title="timed track showing by
+ <a href=#text-track-cue title="text track cue">text track cues</a> whose
+ <a href=#text-track-cue-active-flag>text track cue active flag</a> is set and whose
+ <a href=#text-track>text track</a> is in the <a href=#text-track-showing title="text track
+ showing">showing</a> or <a href=#text-track-showing-by-default title="text track showing by
default">showing by default</a> modes.</p>
<!--KEEP-START w3c-html--><!--TT-->
@@ -24925,13 +24925,11 @@
attribute DOMString <a href=#dom-track-label title=dom-track-label>label</a>;
attribute boolean <a href=#dom-track-default title=dom-track-default>default</a>;
- readonly attribute <a href=#timedtrack>TimedTrack</a> <a href=#dom-track-track title=dom-track-track>track</a>;
+ readonly attribute <a href=#texttrack>TextTrack</a> <a href=#dom-track-track title=dom-track-track>track</a>;
};</pre>
</dd>
</dl><p>The <code><a href=#the-track-element>track</a></code> element allows authors to specify explicit
- external text-based <a href=#timed-track title="timed track">timed tracks</a>
- for <a href=#media-element title="media element">media elements</a>. It does not
- <a href=#represents title=represents>represent</a> anything on its own.</p>
+ external timed <a href=#text-track title="text track">text tracks</a> for <a href=#media-element title="media element">media elements</a>. It does not <a href=#represents title=represents>represent</a> anything on its own.</p>
<p>The <dfn id=attr-track-kind title=attr-track-kind><code>kind</code></dfn>
attribute is an <a href=#enumerated-attribute>enumerated attribute</a>. The following
@@ -24971,7 +24969,7 @@
the <a href=#attr-track-kind-subtitles title=attr-track-kind-subtitles>subtitles</a> state.</p>
<p>The <dfn id=attr-track-src title=attr-track-src><code>src</code></dfn> attribute
- gives the address of the timed track data. The value must be a
+ gives the address of the text track data. The value must be a
<a href=#valid-non-empty-url-potentially-surrounded-by-spaces>valid non-empty URL potentially surrounded by
spaces</a>. This attribute must be present.</p>
@@ -24995,7 +24993,7 @@
<!--TTVTT-->
<p>The <dfn id=attr-track-srclang title=attr-track-srclang><code>srclang</code></dfn>
- attribute gives the language of the timed track data. The value must
+ attribute gives the language of the text track data. The value must
be a valid BCP 47 language tag. This attribute must be present if
the element's <code title=attr-track-kind><a href=#attr-track-kind>kind</a></code> attribute is
in the <a href=#attr-track-kind-subtitles title=attr-track-kind-subtitles>subtitles</a>
@@ -25045,7 +25043,7 @@
<dd>
- <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object corresponding to the <a href=#timed-track>timed track</a> of the <code><a href=#the-track-element>track</a></code> element.</p>
+ <p>Returns the <code><a href=#texttrack>TextTrack</a></code> object corresponding to the <a href=#text-track>text track</a> of the <code><a href=#the-track-element>track</a></code> element.</p>
</dd>
@@ -25053,7 +25051,7 @@
<p>The <dfn id=dom-track-track title=dom-track-track><code>track</code></dfn> IDL
attribute must, on getting, return the <code><a href=#the-track-element>track</a></code> element's
- <a href=#timed-track>timed track</a>'s corresponding <code><a href=#timedtrack>TimedTrack</a></code>
+ <a href=#text-track>text track</a>'s corresponding <code><a href=#texttrack>TextTrack</a></code>
object.</p>
<p>The <dfn id=dom-track-src title=dom-track-src><code>src</code></dfn>, <dfn id=dom-track-srclang title=dom-track-srclang><code>srclang</code></dfn>, <dfn id=dom-track-label title=dom-track-label><code>label</code></dfn>, and <dfn id=dom-track-default title=dom-track-default><code>default</code></dfn> IDL attributes
@@ -25137,9 +25135,9 @@
attribute double <a href=#dom-media-volume title=dom-media-volume>volume</a>;
attribute boolean <a href=#dom-media-muted title=dom-media-muted>muted</a>;
<!--KEEP-END w3c-html--><!--TT-->
- // timed tracks
- readonly attribute <a href=#timedtrack>TimedTrack</a>[] <a href=#dom-media-tracks title=dom-media-tracks>tracks</a>;
- <a href=#mutabletimedtrack>MutableTimedTrack</a> <a href=#dom-media-addtrack title=dom-media-addTrack>addTrack</a>(in DOMString kind, in optional DOMString label, in optional DOMString language);
+ // text tracks
+ readonly attribute <a href=#texttrack>TextTrack</a>[] <a href=#dom-media-tracks title=dom-media-tracks>tracks</a>;
+ <a href=#mutabletexttrack>MutableTextTrack</a> <a href=#dom-media-addtrack title=dom-media-addTrack>addTrack</a>(in DOMString kind, in optional DOMString label, in optional DOMString language);
<!--KEEP-START w3c-html--><!--TT-->
};</pre>
@@ -25531,8 +25529,8 @@
<code title=dom-media-NETWORK_EMPTY><a href=#dom-media-network_empty>NETWORK_EMPTY</a></code>.</li>
<!--KEEP-END w3c-html--><!--TT-->
- <li><p><a href="#forget-the-media-element's-media-resource-specific-timed-tracks">Forget the media element's media-resource-specific
- timed tracks</a>.</li>
+ <li><p><a href="#forget-the-media-element's-media-resource-specific-text-tracks">Forget the media element's media-resource-specific
+ text tracks</a>.</li>
<!--KEEP-START w3c-html--><!--TT-->
<li><p>If <code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> is
@@ -25684,8 +25682,8 @@
<code title=dom-MediaError-MEDIA_ERR_SRC_NOT_SUPPORTED><a href=#dom-mediaerror-media_err_src_not_supported>MEDIA_ERR_SRC_NOT_SUPPORTED</a></code>.</li>
<!--KEEP-END w3c-html--><!--TT-->
- <li><p><a href="#forget-the-media-element's-media-resource-specific-timed-tracks">Forget the media element's media-resource-specific
- timed tracks</a>.</li>
+ <li><p><a href="#forget-the-media-element's-media-resource-specific-text-tracks">Forget the media element's media-resource-specific
+ text tracks</a>.</li>
<!--KEEP-START w3c-html--><!--TT-->
<li><p>Set the element's <code title=dom-media-networkState><a href=#dom-media-networkstate>networkState</a></code> attribute to
@@ -25804,8 +25802,8 @@
marked with ⌛.)</li>
<!--KEEP-END w3c-html--><!--TT-->
- <li><p>⌛ <a href="#forget-the-media-element's-media-resource-specific-timed-tracks">Forget the media element's
- media-resource-specific timed tracks</a>.</li>
+ <li><p>⌛ <a href="#forget-the-media-element's-media-resource-specific-text-tracks">Forget the media element's
+ media-resource-specific text tracks</a>.</li>
<!--KEEP-START w3c-html--><!--TT-->
<li><p>⌛ <i title="">Find next candidate</i>: Let <var title="">candidate</var> be null.</li>
@@ -25973,7 +25971,7 @@
<a href=#media-resource>media resource</a>, its dimensions, and other
metadata,
<!--KEEP-END w3c-html--><!--TT-->
- and once <a href=#the-timed-tracks-are-ready>the timed tracks are ready</a>
+ and once <a href=#the-text-tracks-are-ready>the text tracks are ready</a>
<!--KEEP-START w3c-html--><!--TT-->
</dt>
@@ -26232,15 +26230,15 @@
<!--KEEP-END w3c-html--><!--TT-->
- <dt id=found-a-media-resource-specific-timed-track>If the <a href=#media-resource>media resource</a> is found to declare a <a href=#media-resource-specific-timed-track>media-resource-specific timed track</a> that the user agent supports</dt>
+ <dt id=found-a-media-resource-specific-timed-track>If the <a href=#media-resource>media resource</a> is found to declare a <a href=#media-resource-specific-text-track>media-resource-specific text track</a> that the user agent supports</dt>
<dd>
<p>If the <a href=#media-resource>media resource</a>'s <a href=#origin>origin</a> is
the <a href=#same-origin>same origin</a> as the <a href=#media-element>media element</a>'s
<code><a href=#document>Document</a></code>'s <a href=#origin>origin</a>, <a href=#queue-a-task>queue a
- task</a> to run the <a href=#steps-to-expose-a-media-resource-specific-timed-track>steps to expose a
- media-resource-specific timed track</a> with the relevant
+ task</a> to run the <a href=#steps-to-expose-a-media-resource-specific-text-track>steps to expose a
+ media-resource-specific text track</a> with the relevant
data.</p> <!-- CORS -->
<p class=note>Cross-origin files do not expose their subtitles
@@ -26641,8 +26639,8 @@
data</a> is available for the immediate <a href=#current-playback-position>current playback
position</a>.
<!--KEEP-END w3c-html--><!--TT-->
- The <a href=#timed-track title="timed track">timed tracks</a>
- are <a href=#the-timed-tracks-are-ready title="the timed tracks are ready">ready</a>.
+ The <a href=#text-track title="text track">text tracks</a>
+ are <a href=#the-text-tracks-are-ready title="the text tracks are ready">ready</a>.
<!--KEEP-START w3c-html--><!--TT-->
</dd>
@@ -27170,29 +27168,29 @@
rerun the steps.
<!--KEEP-END w3c-html--><!--TT-->
(These steps are thus run as often as possible or needed — if
- one iteration takes a long time, this can cause certain <a href=#timed-track-cue title="timed track cue">cues</a> to be skipped over as the user
+ one iteration takes a long time, this can cause certain <a href=#text-track-cue title="text track cue">cues</a> to be skipped over as the user
agent rushes ahead to "catch up".)
<!--KEEP-START w3c-html--><!--TT-->
</p>
<ol><!--KEEP-END w3c-html--><!--TT--><li><p>Let <var title="">current cues</var> be an ordered list of
- <a href=#timed-track-cue title="timed track cue">cues</a>, initialized to contain
- all the <a href=#timed-track-cue title="timed track cue">cues</a> of all the <a href=#timed-track-hidden title="timed track hidden">hidden</a>, <a href=#timed-track-showing title="timed track
- showing">showing</a>, or <a href=#timed-track-showing-by-default title="timed track showing by
- default">showing by default</a> <a href=#timed-track title="timed track">timed
- tracks</a> of the <a href=#media-element>media element</a> (not the <a href=#timed-track-disabled title="timed track disabled">disabled</a> ones) whose <a href=#timed-track-cue-start-time title="timed track cue start time">start times</a> are less than
+ <a href=#text-track-cue title="text track cue">cues</a>, initialized to contain
+ all the <a href=#text-track-cue title="text track cue">cues</a> of all the <a href=#text-track-hidden title="text track hidden">hidden</a>, <a href=#text-track-showing title="text track
+ showing">showing</a>, or <a href=#text-track-showing-by-default title="text track showing by
+ default">showing by default</a> <a href=#text-track title="text track">text
+ tracks</a> of the <a href=#media-element>media element</a> (not the <a href=#text-track-disabled title="text track disabled">disabled</a> ones) whose <a href=#text-track-cue-start-time title="text track cue start time">start times</a> are less than
or equal to the <a href=#current-playback-position>current playback position</a> and whose
- <a href=#timed-track-cue-end-time title="timed track cue end time">end times</a> are greater
- than the <a href=#current-playback-position>current playback position</a>, in <a href=#timed-track-cue-order>timed
+ <a href=#text-track-cue-end-time title="text track cue end time">end times</a> are greater
+ than the <a href=#current-playback-position>current playback position</a>, in <a href=#text-track-cue-order>text
track cue order</a>.</li>
<li><p>Let <var title="">other cues</var> be an ordered list of
- <a href=#timed-track-cue title="timed track cue">cues</a>, initialized to contain
- all the <a href=#timed-track-cue title="timed track cue">cues</a> of <a href=#timed-track-hidden title="timed track hidden">hidden</a>, <a href=#timed-track-showing title="timed track
- showing">showing</a>, and <a href=#timed-track-showing-by-default title="timed track showing by
- default">showing by default</a> <a href=#timed-track title="timed track">timed
+ <a href=#text-track-cue title="text track cue">cues</a>, initialized to contain
+ all the <a href=#text-track-cue title="text track cue">cues</a> of <a href=#text-track-hidden title="text track hidden">hidden</a>, <a href=#text-track-showing title="text track
+ showing">showing</a>, and <a href=#text-track-showing-by-default title="text track showing by
+ default">showing by default</a> <a href=#text-track title="text track">text
tracks</a> of the <a href=#media-element>media element</a> that are not
- present in <var title="">current cues</var>, also in <a href=#timed-track-cue-order>timed
+ present in <var title="">current cues</var>, also in <a href=#text-track-cue-order>text
track cue order</a>.</li>
<!--KEEP-START w3c-html--><!--TT-->
@@ -27215,79 +27213,79 @@
while decoding the video.</li>
<!--KEEP-END w3c-html--><!--TT-->
- <li><p>If all of the <a href=#timed-track-cue title="timed track cue">cues</a> in
- <var title="">current cues</var> have their <a href=#timed-track-cue-active-flag>timed track cue
- active flag</a> set, and none of the <a href=#timed-track-cue title="timed track
+ <li><p>If all of the <a href=#text-track-cue title="text track cue">cues</a> in
+ <var title="">current cues</var> have their <a href=#text-track-cue-active-flag>text track cue
+ active flag</a> set, and none of the <a href=#text-track-cue title="text track
cue">cues</a> in <var title="">other cues</var> have their
- <a href=#timed-track-cue-active-flag>timed track cue active flag</a> set, then abort these
+ <a href=#text-track-cue-active-flag>text track cue active flag</a> set, then abort these
steps.</li>
<li><p>If the time was reached through the usual monotonic increase
of the current playback position during normal playback, and there
- are <a href=#timed-track-cue title="timed track cue">cues</a> in <var title="">other cues</var> that have both their <a href=#timed-track-cue-active-flag>timed track
- cue active flag</a> set and their <a href=#timed-track-cue-pause-on-exit-flag>timed track cue
+ are <a href=#text-track-cue title="text track cue">cues</a> in <var title="">other cues</var> that have both their <a href=#text-track-cue-active-flag>text track
+ cue active flag</a> set and their <a href=#text-track-cue-pause-on-exit-flag>text track cue
pause-on-exit flag</a> set, then immediately act as if the
element's <code title=dom-media-pause><a href=#dom-media-pause>pause()</a></code> method had
been invoked. <!-- pause() can in theory call load(), but never can
it do so as part of this invokation, since we wouldn't be in this
algorithm if the media element was empty. So, no need to couch all
this in a task. --> (In the other cases, such as explicit seeks,
- playback is not paused by going past the end time of a <a href=#timed-track-cue title="timed track cue">cue</a>, even if that <a href=#timed-track-cue title="timed
- track cue">cue</a> has its <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit
+ playback is not paused by going past the end time of a <a href=#text-track-cue title="text track cue">cue</a>, even if that <a href=#text-track-cue title="text
+ track cue">cue</a> has its <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit
flag</a> set.)</li>
- <li><p>Let <var title="">affected tracks</var> be a list of <a href=#timed-track title="timed track">timed tracks</a>, initially empty.</li>
+ <li><p>Let <var title="">affected tracks</var> be a list of <a href=#text-track title="text track">text tracks</a>, initially empty.</li>
- <li><p>For each <a href=#timed-track-cue title="timed track cue">timed track
+ <li><p>For each <a href=#text-track-cue title="text track cue">text track
cue</a> in <var title="">other cues</var> that has its
- <a href=#timed-track-cue-active-flag>timed track cue active flag</a> set, in list order,
+ <a href=#text-track-cue-active-flag>text track cue active flag</a> set, in list order,
<a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> named
<code title=event-exit>exit</code> at the
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> object, and add the <a href=#timed-track-cue title="timed
- track cue">cue</a>'s <a href=#timed-track>timed track</a> to <var title="">affected tracks</var>, if it's not already in the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object, and add the <a href=#text-track-cue title="text
+ track cue">cue</a>'s <a href=#text-track>text track</a> to <var title="">affected tracks</var>, if it's not already in the
list.</li>
- <li><p>For each <a href=#timed-track-cue title="timed track cue">timed track
+ <li><p>For each <a href=#text-track-cue title="text track cue">text track
cue</a> in <var title="">current cues</var> that does not have
- its <a href=#timed-track-cue-active-flag>timed track cue active flag</a> set, in list order,
+ its <a href=#text-track-cue-active-flag>text track cue active flag</a> set, in list order,
<a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> named
<code title=event-enter>enter</code> at the
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> object, and add the <a href=#timed-track-cue title="timed
- track cue">cue</a>'s <a href=#timed-track>timed track</a> to <var title="">affected tracks</var>, if it's not already in the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object, and add the <a href=#text-track-cue title="text
+ track cue">cue</a>'s <a href=#text-track>text track</a> to <var title="">affected tracks</var>, if it's not already in the
list.</li>
- <li><p>For each <a href=#timed-track>timed track</a> in <var title="">affected
+ <li><p>For each <a href=#text-track>text track</a> in <var title="">affected
tracks</var>, in the order they were added to the list (which will
- match the relative order of the <a href=#timed-track title="timed track">timed
- tracks</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of
- timed tracks</a>), <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a
+ match the relative order of the <a href=#text-track title="text track">text
+ tracks</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of
+ text tracks</a>), <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a
simple event</a> named <code title=event-cuechange>cuechange</code> at the
- <code><a href=#timedtrack>TimedTrack</a></code> object, and, if the <a href=#timed-track>timed
+ <code><a href=#texttrack>TextTrack</a></code> object, and, if the <a href=#text-track>text
track</a> has a corresponding <code><a href=#the-track-element>track</a></code> element, to
then <a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-cuechange>cuechange</code> at the <code><a href=#the-track-element>track</a></code>
element as well.</li>
- <li><p>Set the <a href=#timed-track-cue-active-flag>timed track cue active flag</a> of all the
- <a href=#timed-track-cue title="timed track cue">cues</a> in the <var title="">current cues</var>, and unset the <a href=#timed-track-cue-active-flag>timed track cue
- active flag</a> of all the <a href=#timed-track-cue title="timed track
+ <li><p>Set the <a href=#text-track-cue-active-flag>text track cue active flag</a> of all the
+ <a href=#text-track-cue title="text track cue">cues</a> in the <var title="">current cues</var>, and unset the <a href=#text-track-cue-active-flag>text track cue
+ active flag</a> of all the <a href=#text-track-cue title="text track
cue">cues</a> in the <var title="">other cues</var>.</li>
- <li><p>Run the <a href=#rules-for-updating-the-timed-track-rendering>rules for updating the timed track
- rendering</a> of each of the <a href=#timed-track title="timed track">timed
- tracks</a> in <var title="">affected tracks</var> that are <a href=#timed-track-showing title="timed track showing">showing</a> or <a href=#timed-track-showing-by-default title="timed
+ <li><p>Run the <a href=#rules-for-updating-the-text-track-rendering>rules for updating the text track
+ rendering</a> of each of the <a href=#text-track title="text track">text
+ tracks</a> in <var title="">affected tracks</var> that are <a href=#text-track-showing title="text track showing">showing</a> or <a href=#text-track-showing-by-default title="text
track showing by default">showing by default</a>.
<!--TTVTT-->
- For example, for <a href=#timed-track title="timed track">timed tracks</a>
- based on <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the
- display of WebVTT timed tracks</a>.
+ For example, for <a href=#text-track title="text track">text tracks</a>
+ based on <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the
+ display of WebVTT text tracks</a>.
<!--TTVTT-->
</li>
<!--KEEP-START w3c-html--><!--TT-->
- </ol><!--KEEP-END w3c-html--><!--TT--><p>For the purposes of the algorithm above, a <a href=#timed-track-cue>timed track
- cue</a> is considered to be part of a <a href=#timed-track>timed track</a>
- only if it is listed in the <a href=#timed-track-list-of-cues>timed track list of cues</a>,
- not merely if it is associated with the <a href=#timed-track>timed
+ </ol><!--KEEP-END w3c-html--><!--TT--><p>For the purposes of the algorithm above, a <a href=#text-track-cue>text track
+ cue</a> is considered to be part of a <a href=#text-track>text track</a>
+ only if it is listed in the <a href=#text-track-list-of-cues>text track list of cues</a>,
+ not merely if it is associated with the <a href=#text-track>text
track</a>.</p>
<!--KEEP-START w3c-html--><!--TT-->
@@ -27449,47 +27447,47 @@
<!--KEEP-END w3c-html--><!--TT-->
<!--<div data-component="other Hixie drafts (editor: Ian Hickson)">-->
- <h5 id=text-timed-tracks><span class=secno>4.8.10.10 </span>Text timed tracks</h5>
+ <h5 id=timed-text-tracks><span class=secno>4.8.10.10 </span>Timed text tracks</h5>
- <h6 id=timed-track-model><span class=secno>4.8.10.10.1 </span>Timed track model</h6>
+ <h6 id=text-track-model><span class=secno>4.8.10.10.1 </span>Text track model</h6>
- <p>A <a href=#media-element>media element</a> can have a group of associated <dfn id=timed-track title="timed track">timed tracks</dfn>, known as the <a href=#media-element>media
- element</a>'s <dfn id=list-of-timed-tracks>list of timed tracks</dfn>. The <a href=#timed-track title="timed track">timed tracks</a> are sorted as follows:</p>
+ <p>A <a href=#media-element>media element</a> can have a group of associated <dfn id=text-track title="text track">text tracks</dfn>, known as the <a href=#media-element>media
+ element</a>'s <dfn id=list-of-text-tracks>list of text tracks</dfn>. The <a href=#text-track title="text track">text tracks</a> are sorted as follows:</p>
- <ol class=brief><li>The <a href=#timed-track title="timed track">timed tracks</a> corresponding
+ <ol class=brief><li>The <a href=#text-track title="text track">text tracks</a> corresponding
to <code><a href=#the-track-element>track</a></code> element children of the <a href=#media-element>media
element</a>, in <a href=#tree-order>tree order</a>.</li>
- <li>Any <a href=#timed-track title="timed track">timed tracks</a> added using
+ <li>Any <a href=#text-track title="text track">text tracks</a> added using
the <code title=dom-media-addTrack><a href=#dom-media-addtrack>addTrack()</a></code> method, in
the order they were added, oldest first.</li>
- <li>Any <a href=#media-resource-specific-timed-track title="media-resource-specific timed
- track">media-resource-specific timed tracks</a> (<a href=#timed-track title="timed track">timed tracks</a> corresponding to data in
+ <li>Any <a href=#media-resource-specific-text-track title="media-resource-specific text
+ track">media-resource-specific text tracks</a> (<a href=#text-track title="text track">text tracks</a> corresponding to data in
the <a href=#media-resource>media resource</a>), in the order defined by the
<a href=#media-resource>media resource</a>'s format specification.</li>
- </ol><p>A <a href=#timed-track>timed track</a> consists of:</p>
+ </ol><p>A <a href=#text-track>text track</a> consists of:</p>
- <dl><dt><dfn id=timed-track-kind title="timed track kind">The kind of timed track</dfn>
+ <dl><dt><dfn id=text-track-kind title="text track kind">The kind of text track</dfn>
<dd>
<p>This decides how the track is handled by the user agent. The
kind is represented by a string. The possible strings are:</p>
- <ul class=brief><li><dfn id=dom-timedtrack-kind-subtitles title=dom-TimedTrack-kind-subtitles><code>subtitles</code></dfn>
- <li><dfn id=dom-timedtrack-kind-captions title=dom-TimedTrack-kind-captions><code>captions</code></dfn>
- <li><dfn id=dom-timedtrack-kind-descriptions title=dom-TimedTrack-kind-descriptions><code>descriptions</code></dfn>
- <li><dfn id=dom-timedtrack-kind-chapters title=dom-TimedTrack-kind-chapters><code>chapters</code></dfn>
- <li><dfn id=dom-timedtrack-kind-metadata title=dom-TimedTrack-kind-metadata><code>metadata</code></dfn>
- </ul><p>The <a href=#timed-track-kind title="timed track kind">kind of track</a> can
- change dynamically, in the case of a <a href=#timed-track>timed track</a>
+ <ul class=brief><li><dfn id=dom-texttrack-kind-subtitles title=dom-TextTrack-kind-subtitles><code>subtitles</code></dfn>
+ <li><dfn id=dom-texttrack-kind-captions title=dom-TextTrack-kind-captions><code>captions</code></dfn>
+ <li><dfn id=dom-texttrack-kind-descriptions title=dom-TextTrack-kind-descriptions><code>descriptions</code></dfn>
+ <li><dfn id=dom-texttrack-kind-chapters title=dom-TextTrack-kind-chapters><code>chapters</code></dfn>
+ <li><dfn id=dom-texttrack-kind-metadata title=dom-TextTrack-kind-metadata><code>metadata</code></dfn>
+ </ul><p>The <a href=#text-track-kind title="text track kind">kind of track</a> can
+ change dynamically, in the case of a <a href=#text-track>text track</a>
corresponding to a <code><a href=#the-track-element>track</a></code> element.</p>
</dd>
- <dt><dfn id=timed-track-label title="timed track label">A label</dfn>
+ <dt><dfn id=text-track-label title="text track label">A label</dfn>
<dd>
@@ -27497,106 +27495,106 @@
for the user. In certain cases, the label might be generated
automatically.</p>
- <p>The <a href=#timed-track-label title="timed track label">label of a track</a> can
- change dynamically, in the case of a <a href=#timed-track>timed track</a>
+ <p>The <a href=#text-track-label title="text track label">label of a track</a> can
+ change dynamically, in the case of a <a href=#text-track>text track</a>
corresponding to a <code><a href=#the-track-element>track</a></code> element or in the case of an
automatically-generated label whose value depends on variable
factors such as the user's preferred user interface language.</p>
</dd>
- <dt><dfn id=timed-track-language title="timed track language">A language</dfn>
+ <dt><dfn id=text-track-language title="text track language">A language</dfn>
<dd>
<p>This is a string (a BCP 47 language tag) representing the
- language of the timed track's cues. <a href=#refsBCP47>[BCP47]</a></p>
+ language of the text track's cues. <a href=#refsBCP47>[BCP47]</a></p>
- <p>The <a href=#timed-track-language title="timed track language">language of a timed
- track</a> can change dynamically, in the case of a <a href=#timed-track>timed
+ <p>The <a href=#text-track-language title="text track language">language of a text
+ track</a> can change dynamically, in the case of a <a href=#text-track>text
track</a> corresponding to a <code><a href=#the-track-element>track</a></code> element.</p>
</dd>
- <dt><dfn id=timed-track-readiness-state title="timed track readiness state">A readiness state</dfn>
+ <dt><dfn id=text-track-readiness-state title="text track readiness state">A readiness state</dfn>
<dd>
<p>One of the following:</p>
- <dl><dt><dfn id=timed-track-not-loaded title="timed track not loaded">Not loaded</dfn>
+ <dl><dt><dfn id=text-track-not-loaded title="text track not loaded">Not loaded</dfn>
<dd>
- <p>Indicates that the timed track is known to exist (e.g. it has
+ <p>Indicates that the text track is known to exist (e.g. it has
been declared with a <code><a href=#the-track-element>track</a></code> element), but its cues
have not been obtained.</p>
</dd>
- <dt><dfn id=timed-track-loading title="timed track loading">Loading</dfn>
+ <dt><dfn id=text-track-loading title="text track loading">Loading</dfn>
<dd>
- <p>Indicates that the timed track is loading and there have been
+ <p>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.</p>
</dd>
- <dt><dfn id=timed-track-loaded title="timed track loaded">Loaded</dfn>
+ <dt><dfn id=text-track-loaded title="text track loaded">Loaded</dfn>
<dd>
- <p>Indicates that the timed track has been loaded with no fatal
+ <p>Indicates that the text track has been loaded with no fatal
errors. No new cues will be added to the track except if the
- <a href=#timed-track>timed track</a> corresponds to a
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object.</p>
+ <a href=#text-track>text track</a> corresponds to a
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object.</p>
</dd>
- <dt><dfn id=timed-track-failed-to-load title="timed track failed to load">Failed to load</dfn>
+ <dt><dfn id=text-track-failed-to-load title="text track failed to load">Failed to load</dfn>
<dd>
- <p>Indicates that the timed track was enabled, but when the user
+ <p>Indicates that the text track was enabled, but when the user
agent attempted to obtain it, this failed in some way
(e.g. <a href=#url>URL</a> could not be <a href=#resolve-a-url title="resolve a
- url">resolved</a>, network error, unknown timed track
+ url">resolved</a>, network error, unknown text track
format). Some or all of the cues are likely missing and will not
be obtained.</p>
</dd>
- </dl><p>The <a href=#timed-track-readiness-state title="timed track readiness state">readiness
- state</a> of a <a href=#timed-track>timed track</a> changes dynamically as
+ </dl><p>The <a href=#text-track-readiness-state title="text track readiness state">readiness
+ state</a> of a <a href=#text-track>text track</a> changes dynamically as
the track is obtained.</p>
</dd>
- <dt><dfn id=timed-track-mode title="timed track mode">A mode</dfn>
+ <dt><dfn id=text-track-mode title="text track mode">A mode</dfn>
<dd>
<p>One of the following:</p>
- <dl><dt><dfn id=timed-track-disabled title="timed track disabled">Disabled</dfn>
+ <dl><dt><dfn id=text-track-disabled title="text track disabled">Disabled</dfn>
<dd>
- <p>Indicates that the timed track is not active. Other than for
+ <p>Indicates that the text track is not active. Other than for
the purposes of exposing the track in the DOM, the user agent is
- ignoring the timed track. No cues are active, no events are
+ ignoring the text track. No cues are active, no events are
fired, and the user agent will not attempt to obtain the track's
cues.</p>
</dd>
- <dt><dfn id=timed-track-hidden title="timed track hidden">Hidden</dfn>
+ <dt><dfn id=text-track-hidden title="text track hidden">Hidden</dfn>
<dd>
- <p>Indicates that the timed track is active, but that the user
+ <p>Indicates that the text track is active, but that the user
agent is not actively displaying the cues. If no attempt has yet
been made to obtain the track's cues, the user agent will
perform such an attempt momentarily. The user agent is
@@ -27605,28 +27603,28 @@
</dd>
- <dt><dfn id=timed-track-showing title="timed track showing">Showing</dfn>
- <dt><dfn id=timed-track-showing-by-default title="timed track showing by default">Showing by default</dfn>
+ <dt><dfn id=text-track-showing title="text track showing">Showing</dfn>
+ <dt><dfn id=text-track-showing-by-default title="text track showing by default">Showing by default</dfn>
</dt><dd>
- <p>Indicates that the timed track is active. If no attempt has
+ <p>Indicates that the text track is active. If no attempt has
yet been made to obtain the track's cues, the user agent will
perform such an attempt momentarily. The user agent is
maintaining a list of which cues are active, and events are
- being fired accordingly. In addition, for timed tracks whose
- <a href=#timed-track-kind title="timed track kind">kind</a> is <code title=dom-mediatrack-kind-subtitles>subtitles</code> or <code title=dom-mediatrack-kind-captions>captions</code>, the cues
- are being displayed over the video as appropriate; for timed
- tracks whose <a href=#timed-track-kind title="timed track kind">kind</a> is <code title=dom-mediatrack-kind-descriptions>descriptions</code>,
+ being fired accordingly. In addition, for text tracks whose
+ <a href=#text-track-kind title="text track kind">kind</a> is <code title=dom-mediatrack-kind-subtitles>subtitles</code> or <code title=dom-mediatrack-kind-captions>captions</code>, the cues
+ are being displayed over the video as appropriate; for text
+ tracks whose <a href=#text-track-kind title="text track kind">kind</a> is <code title=dom-mediatrack-kind-descriptions>descriptions</code>,
the user agent is making the cues available to the user in a
- non-visual fashion; and for timed tracks whose <a href=#timed-track-kind title="timed track kind">kind</a> is <code title=dom-mediatrack-kind-chapters>chapters</code>, the user
+ non-visual fashion; and for text tracks whose <a href=#text-track-kind title="text track kind">kind</a> is <code title=dom-mediatrack-kind-chapters>chapters</code>, the user
agent is making available to the user a mechanism by which the
user can navigate to any point in the <a href=#media-resource>media
resource</a> by selecting a cue.</p>
- <p>The <a href=#timed-track-showing-by-default title="timed track showing by default">showing by
+ <p>The <a href=#text-track-showing-by-default title="text track showing by default">showing by
default</a> state is used in conjunction with the <code title=attr-track-default><a href=#attr-track-default>default</a></code> attribute on
- <code><a href=#the-track-element>track</a></code> elements to indicate that the timed track was
+ <code><a href=#the-track-element>track</a></code> elements to indicate that the text track was
enabled due to that attribute. This allows the user agent to
override the state if a later track is discovered that is more
appropriate per the user's preferences.</p>
@@ -27635,177 +27633,177 @@
</dl></dd>
- <dt><dfn id=timed-track-list-of-cues title="timed track list of cues">A list of zero or more cues</dfn>
+ <dt><dfn id=text-track-list-of-cues title="text track list of cues">A list of zero or more cues</dfn>
<dd>
- <p>A list of <a href=#timed-track-cue title="timed track cue">timed track
- cues</a>, along with <dfn id=rules-for-updating-the-timed-track-rendering>rules for updating the timed track
+ <p>A list of <a href=#text-track-cue title="text track cue">text track
+ cues</a>, along with <dfn id=rules-for-updating-the-text-track-rendering>rules for updating the text track
rendering</dfn>.
<!--TTVTT-->
- For example, for <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating
- the display of WebVTT timed tracks</a>.
+ For example, for <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating
+ the display of WebVTT text tracks</a>.
<!--TTVTT-->
</p>
- <p>The <a href=#timed-track-list-of-cues title="timed track list of cues">list of cues of a
- timed track</a> can change dynamically, either because the
- <a href=#timed-track>timed track</a> has <a href=#timed-track-not-loaded title="timed track not
- loaded">not yet been loaded</a> or is still <a href=#timed-track-loading title="timed
- track loading">loading</a>, or because the <a href=#timed-track>timed
- track</a> corresponds to a <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code>
+ <p>The <a href=#text-track-list-of-cues title="text track list of cues">list of cues of a
+ text track</a> can change dynamically, either because the
+ <a href=#text-track>text track</a> has <a href=#text-track-not-loaded title="text track not
+ loaded">not yet been loaded</a> or is still <a href=#text-track-loading title="text
+ track loading">loading</a>, or because the <a href=#text-track>text
+ track</a> corresponds to a <code><a href=#mutabletexttrack>MutableTextTrack</a></code>
object, whose API allows individual cues can be added or removed
dynamically.</p>
</dd>
- </dl><p>Each <a href=#timed-track>timed track</a> has a corresponding
- <code><a href=#timedtrack>TimedTrack</a></code> object.</p>
+ </dl><p>Each <a href=#text-track>text track</a> has a corresponding
+ <code><a href=#texttrack>TextTrack</a></code> object.</p>
- <p>The <a href=#timed-track title="timed track">timed tracks</a> of a
- <a href=#media-element>media element</a> are <dfn id=the-timed-tracks-are-ready title="the timed tracks are
- ready">ready</dfn> if all the <a href=#timed-track title="timed track">timed
- tracks</a> whose <a href=#timed-track-mode title="timed track mode">mode</a> was
- not in the <a href=#timed-track-disabled title="timed track disabled">disabled</a> state
+ <p>The <a href=#text-track title="text track">text tracks</a> of a
+ <a href=#media-element>media element</a> are <dfn id=the-text-tracks-are-ready title="the text tracks are
+ ready">ready</dfn> if all the <a href=#text-track title="text track">text
+ tracks</a> whose <a href=#text-track-mode title="text track mode">mode</a> was
+ not in the <a href=#text-track-disabled title="text track disabled">disabled</a> state
when the element's <a href=#concept-media-load-algorithm title=concept-media-load-algorithm>resource selection
- algorithm</a> last started now have a <a href=#timed-track-readiness-state>timed track readiness
- state</a> of <a href=#timed-track-loaded title="timed track loaded">loaded</a> or
- <a href=#timed-track-failed-to-load title="timed track failed to load">failed to load</a>.</p>
+ algorithm</a> last started now have a <a href=#text-track-readiness-state>text track readiness
+ state</a> of <a href=#text-track-loaded title="text track loaded">loaded</a> or
+ <a href=#text-track-failed-to-load title="text track failed to load">failed to load</a>.</p>
- <hr><p>A <dfn id=timed-track-cue>timed track cue</dfn> is the unit of time-sensitive data
- in a <a href=#timed-track>timed track</a>, corresponding for instance for
+ <hr><p>A <dfn id=text-track-cue>text track cue</dfn> is the unit of time-sensitive data
+ in a <a href=#text-track>text track</a>, corresponding for instance for
subtitles and captions to the text that appears at a particular time
and disappears at another time.</p>
- <p>Each <a href=#timed-track-cue>timed track cue</a> consists of:</p>
+ <p>Each <a href=#text-track-cue>text track cue</a> consists of:</p>
- <dl><dt><dfn id=timed-track-cue-identifier title="timed track cue identifier">An identifier</dfn>
+ <dl><dt><dfn id=text-track-cue-identifier title="text track cue identifier">An identifier</dfn>
<dd>
<p>An arbitrary string.</p>
</dd>
- <dt><dfn id=timed-track-cue-start-time title="timed track cue start time">A start time</dfn>
+ <dt><dfn id=text-track-cue-start-time title="text track cue start time">A start time</dfn>
<dd>
<p>A time, in seconds and fractions of a second, at which the cue
becomes relevant.</p>
</dd>
- <dt><dfn id=timed-track-cue-end-time title="timed track cue end time">An end time</dfn>
+ <dt><dfn id=text-track-cue-end-time title="text track cue end time">An end time</dfn>
<dd>
<p>A time, in seconds and fractions of a second, at which the cue
stops being relevant.</p>
</dd>
- <dt><dfn id=timed-track-cue-pause-on-exit-flag title="timed track cue pause-on-exit flag">A pause-on-exit flag</dfn>
+ <dt><dfn id=text-track-cue-pause-on-exit-flag title="text track cue pause-on-exit flag">A pause-on-exit flag</dfn>
<dd>
<p>A boolean indicating whether playback of the <a href=#media-resource>media
resource</a> is to pause when the cue stops being relevant.</p>
</dd>
- <dt><dfn id=timed-track-cue-writing-direction title="timed track cue writing direction">A writing direction</dfn>
+ <dt><dfn id=text-track-cue-writing-direction title="text track cue writing direction">A writing direction</dfn>
<dd>
- <p>A writing direction, either <dfn id=timed-track-cue-horizontal-writing-direction title="timed track cue
+ <p>A writing direction, either <dfn id=text-track-cue-horizontal-writing-direction title="text track cue
horizontal writing direction">horizontal</dfn> (a line extends
horizontally and is positioned vertically, with consecutive lines
- displayed below each other), <dfn id=timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical
+ displayed below each other), <dfn id=text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical
growing left writing direction">vertical growing left</dfn> (a
line extends vertically and is positioned horizontally, with
consecutive lines displayed to the left of each other<!-- used
- for east asian-->), or <dfn id=timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical
+ for east asian-->), or <dfn id=text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical
growing right writing direction">vertical growing right</dfn> (a
line extends vertically and is positioned horizontally, with
consecutive lines displayed to the right of each other<!-- used for
mongolian -->).</p>
<!--TTVTT-->
- <p>If the <a href=#timed-track-cue-writing-direction title="timed track cue writing direction">writing
- direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal
- writing direction">horizontal</a>, then <a href=#timed-track-cue-line-position title="timed
+ <p>If the <a href=#text-track-cue-writing-direction title="text track cue writing direction">writing
+ direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal
+ writing direction">horizontal</a>, then <a href=#text-track-cue-line-position title="text
track cue line position">line position</a> percentages are
- relative to the height of the video, and <a href=#timed-track-cue-text-position title="timed track
- cue text position">text position</a> and <a href=#timed-track-cue-size title="timed
+ relative to the height of the video, and <a href=#text-track-cue-text-position title="text track
+ cue text position">text position</a> and <a href=#text-track-cue-size title="text
track cue size">size</a> percentages are relative to the width
of the video.</p>
- <p>Otherwise, <a href=#timed-track-cue-line-position title="timed track cue line position">line
+ <p>Otherwise, <a href=#text-track-cue-line-position title="text track cue line position">line
position</a> percentages are relative to the width of the
- video, and <a href=#timed-track-cue-text-position title="timed track cue text position">text
- position</a> and <a href=#timed-track-cue-size title="timed track cue size">size</a>
+ video, and <a href=#text-track-cue-text-position title="text track cue text position">text
+ position</a> and <a href=#text-track-cue-size title="text track cue size">size</a>
percentages are relative to the height of the video.</p>
<!--TTVTT-->
</dd>
<!--TTVTT-->
- <dt><dfn id=timed-track-cue-snap-to-lines-flag title="timed track cue snap-to-lines flag">A snap-to-lines flag</dfn>
+ <dt><dfn id=text-track-cue-snap-to-lines-flag title="text track cue snap-to-lines flag">A snap-to-lines flag</dfn>
<dd>
- <p>A boolean indicating whether the <a href=#timed-track-cue-line-position title="timed track cue
+ <p>A boolean indicating whether the <a href=#text-track-cue-line-position title="text track cue
line position">line's position</a> is a line position
(positioned to a multiple of the line dimensions of the first line
of the cue), or whether it is a percentage of the dimension of the
video.</p>
</dd>
- <dt><dfn id=timed-track-cue-line-position title="timed track cue line position">A line position</dfn>
+ <dt><dfn id=text-track-cue-line-position title="text track cue line position">A line position</dfn>
<dd>
<p>Either a number giving the position of the lines of the cue, to
- be interpreted as defined by the <a href=#timed-track-cue-writing-direction title="timed track cue
- writing direction">writing direction</a> and <a href=#timed-track-cue-snap-to-lines-flag title="timed
+ be interpreted as defined by the <a href=#text-track-cue-writing-direction title="text track cue
+ writing direction">writing direction</a> and <a href=#text-track-cue-snap-to-lines-flag title="text
track cue snap-to-lines flag">snap-to-lines flag</a> of the
- cue, or the special value <dfn id=timed-track-cue-automatic-line-position title="timed track cue automatic line
+ cue, or the special value <dfn id=text-track-cue-automatic-line-position title="text track cue automatic line
position">auto</dfn>, which means the position is to depend on
the other active tracks.</p>
</dd>
- <dt><dfn id=timed-track-cue-text-position title="timed track cue text position">A text position</dfn>
+ <dt><dfn id=text-track-cue-text-position title="text track cue text position">A text position</dfn>
<dd>
<p>A number giving the position of the text of the cue within each
line, to be interpreted as a percentage of the video, as defined
- by the <a href=#timed-track-cue-writing-direction title="timed track cue writing direction">writing
+ by the <a href=#text-track-cue-writing-direction title="text track cue writing direction">writing
direction</a>.</p>
</dd>
<!--TTVTT-->
- <dt><dfn id=timed-track-cue-size title="timed track cue size">A size</dfn>
+ <dt><dfn id=text-track-cue-size title="text track cue size">A size</dfn>
<dd>
<p>A number giving the size of the box within which the text of
each line of the cue is to be aligned, to be interpreted as a
- percentage of the video, as defined by the <a href=#timed-track-cue-writing-direction title="timed
+ percentage of the video, as defined by the <a href=#text-track-cue-writing-direction title="text
track cue writing direction">writing direction</a>.</p>
</dd>
<!--TTVTT-->
- <dt><dfn id=timed-track-cue-alignment title="timed track cue alignment">An alignment</dfn>
+ <dt><dfn id=text-track-cue-alignment title="text track cue alignment">An alignment</dfn>
<dd>
- <p>An alignment for the text of each line of the cue, either <dfn id=timed-track-cue-start-alignment title="timed track cue start alignment">start alignment</dfn> (the
- text is aligned towards its start side), <dfn id=timed-track-cue-middle-alignment title="timed track
+ <p>An alignment for the text of each line of the cue, either <dfn id=text-track-cue-start-alignment title="text track cue start alignment">start alignment</dfn> (the
+ text is aligned towards its start side), <dfn id=text-track-cue-middle-alignment title="text track
cue middle alignment">middle alignment</dfn> (the text is aligned
- centered between its start and end sides), <dfn id=timed-track-cue-end-alignment title="timed track
+ centered between its start and end sides), <dfn id=text-track-cue-end-alignment title="text track
cue end alignment">end alignment</dfn> (the text is aligned
towards its end side). Which sides are the start and end sides
- depends on the Unicode bidirectional algorithm and the <a href=#timed-track-cue-writing-direction title="timed track cue writing direction">writing
+ depends on the Unicode bidirectional algorithm and the <a href=#text-track-cue-writing-direction title="text track cue writing direction">writing
direction</a>. <a href=#refsBIDI>[BIDI]</a></p>
</dd>
<!--TTVTT-->
- <dt><dfn id=timed-track-cue-text title="timed track cue text">The text of the cue</dfn>
+ <dt><dfn id=text-track-cue-text title="text track cue text">The text of the cue</dfn>
<dd>
<p>The raw text of the cue, and rules for its interpretation,
allowing the text to be rendered and converted to a DOM fragment.</p>
</dd>
- </dl><p>A <a href=#timed-track-cue>timed track cue</a> is immutable.</p>
+ </dl><p>A <a href=#text-track-cue>text track cue</a> is immutable.</p>
- <p>Each <a href=#timed-track-cue>timed track cue</a> has a corresponding
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> object, and can be associated with a
- particular <a href=#timed-track>timed track</a>. Once a <a href=#timed-track-cue>timed track
- cue</a> is associated with a particular <a href=#timed-track>timed track</a>,
+ <p>Each <a href=#text-track-cue>text track cue</a> has a corresponding
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object, and can be associated with a
+ particular <a href=#text-track>text track</a>. Once a <a href=#text-track-cue>text track
+ cue</a> is associated with a particular <a href=#text-track>text track</a>,
the association is permanent.</p>
- <p>In addition, each <a href=#timed-track-cue>timed track cue</a> has two pieces of
+ <p>In addition, each <a href=#text-track-cue>text track cue</a> has two pieces of
dynamic information:</p>
- <dl><dt>The <dfn id=timed-track-cue-active-flag title="timed track cue active flag">active flag</dfn>
+ <dl><dt>The <dfn id=text-track-cue-active-flag title="text track cue active flag">active flag</dfn>
<dd>
<p>This flag must be initially unset. The flag is used to ensure
@@ -27813,60 +27811,60 @@
inactive, and to make sure the right cues are rendered.</p>
<p>The user agent must synchronously unset this flag whenever the
- <a href=#timed-track-cue>timed track cue</a> is removed from its <a href=#timed-track>timed
- track</a>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>; whenever the
- <a href=#timed-track>timed track</a> itself is removed from its <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a> or has its
- <a href=#timed-track-mode>timed track mode</a> changed to <a href=#timed-track-disabled title="timed track
+ <a href=#text-track-cue>text track cue</a> is removed from its <a href=#text-track>text
+ track</a>'s <a href=#text-track-list-of-cues>text track list of cues</a>; whenever the
+ <a href=#text-track>text track</a> itself is removed from its <a href=#media-element>media
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a> or has its
+ <a href=#text-track-mode>text track mode</a> changed to <a href=#text-track-disabled title="text track
disabled">disabled</a>; and whenever the <a href=#media-element>media
element</a>'s <code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> is changed back to
<code title=dom-media-HAVE_NOTHING><a href=#dom-media-have_nothing>HAVE_NOTHING</a></code>. When the
- flag is unset in this way for one or more cues in <a href=#timed-track title="timed track">timed tracks</a> that were <a href=#timed-track-showing title="timed track showing">showing</a> or <a href=#timed-track-showing-by-default title="timed
+ flag is unset in this way for one or more cues in <a href=#text-track title="text track">text tracks</a> that were <a href=#text-track-showing title="text track showing">showing</a> or <a href=#text-track-showing-by-default title="text
track showing by default">showing by default</a> prior to the
relevant incident, the user agent must, after having unset the
- flag for all the affected cues, apply the <a href=#rules-for-updating-the-timed-track-rendering>rules for updating
- the timed track rendering</a> of those <a href=#timed-track title="timed
- track">timed tracks</a>.
+ flag for all the affected cues, apply the <a href=#rules-for-updating-the-text-track-rendering>rules for updating
+ the text track rendering</a> of those <a href=#text-track title="text
+ track">text tracks</a>.
<!--TTVTT-->
- For example, for <a href=#timed-track title="timed track">timed tracks</a>
- based on <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the
- display of WebVTT timed tracks</a>.</p>
+ For example, for <a href=#text-track title="text track">text tracks</a>
+ based on <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the
+ display of WebVTT text tracks</a>.</p>
<!--TTVTT-->
</dd>
- <dt>The <dfn id=timed-track-cue-display-state title="timed track cue display state">display state</dfn>
+ <dt>The <dfn id=text-track-cue-display-state title="text track cue display state">display state</dfn>
<dd>
<p>This is used as part of the rendering model, to keep cues in a
consistent position. It must initially be empty. Whenever the
- <a href=#timed-track-cue-active-flag>timed track cue active flag</a> is unset, the user agent
- must empty the <a href=#timed-track-cue-display-state>timed track cue display state</a>.</p>
+ <a href=#text-track-cue-active-flag>text track cue active flag</a> is unset, the user agent
+ must empty the <a href=#text-track-cue-display-state>text track cue display state</a>.</p>
</dd>
- </dl><p>The <a href=#timed-track-cue title="timed track cue">timed track cues</a> of a
- <a href=#media-element>media element</a>'s <a href=#timed-track title="timed track">timed
- tracks</a> are ordered relative to each other in the <dfn id=timed-track-cue-order>timed
+ </dl><p>The <a href=#text-track-cue title="text track cue">text track cues</a> of a
+ <a href=#media-element>media element</a>'s <a href=#text-track title="text track">text
+ tracks</a> are ordered relative to each other in the <dfn id=text-track-cue-order>text
track cue order</dfn>, which is determined as follows: first group
- the <a href=#timed-track-cue title="timed track cue">cues</a> by their <a href=#timed-track>timed
+ the <a href=#text-track-cue title="text track cue">cues</a> by their <a href=#text-track>text
track</a>, with the groups being sorted in the same order as
- their <a href=#timed-track title="timed track">timed tracks</a> appear in the
- <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>;
- then, within each group, <a href=#timed-track-cue title="timed track cue">cues</a>
- must be sorted by their <a href=#timed-track-cue-start-time title="timed track cue start
- time">start time</a>, earliest first; then, any <a href=#timed-track-cue title="timed track cue">cues</a> with the same <a href=#timed-track-cue-start-time title="timed
+ their <a href=#text-track title="text track">text tracks</a> appear in the
+ <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>;
+ then, within each group, <a href=#text-track-cue title="text track cue">cues</a>
+ must be sorted by their <a href=#text-track-cue-start-time title="text track cue start
+ time">start time</a>, earliest first; then, any <a href=#text-track-cue title="text track cue">cues</a> with the same <a href=#text-track-cue-start-time title="text
track cue start time">start time</a> must be sorted by their
- <a href=#timed-track-cue-end-time title="timed track cue end time">end time</a>, earliest
- first; and finally, any <a href=#timed-track-cue title="timed track cue">cues</a>
- with identical <a href=#timed-track-cue-end-time title="timed track cue end time">end
+ <a href=#text-track-cue-end-time title="text track cue end time">end time</a>, earliest
+ first; and finally, any <a href=#text-track-cue title="text track cue">cues</a>
+ with identical <a href=#text-track-cue-end-time title="text track cue end time">end
times</a> must be sorted in the order they were created (so
e.g. for cues from a <a href=#webvtt>WebVTT</a> file, that would be the
order in which the cues were listed in the file).</p>
- <h6 id=sourcing-in-band-timed-tracks><span class=secno>4.8.10.10.2 </span>Sourcing in-band timed tracks</h6>
+ <h6 id=sourcing-in-band-text-tracks><span class=secno>4.8.10.10.2 </span>Sourcing in-band text tracks</h6>
- <p>A <dfn id=media-resource-specific-timed-track>media-resource-specific timed track</dfn> is a <a href=#timed-track>timed
+ <p>A <dfn id=media-resource-specific-text-track>media-resource-specific text track</dfn> is a <a href=#text-track>text
track</a> that corresponds to data found in the <a href=#media-resource>media
resource</a>.</p>
@@ -27878,62 +27876,62 @@
if the <a href=#media-resource>media resource</a> is a video.</p>
<p>When a <a href=#media-resource>media resource</a> contains data that the user
- agent recognises and supports as being equivalent to a <a href=#timed-track>timed
+ agent recognises and supports as being equivalent to a <a href=#text-track>text
track</a>, the user agent <a href=#found-a-media-resource-specific-timed-track>runs</a> the
- <dfn id=steps-to-expose-a-media-resource-specific-timed-track>steps to expose a media-resource-specific timed track</dfn>
+ <dfn id=steps-to-expose-a-media-resource-specific-text-track>steps to expose a media-resource-specific text track</dfn>
with the relevant data, as follows:</p>
- <ol><li><p>Associate the relevant data with a new <a href=#timed-track>timed
- track</a> and its corresponding new <code><a href=#timedtrack>TimedTrack</a></code>
- object. The <a href=#timed-track>timed track</a> is a
- <a href=#media-resource-specific-timed-track>media-resource-specific timed track</a>.</li>
+ <ol><li><p>Associate the relevant data with a new <a href=#text-track>text
+ track</a> and its corresponding new <code><a href=#texttrack>TextTrack</a></code>
+ object. The <a href=#text-track>text track</a> is a
+ <a href=#media-resource-specific-text-track>media-resource-specific text track</a>.</li>
- <li><p>Set the new <a href=#timed-track>timed track</a>'s <a href=#timed-track-kind title="timed track
- kind">kind</a>, <a href=#timed-track-label title="timed track label">label</a>,
- and <a href=#timed-track-language title="timed track language">language</a> based on the
+ <li><p>Set the new <a href=#text-track>text track</a>'s <a href=#text-track-kind title="text track
+ kind">kind</a>, <a href=#text-track-label title="text track label">label</a>,
+ and <a href=#text-track-language title="text track language">language</a> based on the
semantics of the relevant data, as defined by the relevant
specification.</li>
- <li><p>Populate the new <a href=#timed-track>timed track</a>'s <a href=#timed-track-list-of-cues title="timed track list of cues">list of cues</a> with the cues
- parsed so far, folllowing the <a href=#guidelines-for-exposing-cues-in-various-formats-as-timed-track-cues>guidelines for exposing
+ <li><p>Populate the new <a href=#text-track>text track</a>'s <a href=#text-track-list-of-cues title="text track list of cues">list of cues</a> with the cues
+ parsed so far, folllowing the <a href=#guidelines-for-exposing-cues-in-various-formats-as-text-track-cues>guidelines for exposing
cues</a>, and begin updating it dynamically as
necessary.</li>
<li>
- <p>Set the new <a href=#timed-track>timed track</a>'s <a href=#timed-track-readiness-state title="timed track
+ <p>Set the new <a href=#text-track>text track</a>'s <a href=#text-track-readiness-state title="text track
readiness state">readiness state</a> to the value that most
correctly describes the current state, and begin updating it
dynamically as necessary.</p>
<p class=example>For example, if the relevant data in the
<a href=#media-resource>media resource</a> has been fully parsed and completely
- describes the cues, then the <a href=#timed-track>timed track</a> would be
- <a href=#timed-track-loaded title="timed track loaded">loaded</a>. On the other hand,
+ describes the cues, then the <a href=#text-track>text track</a> would be
+ <a href=#text-track-loaded title="text track loaded">loaded</a>. On the other hand,
if the data for the cues is interleaved with the <a href=#media-data>media
data</a>, and the <a href=#media-resource>media resource</a> as a whole is
- still being downloaded, then the <a href=#timed-track-loading title="timed track
+ still being downloaded, then the <a href=#text-track-loading title="text track
loading">loading</a> state might be more accurate.</p>
</li>
- <li><p>Set the new <a href=#timed-track>timed track</a>'s <a href=#timed-track-mode title="timed
+ <li><p>Set the new <a href=#text-track>text track</a>'s <a href=#text-track-mode title="text
track mode">mode</a> to the mode consistent with the user's
preferences and the requirements of the relevant specification for
the data.</li>
- <li><p>Leave the <a href=#timed-track-list-of-cues>timed track list of cues</a> empty, and
- associate with it the <a href=#rules-for-updating-the-timed-track-rendering>rules for updating the timed track
+ <li><p>Leave the <a href=#text-track-list-of-cues>text track list of cues</a> empty, and
+ associate with it the <a href=#rules-for-updating-the-text-track-rendering>rules for updating the text track
rendering</a> appropriate for the format in question.</p>
- <li><p>Add the new <a href=#timed-track>timed track</a> to the <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>.</li>
+ <li><p>Add the new <a href=#text-track>text track</a> to the <a href=#media-element>media
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>.</li>
- </ol><p>When a <a href=#media-element>media element</a> is to <dfn id="forget-the-media-element's-media-resource-specific-timed-tracks">forget the media
- element's media-resource-specific timed tracks</dfn>, the user
- agent must remove from the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list
- of timed tracks</a> all the <a href=#media-resource-specific-timed-track title="media-resource-specific
- timed track">media-resource-specific timed tracks</a>.</p>
+ </ol><p>When a <a href=#media-element>media element</a> is to <dfn id="forget-the-media-element's-media-resource-specific-text-tracks">forget the media
+ element's media-resource-specific text tracks</dfn>, the user
+ agent must remove from the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list
+ of text tracks</a> all the <a href=#media-resource-specific-text-track title="media-resource-specific
+ text track">media-resource-specific text tracks</a>.</p>
</div>
@@ -27941,108 +27939,108 @@
<div class=impl>
- <h6 id=sourcing-out-of-band-timed-tracks><span class=secno>4.8.10.10.3 </span>Sourcing out-of-band timed tracks</h6>
+ <h6 id=sourcing-out-of-band-text-tracks><span class=secno>4.8.10.10.3 </span>Sourcing out-of-band text tracks</h6>
<p>When a <code><a href=#the-track-element>track</a></code> element is created, it must be
- associated with a new <a href=#timed-track>timed track</a> (with its value set
- as defined below) and its corresponding new <code><a href=#timedtrack>TimedTrack</a></code>
+ associated with a new <a href=#text-track>text track</a> (with its value set
+ as defined below) and its corresponding new <code><a href=#texttrack>TextTrack</a></code>
object.</p>
- <p>The <a href=#timed-track-kind>timed track kind</a> is determined from the state of
+ <p>The <a href=#text-track-kind>text track kind</a> is determined from the state of
the element's <code title=attr-track-kind><a href=#attr-track-kind>kind</a></code> attribute
according to the following table; for a state given in a cell of the
- first column, the <a href=#timed-track-kind title="timed track kind">kind</a> is the
+ first column, the <a href=#text-track-kind title="text track kind">kind</a> is the
string given in the second column:</p>
<table><thead><tr><th>State
<th>String
<tbody><tr><td><a href=#attr-track-kind-subtitles title=attr-track-kind-subtitles>Subtitles</a>
- <td><code title=dom-timedtrack-kind-subtitles><a href=#dom-timedtrack-kind-subtitles>subtitles</a></code>
+ <td><code title=dom-timedtrack-kind-subtitles>subtitles</code>
<tr><td><a href=#attr-track-kind-captions title=attr-track-kind-captions>Captions</a>
- <td><code title=dom-timedtrack-kind-captions><a href=#dom-timedtrack-kind-captions>captions</a></code>
+ <td><code title=dom-timedtrack-kind-captions>captions</code>
<tr><td><a href=#attr-track-kind-descriptions title=attr-track-kind-descriptions>Descriptions</a>
- <td><code title=dom-timedtrack-kind-descriptions><a href=#dom-timedtrack-kind-descriptions>descriptions</a></code>
+ <td><code title=dom-timedtrack-kind-descriptions>descriptions</code>
<tr><td><a href=#attr-track-kind-chapters title=attr-track-kind-chapters>Chapters</a>
- <td><code title=dom-timedtrack-kind-chapters><a href=#dom-timedtrack-kind-chapters>chapters</a></code>
+ <td><code title=dom-timedtrack-kind-chapters>chapters</code>
<tr><td><a href=#attr-track-kind-metadata title=attr-track-kind-metadata>Metadata</a>
- <td><code title=dom-timedtrack-kind-metadata><a href=#dom-timedtrack-kind-metadata>metadata</a></code>
- </table><p>The <a href=#timed-track-label>timed track label</a> is the element's <a href=#track-label>track
+ <td><code title=dom-timedtrack-kind-metadata>metadata</code>
+ </table><p>The <a href=#text-track-label>text track label</a> is the element's <a href=#track-label>track
label</a>.</p>
- <p>The <a href=#timed-track-language>timed track language</a> is the element's
+ <p>The <a href=#text-track-language>text track language</a> is the element's
<a href=#track-language>track language</a>, if any, or the empty string
otherwise.</p>
<p>As the <code title=attr-track-kind><a href=#attr-track-kind>kind</a></code>, <code title=attr-track-label><a href=#attr-track-label>label</a></code>, and <code title=attr-track-srclang><a href=#attr-track-srclang>srclang</a></code> attributes are added,
- removed, or changed, the <a href=#timed-track>timed track</a> must update
+ removed, or changed, the <a href=#text-track>text track</a> must update
accordingly, as per the definitions above.</p>
<p class=note>Changes to the <a href=#track-url>track URL</a> are handled in
the algorithm below.</p>
- <p>The <a href=#timed-track-list-of-cues>timed track list of cues</a> is initially empty. It
+ <p>The <a href=#text-track-list-of-cues>text track list of cues</a> is initially empty. It
is dynamically modified when the referenced file is parsed.
- Associated with the list are the <a href=#rules-for-updating-the-timed-track-rendering>rules for updating the timed
+ Associated with the list are the <a href=#rules-for-updating-the-text-track-rendering>rules for updating the text
track rendering</a> appropriate for the format in question; for
- <a href=#webvtt>WebVTT</a>, this is the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the
- display of WebVTT timed tracks</a>.</p>
+ <a href=#webvtt>WebVTT</a>, this is the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the
+ display of WebVTT text tracks</a>.</p>
<p>When a <code><a href=#the-track-element>track</a></code> element's parent element changes and
the new parent is a <a href=#media-element>media element</a>, then the user agent
- must add the <code><a href=#the-track-element>track</a></code> element's corresponding <a href=#timed-track>timed
- track</a> to the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed
+ must add the <code><a href=#the-track-element>track</a></code> element's corresponding <a href=#text-track>text
+ track</a> to the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text
tracks</a>.</p>
<p>When a <code><a href=#the-track-element>track</a></code> element's parent element changes and
the old parent was a <a href=#media-element>media element</a>, then the user agent
must remove the <code><a href=#the-track-element>track</a></code> element's corresponding
- <a href=#timed-track>timed track</a> from the <a href=#media-element>media element</a>'s
- <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ <a href=#text-track>text track</a> from the <a href=#media-element>media element</a>'s
+ <a href=#list-of-text-tracks>list of text tracks</a>.</p>
- <p>When a <a href=#timed-track>timed track</a> corresponding to a
+ <p>When a <a href=#text-track>text track</a> corresponding to a
<code><a href=#the-track-element>track</a></code> element is added to a <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>, the user agent
- must set the <a href=#timed-track-mode>timed track mode</a> appropriately, as
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>, the user agent
+ must set the <a href=#text-track-mode>text track mode</a> appropriately, as
determined by the following conditions:</p>
- <dl class=switch><dt>If the <a href=#timed-track-kind>timed track kind</a> is <code title=dom-TimedTrack-kind-subtitles><a href=#dom-timedtrack-kind-subtitles>subtitles</a></code> or <code title=dom-TimedTrack-kind-captions><a href=#dom-timedtrack-kind-captions>captions</a></code> and the user
- has indicated an interest in having a track with this <a href=#timed-track-kind>timed
- track kind</a>, <a href=#timed-track-language>timed track language</a>, and
- <a href=#timed-track-label>timed track label</a> enabled, and there is no other
- <a href=#timed-track>timed track</a> in the <a href=#media-element>media element</a>'s
- <a href=#list-of-timed-tracks>list of timed tracks</a> with a <a href=#timed-track-kind>timed track
- kind</a> of either <code title=dom-TimedTrack-kind-subtitles><a href=#dom-timedtrack-kind-subtitles>subtitles</a></code> or <code title=dom-TimedTrack-kind-captions><a href=#dom-timedtrack-kind-captions>captions</a></code> whose
- <a href=#timed-track-mode>timed track mode</a> is <a href=#timed-track-showing title="timed track
+ <dl class=switch><dt>If the <a href=#text-track-kind>text track kind</a> is <code title=dom-TextTrack-kind-subtitles><a href=#dom-texttrack-kind-subtitles>subtitles</a></code> or <code title=dom-TextTrack-kind-captions><a href=#dom-texttrack-kind-captions>captions</a></code> and the user
+ has indicated an interest in having a track with this <a href=#text-track-kind>text
+ track kind</a>, <a href=#text-track-language>text track language</a>, and
+ <a href=#text-track-label>text track label</a> enabled, and there is no other
+ <a href=#text-track>text track</a> in the <a href=#media-element>media element</a>'s
+ <a href=#list-of-text-tracks>list of text tracks</a> with a <a href=#text-track-kind>text track
+ kind</a> of either <code title=dom-TextTrack-kind-subtitles><a href=#dom-texttrack-kind-subtitles>subtitles</a></code> or <code title=dom-TextTrack-kind-captions><a href=#dom-texttrack-kind-captions>captions</a></code> whose
+ <a href=#text-track-mode>text track mode</a> is <a href=#text-track-showing title="text track
showing">showing</a></dt>
- <dt>If the <a href=#timed-track-kind>timed track kind</a> is <code title=dom-TimedTrack-kind-descriptions><a href=#dom-timedtrack-kind-descriptions>descriptions</a></code> and
+ <dt>If the <a href=#text-track-kind>text track kind</a> is <code title=dom-TextTrack-kind-descriptions><a href=#dom-texttrack-kind-descriptions>descriptions</a></code> and
the user has indicated an interest in having text descriptions with
- this <a href=#timed-track-language>timed track language</a> and <a href=#timed-track-label>timed track
- label</a> enabled, and there is no other <a href=#timed-track>timed
- track</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of
- timed tracks</a> with a <a href=#timed-track-kind>timed track kind</a> of <code title=dom-TimedTrack-kind-descriptions><a href=#dom-timedtrack-kind-descriptions>descriptions</a></code> whose
- <a href=#timed-track-mode>timed track mode</a> is <a href=#timed-track-showing title="timed track
+ this <a href=#text-track-language>text track language</a> and <a href=#text-track-label>text track
+ label</a> enabled, and there is no other <a href=#text-track>text
+ track</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of
+ text tracks</a> with a <a href=#text-track-kind>text track kind</a> of <code title=dom-TextTrack-kind-descriptions><a href=#dom-texttrack-kind-descriptions>descriptions</a></code> whose
+ <a href=#text-track-mode>text track mode</a> is <a href=#text-track-showing title="text track
showing">showing</a></dt>
- <dt>If the <a href=#timed-track-kind>timed track kind</a> is <code title=dom-TimedTrack-kind-chapters><a href=#dom-timedtrack-kind-chapters>chapters</a></code> and the
- <a href=#timed-track-language>timed track language</a> is one that the user agent has
+ <dt>If the <a href=#text-track-kind>text track kind</a> is <code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code> and the
+ <a href=#text-track-language>text track language</a> is one that the user agent has
reason to believe is appropriate for the user, and there is no
- other <a href=#timed-track>timed track</a> in the <a href=#media-element>media element</a>'s
- <a href=#list-of-timed-tracks>list of timed tracks</a> with a <a href=#timed-track-kind>timed track
- kind</a> of <code title=dom-TimedTrack-kind-chapters><a href=#dom-timedtrack-kind-chapters>chapters</a></code> whose
- <a href=#timed-track-mode>timed track mode</a> is <a href=#timed-track-showing title="timed track
+ other <a href=#text-track>text track</a> in the <a href=#media-element>media element</a>'s
+ <a href=#list-of-text-tracks>list of text tracks</a> with a <a href=#text-track-kind>text track
+ kind</a> of <code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code> whose
+ <a href=#text-track-mode>text track mode</a> is <a href=#text-track-showing title="text track
showing">showing</a></dt>
<dd>
- <p>Let the <a href=#timed-track-mode>timed track mode</a> be <a href=#timed-track-showing title="timed
+ <p>Let the <a href=#text-track-mode>text track mode</a> be <a href=#text-track-showing title="text
track showing">showing</a>.</p>
- <p>If there is a <a href=#timed-track>timed track</a> in the <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a> whose
- <a href=#timed-track-mode>timed track mode</a> is <a href=#timed-track-showing-by-default title="timed track showing
+ <p>If there is a <a href=#text-track>text track</a> in the <a href=#media-element>media
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a> whose
+ <a href=#text-track-mode>text track mode</a> is <a href=#text-track-showing-by-default title="text track showing
by default">showing by default</a>, the user agent must
- furthermore change <em>that</em> <a href=#timed-track>timed track</a>'s
- <a href=#timed-track-mode>timed track mode</a> to <a href=#timed-track-hidden title="timed track
+ furthermore change <em>that</em> <a href=#text-track>text track</a>'s
+ <a href=#text-track-mode>text track mode</a> to <a href=#text-track-hidden title="text track
hidden">hidden</a>.</p> <!-- so that we still get events and
stuff: we can expect authors to forget that default doesn't mean
that it'll always be turned on, and that they'll still rely on
@@ -28051,34 +28049,34 @@
</dd>
<dt>If the <code><a href=#the-track-element>track</a></code> element has a <code title=attr-track-default><a href=#attr-track-default>default</a></code> attribute specified, and
- there is no other <a href=#timed-track>timed track</a> in the <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a> whose
- <a href=#timed-track-mode>timed track mode</a> is <a href=#timed-track-showing title="timed track
- showing">showing</a> or <a href=#timed-track-showing-by-default title="timed track
+ there is no other <a href=#text-track>text track</a> in the <a href=#media-element>media
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a> whose
+ <a href=#text-track-mode>text track mode</a> is <a href=#text-track-showing title="text track
+ showing">showing</a> or <a href=#text-track-showing-by-default title="text track
showing by default">showing by default</a></dt>
<dd>
- <p>Let the <a href=#timed-track-mode>timed track mode</a> be <a href=#timed-track-showing-by-default title="timed
+ <p>Let the <a href=#text-track-mode>text track mode</a> be <a href=#text-track-showing-by-default title="text
track showing by default">showing by default</a>.</p>
</dd>
<dt>Otherwise</dt>
<dd>
- <p>Let the <a href=#timed-track-mode>timed track mode</a> be <a href=#timed-track-disabled title="timed
+ <p>Let the <a href=#text-track-mode>text track mode</a> be <a href=#text-track-disabled title="text
track disabled">disabled</a>.</p>
</dd>
- </dl><p>When a <a href=#timed-track>timed track</a> corresponding to a
- <code><a href=#the-track-element>track</a></code> element is created with <a href=#timed-track-mode>timed track
- mode</a> set to <a href=#timed-track-hidden title="timed track hidden">hidden</a>,
- <a href=#timed-track-showing title="timed track showing">showing</a>, or <a href=#timed-track-showing-by-default title="timed track showing by default">showing by default</a>,
- and when a <a href=#timed-track>timed track</a> corresponding to a
- <code><a href=#the-track-element>track</a></code> element is created with <a href=#timed-track-mode>timed track
- mode</a> set to <a href=#timed-track-disabled title="timed track
- disabled">disabled</a> and subsequently changes its <a href=#timed-track-mode>timed
- track mode</a> to <a href=#timed-track-hidden title="timed track hidden">hidden</a>,
- <a href=#timed-track-showing title="timed track showing">showing</a>, or <a href=#timed-track-showing-by-default title="timed track showing by default">showing by default</a> for
+ </dl><p>When a <a href=#text-track>text track</a> corresponding to a
+ <code><a href=#the-track-element>track</a></code> element is created with <a href=#text-track-mode>text track
+ mode</a> set to <a href=#text-track-hidden title="text track hidden">hidden</a>,
+ <a href=#text-track-showing title="text track showing">showing</a>, or <a href=#text-track-showing-by-default title="text track showing by default">showing by default</a>,
+ and when a <a href=#text-track>text track</a> corresponding to a
+ <code><a href=#the-track-element>track</a></code> element is created with <a href=#text-track-mode>text track
+ mode</a> set to <a href=#text-track-disabled title="text track
+ disabled">disabled</a> and subsequently changes its <a href=#text-track-mode>text
+ track mode</a> to <a href=#text-track-hidden title="text track hidden">hidden</a>,
+ <a href=#text-track-showing title="text track showing">showing</a>, or <a href=#text-track-showing-by-default title="text track showing by default">showing by default</a> for
the first time, the user agent must immediately and synchronously
run the following algorithm. This algorithm interacts closely with
the <a href=#event-loop>event loop</a> mechanism; in particular, it has a
@@ -28086,14 +28084,14 @@
<a href=#event-loop>event loop</a> algorithm). The step in that section is
marked with ⌛.</p>
- <ol><li><p>Set the <a href=#timed-track-readiness-state>timed track readiness state</a> to <a href=#timed-track-loading title="timed track loading">loading</a>.</li>
+ <ol><li><p>Set the <a href=#text-track-readiness-state>text track readiness state</a> to <a href=#text-track-loading title="text track loading">loading</a>.</li>
<li><p>Let <var title="">URL</var> be the <a href=#track-url>track URL</a> of
the <code><a href=#the-track-element>track</a></code> element.</li>
<li><p>Asynchronously run the remaining steps, while continuing
- with whatever task was responsible for creating the <a href=#timed-track>timed
- track</a> or changing the <a href=#timed-track-mode>timed track
+ with whatever task was responsible for creating the <a href=#text-track>text
+ track</a> or changing the <a href=#text-track-mode>text track
mode</a>.</li>
<li>
@@ -28112,16 +28110,16 @@
process the data as it is being fetched must examine the
resource's <a href=#content-type title=Content-Type>Content Type
metadata</a>, once it is available, if it ever is. If no <a href=#content-type title=Content-Type>Content Type metadata</a> is ever
- available, or if the type is not recognised as a timed track
+ available, or if the type is not recognised as a text track
format, then the resource's format must be assumed to be
unsupported (this causes the load to fail, as described below). If
- a type is obtained, and represents a supported timed track format,
+ a type is obtained, and represents a supported text track format,
then the resource's data must be passed to the appropriate parser
<!--TTVTT-->
(e.g. the <a href=#webvtt-parser>WebVTT parser</a> if the <a href=#content-type title=Content-Type>Content Type metadata</a> is
<code><a href=#text/vtt>text/vtt</a></code>)
<!--TTVTT-->
- as it is received, with the <a href=#timed-track-list-of-cues>timed
+ as it is received, with the <a href=#text-track-list-of-cues>text
track list of cues</a> being used for that parser's output.</p>
<p>If the <a href=#fetch title=fetch>fetching algorithm</a> fails for
@@ -28130,8 +28128,8 @@
the empty string or has the wrong <a href=#origin>origin</a> as
determined by the condition at the start of this step, or if the
fetched resource is not in a supported format, then <a href=#queue-a-task>queue a
- task</a> to first change the <a href=#timed-track-readiness-state>timed track readiness
- state</a> to <a href=#timed-track-failed-to-load title="timed track failed to load">failed to
+ task</a> to first change the <a href=#text-track-readiness-state>text track readiness
+ state</a> to <a href=#text-track-failed-to-load title="text track failed to load">failed to
load</a> and then <a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-error>error</code> at the <code><a href=#the-track-element>track</a></code>
element; and then, once that <a href=#concept-task title=concept-task>task</a> is <a href=#queue-a-task title="queue a
task">queued</a>, move on to the step below labeled
@@ -28139,7 +28137,7 @@
<p>If the <a href=#fetch title=fetch>fetching algorithm</a> does not
fail, then, when it completes, <a href=#queue-a-task>queue a task</a> to first
- change the <a href=#timed-track-readiness-state>timed track readiness state</a> to <a href=#timed-track-loaded title="timed track loaded">loaded</a> and then <a href=#fire-a-simple-event>fire a
+ change the <a href=#text-track-readiness-state>text track readiness state</a> to <a href=#text-track-loaded title="text track loaded">loaded</a> and then <a href=#fire-a-simple-event>fire a
simple event</a> named <code title=event-load>load</code> at
the <code><a href=#the-track-element>track</a></code> element; and then, once that <a href=#concept-task title=concept-task>task</a> is <a href=#queue-a-task title="queue a
task">queued</a>, move on to the step below labeled
@@ -28149,14 +28147,14 @@
active, either:</p>
<ul><li>the <a href=#track-url>track URL</a> changes so that it is no longer
- equal to <var title="">URL</var>, while the <a href=#timed-track-mode>timed track
- mode</a> is set to <a href=#timed-track-hidden title="timed track
- hidden">hidden</a>, <a href=#timed-track-showing title="timed track
- showing">showing</a>, or <a href=#timed-track-showing-by-default title="timed track showing by
+ equal to <var title="">URL</var>, while the <a href=#text-track-mode>text track
+ mode</a> is set to <a href=#text-track-hidden title="text track
+ hidden">hidden</a>, <a href=#text-track-showing title="text track
+ showing">showing</a>, or <a href=#text-track-showing-by-default title="text track showing by
default">showing by default</a>; or</li>
- <li>the <a href=#timed-track-mode>timed track mode</a> changes to <a href=#timed-track-hidden title="timed track hidden">hidden</a>, <a href=#timed-track-showing title="timed
- track showing">showing</a>, or <a href=#timed-track-showing-by-default title="timed track
+ <li>the <a href=#text-track-mode>text track mode</a> changes to <a href=#text-track-hidden title="text track hidden">hidden</a>, <a href=#text-track-showing title="text
+ track showing">showing</a>, or <a href=#text-track-showing-by-default title="text track
showing by default">showing by default</a>, while the
<a href=#track-url>track URL</a> is not equal to <var title="">URL</var></li>
@@ -28182,21 +28180,21 @@
<li><p><i>Monitoring</i>: Wait until the <a href=#track-url>track URL</a> is
no longer equal to <var title="">URL</var>, at the same time as the
- <a href=#timed-track-mode>timed track mode</a> is set to <a href=#timed-track-hidden title="timed track
- hidden">hidden</a>, <a href=#timed-track-showing title="timed track
- showing">showing</a>, or <a href=#timed-track-showing-by-default title="timed track showing by
+ <a href=#text-track-mode>text track mode</a> is set to <a href=#text-track-hidden title="text track
+ hidden">hidden</a>, <a href=#text-track-showing title="text track
+ showing">showing</a>, or <a href=#text-track-showing-by-default title="text track showing by
default">showing by default</a>.</li>
- <li><p>Wait until the <a href=#timed-track-readiness-state>timed track readiness state</a> is
- no longer set to <a href=#timed-track-loading title="timed track
+ <li><p>Wait until the <a href=#text-track-readiness-state>text track readiness state</a> is
+ no longer set to <a href=#text-track-loading title="text track
loading">loading</a>.</li>
<li><p><a href=#await-a-stable-state>Await a stable state</a>. The <a href=#synchronous-section>synchronous
section</a> consists of the following step. (The step in the
<a href=#synchronous-section>synchronous section</a> is marked with ⌛.)</li>
- <li><p>⌛ Set the <a href=#timed-track-readiness-state>timed track readiness state</a> to
- <a href=#timed-track-loading title="timed track loading">loading</a>.</li>
+ <li><p>⌛ Set the <a href=#text-track-readiness-state>text track readiness state</a> to
+ <a href=#text-track-loading title="text track loading">loading</a>.</li>
<!-- if you add more, change the grammar of the sentences above to
be plural with respect to the number of synchronous steps (both in
@@ -28213,53 +28211,53 @@
<!--TTVTT-->
<div class=impl>
- <h6 id=guidelines-for-exposing-cues-in-various-formats-as-timed-track-cues><span class=secno>4.8.10.10.4 </span><dfn>Guidelines for exposing cues</dfn> in various formats as
- <a href=#timed-track-cue title="timed track cue">timed track cues</a></h6>
+ <h6 id=guidelines-for-exposing-cues-in-various-formats-as-text-track-cues><span class=secno>4.8.10.10.4 </span><dfn>Guidelines for exposing cues</dfn> in various formats as
+ <a href=#text-track-cue title="text track cue">text track cues</a></h6>
- <p>How a specific format's timed track cues are to be interpreted
+ <p>How a specific format's text track cues are to be interpreted
for the purposes of processing by an HTML user agent is defined by
that format. In the absence of such a specification, this section
provides some constraints within which implementations can attempt
to consistently expose such formats.</p>
- <p>To support the <a href=#timed-track>timed track</a> model of HTML, each unit
- of timed data is converted to a <a href=#timed-track-cue>timed track cue</a>. Where
- the mapping of the format's features to the aspects of a <a href=#timed-track-cue>timed
+ <p>To support the <a href=#text-track>text track</a> model of HTML, each unit
+ of timed data is converted to a <a href=#text-track-cue>text track cue</a>. Where
+ the mapping of the format's features to the aspects of a <a href=#text-track-cue>text
track cue</a> as defined in this specification are not defined,
implementations must ensure that the mapping is consistent with the
- definitions of the aspects of a <a href=#timed-track-cue>timed track cue</a> as
+ definitions of the aspects of a <a href=#text-track-cue>text track cue</a> as
defined above, as well as with the following constraints:</p>
- <dl><dt>The <a href=#timed-track-cue-identifier>timed track cue identifier</a>
+ <dl><dt>The <a href=#text-track-cue-identifier>text track cue identifier</a>
<dd>
<p>Should be set to the empty string if the format has no
obvious analogue to a per-cue identifier.</p>
</dd>
- <dt>The <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit flag</a>
+ <dt>The <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit flag</a>
<dd>
<p>Should be set to false.</p>
</dd>
- <dt>The <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a>
+ <dt>The <a href=#text-track-cue-writing-direction>text track cue writing direction</a>
<dd>
- <p>Should be set to <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing
+ <p>Should be set to <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing
direction">horizontal</a> if the concept of writing direction
doesn't really apply (e.g. the cue consists of a bitmap
image).</p>
</dd>
- <dt>The <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a>
+ <dt>The <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a>
<dd>
<p>Should be set to false unless the format uses a rendering and
positioning model for cues that is largely consistent with the
<a href=#webvtt-cue-text-rendering-rules>WebVTT cue text rendering rules</a>.</p>
</dd>
- <dt>The <a href=#timed-track-cue-line-position>timed track cue line position</a>
- <dt>The <a href=#timed-track-cue-text-position>timed track cue text position</a>
- <dt>The <a href=#timed-track-cue-size>timed track cue size</a>
- <dt>The <a href=#timed-track-cue-alignment>timed track cue alignment</a>
+ <dt>The <a href=#text-track-cue-line-position>text track cue line position</a>
+ <dt>The <a href=#text-track-cue-text-position>text track cue text position</a>
+ <dt>The <a href=#text-track-cue-size>text track cue size</a>
+ <dt>The <a href=#text-track-cue-alignment>text track cue alignment</a>
</dt></dt></dt><dd>
<p>If the format uses a rendering and positioning model for
cues that can be largely simulated using the <a href=#webvtt-cue-text-rendering-rules>WebVTT cue text
@@ -28272,21 +28270,21 @@
<!--TTVTT-->
- <h6 id=timed-track-api><span class=secno>4.8.10.10.5 </span>Timed track API</h6>
+ <h6 id=text-track-api><span class=secno>4.8.10.10.5 </span>Text track API</h6>
<dl class=domintro><dt><var title="">media</var> . <code title=dom-media-tracks><a href=#dom-media-tracks>tracks</a></code> . <code title="">length</code></dt>
<dd>
- <p>Returns the number of <a href=#timed-track title="timed track">timed tracks</a> associated with the <a href=#media-element>media element</a> (e.g. from <code><a href=#the-track-element>track</a></code> elements). This is the number of <a href=#timed-track title="timed track">timed tracks</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ <p>Returns the number of <a href=#text-track title="text track">text tracks</a> associated with the <a href=#media-element>media element</a> (e.g. from <code><a href=#the-track-element>track</a></code> elements). This is the number of <a href=#text-track title="text track">text tracks</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>.</p>
</dd>
<dt><var title="">media</var> . <code title=dom-media-tracks><a href=#dom-media-tracks>tracks[</a></code> <var title="">n</var> <code title="">]</code></dt>
<dd>
- <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object representing the <var title="">n</var>th <a href=#timed-track>timed track</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ <p>Returns the <code><a href=#texttrack>TextTrack</a></code> object representing the <var title="">n</var>th <a href=#text-track>text track</a> in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>.</p>
</dd>
<dt><var title="">track</var> . <code title=dom-track-track><a href=#dom-track-track>track</a></code></dt>
<dd>
- <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object representing the <code><a href=#the-track-element>track</a></code> element's <a href=#timed-track>timed track</a>.</p>
+ <p>Returns the <code><a href=#texttrack>TextTrack</a></code> object representing the <code><a href=#the-track-element>track</a></code> element's <a href=#text-track>text track</a>.</p>
</dd>
</dl><div class=impl>
@@ -28294,150 +28292,150 @@
<p>The <dfn id=dom-media-tracks title=dom-media-tracks><code>tracks</code></dfn>
attribute of <a href=#media-element title="media element">media elements</a> must
return an <span title="array host objects">array host object</span>
- for objects of type <code><a href=#timedtrack>TimedTrack</a></code> that is <i>fixed
+ for objects of type <code><a href=#texttrack>TextTrack</a></code> that is <i>fixed
length</i> and <i>read only</i>. The same object must be returned
each time the attribute is accessed. <a href=#refsWEBIDL>[WEBIDL]</a></p>
- <p>The array must contain the <code><a href=#timedtrack>TimedTrack</a></code> objects of the
- <a href=#timed-track title="timed track">timed tracks</a> in the <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>, in the same
- order as in the <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ <p>The array must contain the <code><a href=#texttrack>TextTrack</a></code> objects of the
+ <a href=#text-track title="text track">text tracks</a> in the <a href=#media-element>media
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>, in the same
+ order as in the <a href=#list-of-text-tracks>list of text tracks</a>.</p>
</div>
- <hr><pre class=idl>interface <dfn id=timedtrack>TimedTrack</dfn> {
- readonly attribute DOMString <a href=#dom-timedtrack-kind title=dom-TimedTrack-kind>kind</a>;
- readonly attribute DOMString <a href=#dom-timedtrack-label title=dom-TimedTrack-label>label</a>;
- readonly attribute DOMString <a href=#dom-timedtrack-language title=dom-TimedTrack-language>language</a>;
+ <hr><pre class=idl>interface <dfn id=texttrack>TextTrack</dfn> {
+ readonly attribute DOMString <a href=#dom-texttrack-kind title=dom-TextTrack-kind>kind</a>;
+ readonly attribute DOMString <a href=#dom-texttrack-label title=dom-TextTrack-label>label</a>;
+ readonly attribute DOMString <a href=#dom-texttrack-language title=dom-TextTrack-language>language</a>;
- const unsigned short <a href=#dom-timedtrack-none title=dom-TimedTrack-NONE>NONE</a> = 0;
- const unsigned short <a href=#dom-timedtrack-loading title=dom-TimedTrack-LOADING>LOADING</a> = 1;
- const unsigned short <a href=#dom-timedtrack-loaded title=dom-TimedTrack-LOADED>LOADED</a> = 2;
- const unsigned short <a href=#dom-timedtrack-error title=dom-TimedTrack-ERROR>ERROR</a> = 3;
- readonly attribute unsigned short <a href=#dom-timedtrack-readystate title=dom-TimedTrack-readyState>readyState</a>;
- readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrack-onload title=handler-TimedTrack-onload>onload</a>;
- readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrack-onerror title=handler-TimedTrack-onerror>onerror</a>;
+ const unsigned short <a href=#dom-texttrack-none title=dom-TextTrack-NONE>NONE</a> = 0;
+ const unsigned short <a href=#dom-texttrack-loading title=dom-TextTrack-LOADING>LOADING</a> = 1;
+ const unsigned short <a href=#dom-texttrack-loaded title=dom-TextTrack-LOADED>LOADED</a> = 2;
+ const unsigned short <a href=#dom-texttrack-error title=dom-TextTrack-ERROR>ERROR</a> = 3;
+ readonly attribute unsigned short <a href=#dom-texttrack-readystate title=dom-TextTrack-readyState>readyState</a>;
+ readonly attribute <a href=#function>Function</a> <a href=#handler-texttrack-onload title=handler-TextTrack-onload>onload</a>;
+ readonly attribute <a href=#function>Function</a> <a href=#handler-texttrack-onerror title=handler-TextTrack-onerror>onerror</a>;
- const unsigned short <a href=#dom-timedtrack-off title=dom-TimedTrack-OFF>OFF</a> = 0;
- const unsigned short <a href=#dom-timedtrack-hidden title=dom-TimedTrack-HIDDEN>HIDDEN</a> = 1;
- const unsigned short <a href=#dom-timedtrack-showing title=dom-TimedTrack-SHOWING>SHOWING</a> = 2;
- attribute unsigned short <a href=#dom-timedtrack-mode title=dom-TimedTrack-mode>mode</a>;
+ const unsigned short <a href=#dom-texttrack-off title=dom-TextTrack-OFF>OFF</a> = 0;
+ const unsigned short <a href=#dom-texttrack-hidden title=dom-TextTrack-HIDDEN>HIDDEN</a> = 1;
+ const unsigned short <a href=#dom-texttrack-showing title=dom-TextTrack-SHOWING>SHOWING</a> = 2;
+ attribute unsigned short <a href=#dom-texttrack-mode title=dom-TextTrack-mode>mode</a>;
- readonly attribute <a href=#timedtrackcuelist>TimedTrackCueList</a> <a href=#dom-timedtrack-cues title=dom-TimedTrack-cues>cues</a>;
- readonly attribute <a href=#timedtrackcuelist>TimedTrackCueList</a> <a href=#dom-timedtrack-activecues title=dom-TimedTrack-activeCues>activeCues</a>;
+ readonly attribute <a href=#texttrackcuelist>TextTrackCueList</a> <a href=#dom-texttrack-cues title=dom-TextTrack-cues>cues</a>;
+ readonly attribute <a href=#texttrackcuelist>TextTrackCueList</a> <a href=#dom-texttrack-activecues title=dom-TextTrack-activeCues>activeCues</a>;
- readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrack-oncuechange title=handler-TimedTrack-oncuechange>oncuechange</a>;
+ readonly attribute <a href=#function>Function</a> <a href=#handler-texttrack-oncuechange title=handler-TextTrack-oncuechange>oncuechange</a>;
};</pre>
- <dl class=domintro><dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-kind><a href=#dom-timedtrack-kind>kind</a></code></dt>
+ <dl class=domintro><dt><var title="">timedTrack</var> . <code title=dom-TextTrack-kind><a href=#dom-texttrack-kind>kind</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-kind>timed track kind</a> string.</p>
+ <p>Returns the <a href=#text-track-kind>text track kind</a> string.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-label><a href=#dom-timedtrack-label>label</a></code></dt>
+ <dt><var title="">timedTrack</var> . <code title=dom-TextTrack-label><a href=#dom-texttrack-label>label</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-label>timed track label</a>.</p>
+ <p>Returns the <a href=#text-track-label>text track label</a>.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-language><a href=#dom-timedtrack-language>language</a></code></dt>
+ <dt><var title="">timedTrack</var> . <code title=dom-TextTrack-language><a href=#dom-texttrack-language>language</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-language>timed track language</a> string.</p>
+ <p>Returns the <a href=#text-track-language>text track language</a> string.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-readyState><a href=#dom-timedtrack-readystate>readyState</a></code></dt>
+ <dt><var title="">timedTrack</var> . <code title=dom-TextTrack-readyState><a href=#dom-texttrack-readystate>readyState</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-readiness-state>timed track readiness state</a>,
+ <p>Returns the <a href=#text-track-readiness-state>text track readiness state</a>,
represented by a number from the following list:</p>
- <dl><dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-NONE><a href=#dom-timedtrack-none>NONE</a></code> (0)</dt>
+ <dl><dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-NONE><a href=#dom-texttrack-none>NONE</a></code> (0)</dt>
<dd>
- <p>The <a href=#timed-track-not-loaded>timed track not loaded</a> state.</p>
+ <p>The <a href=#text-track-not-loaded>text track not loaded</a> state.</p>
</dd>
- <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-LOADING><a href=#dom-timedtrack-loading>LOADING</a></code> (1)</dt>
+ <dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-LOADING><a href=#dom-texttrack-loading>LOADING</a></code> (1)</dt>
<dd>
- <p>The <a href=#timed-track-loading>timed track loading</a> state.</p>
+ <p>The <a href=#text-track-loading>text track loading</a> state.</p>
</dd>
- <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-LOADED><a href=#dom-timedtrack-loaded>LOADED</a></code> (2)</dt>
+ <dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-LOADED><a href=#dom-texttrack-loaded>LOADED</a></code> (2)</dt>
<dd>
- <p>The <a href=#timed-track-loaded>timed track loaded</a> state.</p>
+ <p>The <a href=#text-track-loaded>text track loaded</a> state.</p>
</dd>
- <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-ERROR><a href=#dom-timedtrack-error>ERROR</a></code> (3)</dt>
+ <dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-ERROR><a href=#dom-texttrack-error>ERROR</a></code> (3)</dt>
<dd>
- <p>The <a href=#timed-track-failed-to-load>timed track failed to load</a> state.</p>
+ <p>The <a href=#text-track-failed-to-load>text track failed to load</a> state.</p>
</dd>
</dl></dd>
- <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-mode><a href=#dom-timedtrack-mode>mode</a></code></dt>
+ <dt><var title="">timedTrack</var> . <code title=dom-TextTrack-mode><a href=#dom-texttrack-mode>mode</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-mode>timed track mode</a>, represented by a
+ <p>Returns the <a href=#text-track-mode>text track mode</a>, represented by a
number from the following list:</p>
- <dl><dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-OFF><a href=#dom-timedtrack-off>OFF</a></code> (0)</dt>
+ <dl><dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-OFF><a href=#dom-texttrack-off>OFF</a></code> (0)</dt>
<dd>
- <p>The <a href=#timed-track-disabled>timed track disabled</a> mode.</p>
+ <p>The <a href=#text-track-disabled>text track disabled</a> mode.</p>
</dd>
- <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-HIDDEN><a href=#dom-timedtrack-hidden>HIDDEN</a></code> (1)</dt>
+ <dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-HIDDEN><a href=#dom-texttrack-hidden>HIDDEN</a></code> (1)</dt>
<dd>
- <p>The <a href=#timed-track-hidden>timed track hidden</a> mode.</p>
+ <p>The <a href=#text-track-hidden>text track hidden</a> mode.</p>
</dd>
- <dt><code><a href=#timedtrack>TimedTrack</a></code> . <code title=dom-TimedTrack-SHOWING><a href=#dom-timedtrack-showing>SHOWING</a></code> (2)</dt>
+ <dt><code><a href=#texttrack>TextTrack</a></code> . <code title=dom-TextTrack-SHOWING><a href=#dom-texttrack-showing>SHOWING</a></code> (2)</dt>
<dd>
- <p>The <a href=#timed-track-showing>timed track showing</a> and <a href=#timed-track-showing-by-default title="timed track showing by default">showing by default</a> modes.</p>
+ <p>The <a href=#text-track-showing>text track showing</a> and <a href=#text-track-showing-by-default title="text track showing by default">showing by default</a> modes.</p>
</dd>
</dl><p>Can be set, to change the mode.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-cues><a href=#dom-timedtrack-cues>cues</a></code></dt>
+ <dt><var title="">timedTrack</var> . <code title=dom-TextTrack-cues><a href=#dom-texttrack-cues>cues</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-list-of-cues>timed track list of cues</a>, as a <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+ <p>Returns the <a href=#text-track-list-of-cues>text track list of cues</a>, as a <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title=dom-TimedTrack-activeCues><a href=#dom-timedtrack-activecues>activeCues</a></code></dt>
+ <dt><var title="">timedTrack</var> . <code title=dom-TextTrack-activeCues><a href=#dom-texttrack-activecues>activeCues</a></code></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue title="timed track cue">timed track cues</a> from the <a href=#timed-track-list-of-cues>timed track list of cues</a> that are currently active (i.e. that start before the <a href=#current-playback-position>current playback position</a> and end after it), as a <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+ <p>Returns the <a href=#text-track-cue title="text track cue">text track cues</a> from the <a href=#text-track-list-of-cues>text track list of cues</a> that are currently active (i.e. that start before the <a href=#current-playback-position>current playback position</a> and end after it), as a <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object.</p>
</dd>
</dl><div class=impl>
- <p>The <dfn id=dom-timedtrack-kind title=dom-TimedTrack-kind><code>kind</code></dfn>
- attribute must return the <a href=#timed-track-kind>timed track kind</a> of the
- <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
+ <p>The <dfn id=dom-texttrack-kind title=dom-TextTrack-kind><code>kind</code></dfn>
+ attribute must return the <a href=#text-track-kind>text track kind</a> of the
+ <a href=#text-track>text track</a> that the <code><a href=#texttrack>TextTrack</a></code> object
represents.</p>
- <p>The <dfn id=dom-timedtrack-label title=dom-TimedTrack-label><code>label</code></dfn>
- attribute must return the <a href=#timed-track-label>timed track label</a> of the
- <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
+ <p>The <dfn id=dom-texttrack-label title=dom-TextTrack-label><code>label</code></dfn>
+ attribute must return the <a href=#text-track-label>text track label</a> of the
+ <a href=#text-track>text track</a> that the <code><a href=#texttrack>TextTrack</a></code> object
represents.</p>
- <p>The <dfn id=dom-timedtrack-language title=dom-TimedTrack-language><code>language</code></dfn>
- attribute must return the <a href=#timed-track-language>timed track language</a> of the
- <a href=#timed-track>timed track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object
+ <p>The <dfn id=dom-texttrack-language title=dom-TextTrack-language><code>language</code></dfn>
+ attribute must return the <a href=#text-track-language>text track language</a> of the
+ <a href=#text-track>text track</a> that the <code><a href=#texttrack>TextTrack</a></code> object
represents.</p>
- <p>The <dfn id=dom-timedtrack-readystate title=dom-TimedTrack-readyState><code>readyState</code></dfn>
+ <p>The <dfn id=dom-texttrack-readystate title=dom-TextTrack-readyState><code>readyState</code></dfn>
attribute must return the numeric value corresponding to the
- <a href=#timed-track-readiness-state>timed track readiness state</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents, as
+ <a href=#text-track-readiness-state>text track readiness state</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents, as
defined by the following list:</p>
- <dl><dt><dfn id=dom-timedtrack-none title=dom-TimedTrack-NONE><code>NONE</code></dfn> (numeric value 0)</dt>
- <dd>The <a href=#timed-track-not-loaded>timed track not loaded</a> state.</dd>
- <dt><dfn id=dom-timedtrack-loading title=dom-TimedTrack-LOADING><code>LOADING</code></dfn> (numeric value 1)</dt>
- <dd>The <a href=#timed-track-loading>timed track loading</a> state.</dd>
- <dt><dfn id=dom-timedtrack-loaded title=dom-TimedTrack-LOADED><code>LOADED</code></dfn> (numeric value 2)</dt>
- <dd>The <a href=#timed-track-loaded>timed track loaded</a> state.</dd>
- <dt><dfn id=dom-timedtrack-error title=dom-TimedTrack-ERROR><code>ERROR</code></dfn> (numeric value 3)</dt>
- <dd>The <a href=#timed-track-failed-to-load>timed track failed to load</a> state.</dd>
- </dl><p>The <dfn id=dom-timedtrack-mode title=dom-TimedTrack-mode><code>mode</code></dfn>
+ <dl><dt><dfn id=dom-texttrack-none title=dom-TextTrack-NONE><code>NONE</code></dfn> (numeric value 0)</dt>
+ <dd>The <a href=#text-track-not-loaded>text track not loaded</a> state.</dd>
+ <dt><dfn id=dom-texttrack-loading title=dom-TextTrack-LOADING><code>LOADING</code></dfn> (numeric value 1)</dt>
+ <dd>The <a href=#text-track-loading>text track loading</a> state.</dd>
+ <dt><dfn id=dom-texttrack-loaded title=dom-TextTrack-LOADED><code>LOADED</code></dfn> (numeric value 2)</dt>
+ <dd>The <a href=#text-track-loaded>text track loaded</a> state.</dd>
+ <dt><dfn id=dom-texttrack-error title=dom-TextTrack-ERROR><code>ERROR</code></dfn> (numeric value 3)</dt>
+ <dd>The <a href=#text-track-failed-to-load>text track failed to load</a> state.</dd>
+ </dl><p>The <dfn id=dom-texttrack-mode title=dom-TextTrack-mode><code>mode</code></dfn>
attribute, on getting, must return the numeric value corresponding
- to the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed track</a>
- that the <code><a href=#timedtrack>TimedTrack</a></code> object represents, as defined by
+ to the <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text track</a>
+ that the <code><a href=#texttrack>TextTrack</a></code> object represents, as defined by
the following list:</p>
- <dl><dt><dfn id=dom-timedtrack-off title=dom-TimedTrack-OFF><code>OFF</code></dfn> (numeric value 0)</dt>
- <dd>The <a href=#timed-track-disabled>timed track disabled</a> mode.</dd>
- <dt><dfn id=dom-timedtrack-hidden title=dom-TimedTrack-HIDDEN><code>HIDDEN</code></dfn> (numeric value 1)</dt>
- <dd>The <a href=#timed-track-hidden>timed track hidden</a> mode.</dd>
- <dt><dfn id=dom-timedtrack-showing title=dom-TimedTrack-SHOWING><code>SHOWING</code></dfn> (numeric value 2)</dt>
- <dd>The <a href=#timed-track-showing>timed track showing</a> and <a href=#timed-track-showing-by-default title="timed track showing by default">showing by default</a> modes.</dd>
+ <dl><dt><dfn id=dom-texttrack-off title=dom-TextTrack-OFF><code>OFF</code></dfn> (numeric value 0)</dt>
+ <dd>The <a href=#text-track-disabled>text track disabled</a> mode.</dd>
+ <dt><dfn id=dom-texttrack-hidden title=dom-TextTrack-HIDDEN><code>HIDDEN</code></dfn> (numeric value 1)</dt>
+ <dd>The <a href=#text-track-hidden>text track hidden</a> mode.</dd>
+ <dt><dfn id=dom-texttrack-showing title=dom-TextTrack-SHOWING><code>SHOWING</code></dfn> (numeric value 2)</dt>
+ <dd>The <a href=#text-track-showing>text track showing</a> and <a href=#text-track-showing-by-default title="text track showing by default">showing by default</a> modes.</dd>
</dl><p>On setting, if the new value is not either 0, 1, or 2, the user
agent must throw an <code><a href=#invalid_access_err>INVALID_ACCESS_ERR</a></code>
exception. Otherwise, if the new value isn't equal to what the
@@ -28448,9 +28446,9 @@
<dd>
- <p>Set the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents to
- the <a href=#timed-track-disabled>timed track disabled</a> mode.</p>
+ <p>Set the <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents to
+ the <a href=#text-track-disabled>text track disabled</a> mode.</p>
</dd>
@@ -28458,9 +28456,9 @@
<dd>
- <p>Set the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents to
- the <a href=#timed-track-hidden>timed track hidden</a> mode.</p>
+ <p>Set the <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents to
+ the <a href=#text-track-hidden>text track hidden</a> mode.</p>
</dd>
@@ -28468,28 +28466,28 @@
<dd>
- <p>Set the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents to
- the <a href=#timed-track-showing>timed track showing</a> mode.</p>
+ <p>Set the <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents to
+ the <a href=#text-track-showing>text track showing</a> mode.</p>
- <p class=note>If the mode had been <a href=#timed-track-showing-by-default title="timed track
+ <p class=note>If the mode had been <a href=#text-track-showing-by-default title="text track
showing by default">showing by default</a>, this will change it
- to <a href=#timed-track-showing title="timed track showing">showing</a>, even though
- the value of <code title=dom-TimedTrack-mode><a href=#dom-timedtrack-mode>mode</a></code> would
+ to <a href=#text-track-showing title="text track showing">showing</a>, even though
+ the value of <code title=dom-TextTrack-mode><a href=#dom-texttrack-mode>mode</a></code> would
appear not to change.</p>
</dd>
- </dl><p>If the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents is
- not the <a href=#timed-track-disabled>timed track disabled</a> mode, then the <dfn id=dom-timedtrack-cues title=dom-TimedTrack-cues><code>cues</code></dfn> attribute must
- return a <a href=#live>live</a> <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object
- that represents the subset of the <a href=#timed-track-list-of-cues>timed track list of
- cues</a> of the <a href=#timed-track>timed track</a> that the
- <code><a href=#timedtrack>TimedTrack</a></code> object represents whose <a href=#timed-track-cue-start-time title="timed
+ </dl><p>If the <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents is
+ not the <a href=#text-track-disabled>text track disabled</a> mode, then the <dfn id=dom-texttrack-cues title=dom-TextTrack-cues><code>cues</code></dfn> attribute must
+ return a <a href=#live>live</a> <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object
+ that represents the subset of the <a href=#text-track-list-of-cues>text track list of
+ cues</a> of the <a href=#text-track>text track</a> that the
+ <code><a href=#texttrack>TextTrack</a></code> object represents whose <a href=#text-track-cue-start-time title="text
track cue start time">start times</a> occur before the
<a href=#earliest-possible-position-when-the-script-started>earliest possible position when the script started</a>, in
- <a href=#timed-track-cue-order>timed track cue order</a>. Otherwise, it must return
+ <a href=#text-track-cue-order>text track cue order</a>. Otherwise, it must return
null. When an object is returned, the same object must be returned
each time.</p>
@@ -28497,45 +28495,45 @@
is whatever the <a href=#earliest-possible-position>earliest possible position</a> was the last
time the <a href=#event-loop>event loop</a> reached step 1.</p>
- <p>If the <a href=#timed-track-mode>timed track mode</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents is
- not the <a href=#timed-track-disabled>timed track disabled</a> mode, then the <dfn id=dom-timedtrack-activecues title=dom-TimedTrack-activeCues><code>activeCues</code></dfn>
+ <p>If the <a href=#text-track-mode>text track mode</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents is
+ not the <a href=#text-track-disabled>text track disabled</a> mode, then the <dfn id=dom-texttrack-activecues title=dom-TextTrack-activeCues><code>activeCues</code></dfn>
attribute must return a <a href=#live>live</a>
- <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object that represents the subset of
- the <a href=#timed-track-list-of-cues>timed track list of cues</a> of the <a href=#timed-track>timed
- track</a> that the <code><a href=#timedtrack>TimedTrack</a></code> object represents
+ <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object that represents the subset of
+ the <a href=#text-track-list-of-cues>text track list of cues</a> of the <a href=#text-track>text
+ track</a> that the <code><a href=#texttrack>TextTrack</a></code> object represents
whose <a href=#active-flag-was-set-when-the-script-started>active flag was set when the script started</a>, in
- <a href=#timed-track-cue-order>timed track cue order</a>. Otherwise, it must return
+ <a href=#text-track-cue-order>text track cue order</a>. Otherwise, it must return
null. When an object is returned, the same object must be returned
each time.</p>
- <p>A <a href=#timed-track-cue>timed track cue</a>'s <dfn id=active-flag-was-set-when-the-script-started>active flag was set when
- the script started</dfn> if its <a href=#timed-track-cue-active-flag>timed track cue active
+ <p>A <a href=#text-track-cue>text track cue</a>'s <dfn id=active-flag-was-set-when-the-script-started>active flag was set when
+ the script started</dfn> if its <a href=#text-track-cue-active-flag>text track cue active
flag</a> was set the last time the <a href=#event-loop>event loop</a>
reached step 1.</p>
</div>
- <hr><pre class=idl>interface <dfn id=mutabletimedtrack>MutableTimedTrack</dfn> : <a href=#timedtrack>TimedTrack</a> {
- void <a href=#dom-mutabletimedtrack-addcue title=dom-MutableTimedTrack-addCue>addCue</a>(in <a href=#timedtrackcue>TimedTrackCue</a> cue);
- void <a href=#dom-mutabletimedtrack-removecue title=dom-MutableTimedTrack-removeCue>removeCue</a>(in <a href=#timedtrackcue>TimedTrackCue</a> cue);
+ <hr><pre class=idl>interface <dfn id=mutabletexttrack>MutableTextTrack</dfn> : <a href=#texttrack>TextTrack</a> {
+ void <a href=#dom-mutabletexttrack-addcue title=dom-MutableTextTrack-addCue>addCue</a>(in <a href=#texttrackcue>TextTrackCue</a> cue);
+ void <a href=#dom-mutabletexttrack-removecue title=dom-MutableTextTrack-removeCue>removeCue</a>(in <a href=#texttrackcue>TextTrackCue</a> cue);
};</pre>
- <dl class=domintro><dt><var title="">mutableTimedTrack</var> = <var title="">media</var> . <code title=dom-media-addTrack><a href=#dom-media-addtrack>addTrack</a></code>( <var title="">kind</var> [, <var title="">label</var> [, <var title="">language</var> ] ] )</dt>
+ <dl class=domintro><dt><var title="">mutableTextTrack</var> = <var title="">media</var> . <code title=dom-media-addTrack><a href=#dom-media-addtrack>addTrack</a></code>( <var title="">kind</var> [, <var title="">label</var> [, <var title="">language</var> ] ] )</dt>
<dd>
- <p>Creates and returns a new <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object, which is also added to the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ <p>Creates and returns a new <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object, which is also added to the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>.</p>
</dd>
- <dt><var title="">mutableTimedTrack</var> . <code title=dom-MutableTimedTrack-addCue><a href=#dom-mutabletimedtrack-addcue>addCue</a></code>( <var title="">cue</var> )</dt>
+ <dt><var title="">mutableTextTrack</var> . <code title=dom-MutableTextTrack-addCue><a href=#dom-mutabletexttrack-addcue>addCue</a></code>( <var title="">cue</var> )</dt>
<dd>
- <p>Adds the given cue to <var title="">mutableTimedTrack</var>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>.</p>
- <p>Raises an exception if the argument is null, associated with another <a href=#timed-track>timed track</a>, or already in the list of cues.</p>
+ <p>Adds the given cue to <var title="">mutableTextTrack</var>'s <a href=#text-track-list-of-cues>text track list of cues</a>.</p>
+ <p>Raises an exception if the argument is null, associated with another <a href=#text-track>text track</a>, or already in the list of cues.</p>
</dd>
- <dt><var title="">mutableTimedTrack</var> . <code title=dom-MutableTimedTrack-removeCue><a href=#dom-mutabletimedtrack-removecue>removeCue</a></code>( <var title="">cue</var> )</dt>
+ <dt><var title="">mutableTextTrack</var> . <code title=dom-MutableTextTrack-removeCue><a href=#dom-mutabletexttrack-removecue>removeCue</a></code>( <var title="">cue</var> )</dt>
<dd>
- <p>Removes the given cue from <var title="">mutableTimedTrack</var>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>.</p>
- <p>Raises an exception if the argument is null, associated with another <a href=#timed-track>timed track</a>, or not in the list of cues.</p>
+ <p>Removes the given cue from <var title="">mutableTextTrack</var>'s <a href=#text-track-list-of-cues>text track list of cues</a>.</p>
+ <p>Raises an exception if the argument is null, associated with another <a href=#text-track>text track</a>, or not in the list of cues.</p>
</dd>
</dl><div class=impl>
@@ -28550,11 +28548,11 @@
strings, then throw a <code><a href=#syntax_err>SYNTAX_ERR</a></code> exception and abort
these steps:</p>
- <ul class=brief><li><code title=dom-TimedTrack-kind-subtitles><a href=#dom-timedtrack-kind-subtitles>subtitles</a></code>
- <li><code title=dom-TimedTrack-kind-captions><a href=#dom-timedtrack-kind-captions>captions</a></code>
- <li><code title=dom-TimedTrack-kind-descriptions><a href=#dom-timedtrack-kind-descriptions>descriptions</a></code>
- <li><code title=dom-TimedTrack-kind-chapters><a href=#dom-timedtrack-kind-chapters>chapters</a></code>
- <li><code title=dom-TimedTrack-kind-metadata><a href=#dom-timedtrack-kind-metadata>metadata</a></code>
+ <ul class=brief><li><code title=dom-TextTrack-kind-subtitles><a href=#dom-texttrack-kind-subtitles>subtitles</a></code>
+ <li><code title=dom-TextTrack-kind-captions><a href=#dom-texttrack-kind-captions>captions</a></code>
+ <li><code title=dom-TextTrack-kind-descriptions><a href=#dom-texttrack-kind-descriptions>descriptions</a></code>
+ <li><code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code>
+ <li><code title=dom-TextTrack-kind-metadata><a href=#dom-texttrack-kind-metadata>metadata</a></code>
</ul></li>
<li>
@@ -28572,18 +28570,18 @@
<li>
- <p>Create a new <a href=#timed-track>timed track</a>, and set its <a href=#timed-track-kind>timed
- track kind</a> to <var title="">kind</var>, its <a href=#timed-track-label>timed
- track label</a> to <var title="">label</var>, its <a href=#timed-track-language>timed
+ <p>Create a new <a href=#text-track>text track</a>, and set its <a href=#text-track-kind>text
+ track kind</a> to <var title="">kind</var>, its <a href=#text-track-label>text
+ track label</a> to <var title="">label</var>, its <a href=#text-track-language>text
track language</a> to <var title="">language</var>, its
- <a href=#timed-track-readiness-state>timed track readiness state</a> to the <a href=#timed-track-loaded>timed track
- loaded</a> state, its <a href=#timed-track-mode>timed track mode</a> to the
- <a href=#timed-track-hidden>timed track hidden</a> mode, and its <a href=#timed-track-list-of-cues>timed track
+ <a href=#text-track-readiness-state>text track readiness state</a> to the <a href=#text-track-loaded>text track
+ loaded</a> state, its <a href=#text-track-mode>text track mode</a> to the
+ <a href=#text-track-hidden>text track hidden</a> mode, and its <a href=#text-track-list-of-cues>text track
list of cues</a> to an empty list.
<!--TTVTT-->
- Associate the <a href=#timed-track-list-of-cues>timed track list of cues</a> with the
- <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the display of WebVTT timed tracks</a>
- as its <a href=#rules-for-updating-the-timed-track-rendering>rules for updating the timed track rendering</a>.
+ Associate the <a href=#text-track-list-of-cues>text track list of cues</a> with the
+ <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the display of WebVTT text tracks</a>
+ as its <a href=#rules-for-updating-the-text-track-rendering>rules for updating the text track rendering</a>.
<!--TTVTT-->
</p>
@@ -28591,11 +28589,11 @@
<li>
- <p>Add the new <a href=#timed-track>timed track</a> to the <a href=#media-element>media
- element</a>'s <a href=#list-of-timed-tracks>list of timed tracks</a>.</p>
+ <p>Add the new <a href=#text-track>text track</a> to the <a href=#media-element>media
+ element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>.</p>
- </ol><p>The <dfn id=dom-mutabletimedtrack-addcue title=dom-MutableTimedTrack-addCue><code>addCue(<var title="">cue</var>)</code></dfn> method of
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> objects, when invoked, must run the
+ </ol><p>The <dfn id=dom-mutabletexttrack-addcue title=dom-MutableTextTrack-addCue><code>addCue(<var title="">cue</var>)</code></dfn> method of
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> objects, when invoked, must run the
following steps:</p>
<ol><li><p>If <var title="">cue</var> is null, then throw an
@@ -28603,27 +28601,27 @@
steps.</li>
<li><p>If the given <var title="">cue</var> is already associated
- with a <a href=#timed-track>timed track</a> other than the method's
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed track</a>,
+ with a <a href=#text-track>text track</a> other than the method's
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text track</a>,
then throw an <code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code> exception and abort
these steps.</li>
<li><p>Associate <var title="">cue</var> with the method's
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed track</a>,
- if it is not currently associated with a <a href=#timed-track>timed
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text track</a>,
+ if it is not currently associated with a <a href=#text-track>text
track</a>.</li>
<li><p>If the given <var title="">cue</var> is already listed in
- the method's <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed
- track</a>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>, then throw an
+ the method's <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text
+ track</a>'s <a href=#text-track-list-of-cues>text track list of cues</a>, then throw an
<code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code> exception.</li>
<li><p>Add <var title="">cue</var> to the method's
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed track</a>'s
- <a href=#timed-track-list-of-cues>timed track list of cues</a>.</li>
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text track</a>'s
+ <a href=#text-track-list-of-cues>text track list of cues</a>.</li>
- </ol><p>The <dfn id=dom-mutabletimedtrack-removecue title=dom-MutableTimedTrack-removeCue><code>removeCue(<var title="">cue</var>)</code></dfn> method of
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> objects, when invoked, must run the
+ </ol><p>The <dfn id=dom-mutabletexttrack-removecue title=dom-MutableTextTrack-removeCue><code>removeCue(<var title="">cue</var>)</code></dfn> method of
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> objects, when invoked, must run the
following steps:</p>
<ol><li><p>If <var title="">cue</var> is null, then throw an
@@ -28631,18 +28629,18 @@
steps.</li>
<li><p>If the given <var title="">cue</var> is not associated with
- the method's <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed
+ the method's <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text
track</a>, then throw an <code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code>
exception.</li>
<li><p>If the given <var title="">cue</var> is not currently listed
- in the method's <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed
- track</a>'s <a href=#timed-track-list-of-cues>timed track list of cues</a>, then throw a
+ in the method's <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text
+ track</a>'s <a href=#text-track-list-of-cues>text track list of cues</a>, then throw a
<code><a href=#not_found_err>NOT_FOUND_ERR</a></code> exception.</li>
<li><p>Remove <var title="">cue</var> from the method's
- <code><a href=#mutabletimedtrack>MutableTimedTrack</a></code> object's <a href=#timed-track>timed track</a>'s
- <a href=#timed-track-list-of-cues>timed track list of cues</a>.</li>
+ <code><a href=#mutabletexttrack>MutableTextTrack</a></code> object's <a href=#text-track>text track</a>'s
+ <a href=#text-track-list-of-cues>text track list of cues</a>.</li>
</ol></div>
@@ -28659,8 +28657,8 @@
<pre>var sfx = new Audio('sfx.wav');
var sounds = a.addTrack('metadata');
// add sounds we care about
-sounds.addCue(new TimedTrackCue('dog bark', 12.783, 13.612, '', '', '', true));
-sounds.addCue(new TimedTrackCue('kitten mew', 13.612, 15.091, '', '', '', true));
+sounds.addCue(new TextTrackCue('dog bark', 12.783, 13.612, '', '', '', true));
+sounds.addCue(new TextTrackCue('kitten mew', 13.612, 15.091, '', '', '', true));
function playSound(id) {
sfx.currentTime = sounds.getCueById(id).startTime;
@@ -28677,56 +28675,56 @@
</div>
- <hr><pre class=idl>interface <dfn id=timedtrackcuelist>TimedTrackCueList</dfn> {
- readonly attribute unsigned long <a href=#dom-timedtrackcuelist-length title=dom-TimedTrackCueList-length>length</a>;
- getter <a href=#timedtrackcue>TimedTrackCue</a> (in unsigned long index);
- <a href=#timedtrackcue>TimedTrackCue</a> <a href=#dom-timedtrackcuelist-getcuebyid title=dom-TimedTrackCueList-getCueById>getCueById</a>(in DOMString id);
+ <hr><pre class=idl>interface <dfn id=texttrackcuelist>TextTrackCueList</dfn> {
+ readonly attribute unsigned long <a href=#dom-texttrackcuelist-length title=dom-TextTrackCueList-length>length</a>;
+ getter <a href=#texttrackcue>TextTrackCue</a> (in unsigned long index);
+ <a href=#texttrackcue>TextTrackCue</a> <a href=#dom-texttrackcuelist-getcuebyid title=dom-TextTrackCueList-getCueById>getCueById</a>(in DOMString id);
};</pre>
- <dl class=domintro><dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-length><a href=#dom-timedtrackcuelist-length>length</a></code></dt>
+ <dl class=domintro><dt><var title="">cuelist</var> . <code title=dom-TextTrackCueList-length><a href=#dom-texttrackcuelist-length>length</a></code></dt>
<dd>
- <p>Returns the number of <a href=#timed-track-cue title="timed track cue">cues</a> in the list.</p>
+ <p>Returns the number of <a href=#text-track-cue title="text track cue">cues</a> in the list.</p>
</dd>
<dt><var title="">cuelist</var>[<var title="">index</var>]</dt>
<dd>
- <p>Returns the <a href=#timed-track-cue>timed track cue</a> with index <var title="">index</var> in the list. The cues are sorted in <a href=#timed-track-cue-order>timed track cue order</a>.</p>
+ <p>Returns the <a href=#text-track-cue>text track cue</a> with index <var title="">index</var> in the list. The cues are sorted in <a href=#text-track-cue-order>text track cue order</a>.</p>
</dd>
- <dt><var title="">cuelist</var> . <code title=dom-TimedTrackCueList-getCueById><a href=#dom-timedtrackcuelist-getcuebyid>getCueById</a></code>( <var title="">id</var> )</dt>
+ <dt><var title="">cuelist</var> . <code title=dom-TextTrackCueList-getCueById><a href=#dom-texttrackcuelist-getcuebyid>getCueById</a></code>( <var title="">id</var> )</dt>
<dd>
- <p>Returns the first <a href=#timed-track-cue>timed track cue</a> (in <a href=#timed-track-cue-order>timed track cue order</a>) with <a href=#timed-track-cue-identifier>timed track cue identifier</a> <var title="">id</var>.</p>
+ <p>Returns the first <a href=#text-track-cue>text track cue</a> (in <a href=#text-track-cue-order>text track cue order</a>) with <a href=#text-track-cue-identifier>text track cue identifier</a> <var title="">id</var>.</p>
<p>Returns null if none of the cues have the given identifier or if the argument is the empty string.</p>
</dd>
</dl><div class=impl>
- <p>A <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object represents a dynamically
- updating list of <a href=#timed-track-cue title="timed track cue">timed track
+ <p>A <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object represents a dynamically
+ updating list of <a href=#text-track-cue title="text track cue">text track
cues</a> in a given order.</p>
- <p>The <dfn id=dom-timedtrackcuelist-length title=dom-TimedTrackCueList-length><code>length</code></dfn>
- attribute must return the number of <a href=#timed-track-cue title="timed track
+ <p>The <dfn id=dom-texttrackcuelist-length title=dom-TextTrackCueList-length><code>length</code></dfn>
+ attribute must return the number of <a href=#text-track-cue title="text track
cue">cues</a> in the list represented by the
- <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+ <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object.</p>
<p>The <span>supported property indicies</span> of a
- <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object at any instant are the numbers
- from zero to the number of <a href=#timed-track-cue title="timed track cue">cues</a>
- in the list represented by the <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object
- minus one, if any. If there are no <a href=#timed-track-cue title="timed track
+ <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object at any instant are the numbers
+ from zero to the number of <a href=#text-track-cue title="text track cue">cues</a>
+ in the list represented by the <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object
+ minus one, if any. If there are no <a href=#text-track-cue title="text track
cue">cues</a> in the list, there are no <span>supported property
indicies</span>.</p>
<p>To <span>determine the value of an indexed property</span> for a
given index <var title="">index</var>, the user agent must return
- the <var title="">index</var>th <a href=#timed-track-cue>timed track cue</a> in the
- list represented by the <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object.</p>
+ the <var title="">index</var>th <a href=#text-track-cue>text track cue</a> in the
+ list represented by the <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object.</p>
- <p>The <dfn id=dom-timedtrackcuelist-getcuebyid title=dom-TimedTrackCueList-getCueById><code>getCueById(<var title="">id</var>)</code></dfn> method, when called with an argument
- other than the empty string, must return the first <a href=#timed-track-cue>timed track
+ <p>The <dfn id=dom-texttrackcuelist-getcuebyid title=dom-TextTrackCueList-getCueById><code>getCueById(<var title="">id</var>)</code></dfn> method, when called with an argument
+ other than the empty string, must return the first <a href=#text-track-cue>text track
cue</a> in the list represented by the
- <code><a href=#timedtrackcuelist>TimedTrackCueList</a></code> object whose <a href=#timed-track-cue-identifier>timed track cue
+ <code><a href=#texttrackcuelist>TextTrackCueList</a></code> object whose <a href=#text-track-cue-identifier>text track cue
identifier</a> is <var title="">id</var>, if any, or null
otherwise. If the argument is the empty string, then the method must
return null.</p>
@@ -28735,153 +28733,153 @@
<hr><pre class=idl>
<!--TTVTT-->
-[<a href=#dom-timedtrackcue title=dom-TimedTrackCue>Constructor</a>(in DOMString id, in double startTime, in double endTime, in DOMString text, in optional DOMString settings, in optional boolean pauseOnExit)]
+[<a href=#dom-texttrackcue title=dom-TextTrackCue>Constructor</a>(in DOMString id, in double startTime, in double endTime, in DOMString text, in optional DOMString settings, in optional boolean pauseOnExit)]
<!--TTVTT-->
-interface <dfn id=timedtrackcue>TimedTrackCue</dfn> {
- readonly attribute <a href=#timedtrack>TimedTrack</a> <a href=#dom-timedtrackcue-track title=dom-TimedTrackCue-track>track</a>;
- readonly attribute DOMString <a href=#dom-timedtrackcue-id title=dom-TimedTrackCue-id>id</a>;
+interface <dfn id=texttrackcue>TextTrackCue</dfn> {
+ readonly attribute <a href=#texttrack>TextTrack</a> <a href=#dom-texttrackcue-track title=dom-TextTrackCue-track>track</a>;
+ readonly attribute DOMString <a href=#dom-texttrackcue-id title=dom-TextTrackCue-id>id</a>;
- readonly attribute double <a href=#dom-timedtrackcue-starttime title=dom-TimedTrackCue-startTime>startTime</a>;
- readonly attribute double <a href=#dom-timedtrackcue-endtime title=dom-TimedTrackCue-endTime>endTime</a>;
- readonly attribute boolean <a href=#dom-timedtrackcue-pauseonexit title=dom-TimedTrackCue-pauseOnExit>pauseOnExit</a>;
+ readonly attribute double <a href=#dom-texttrackcue-starttime title=dom-TextTrackCue-startTime>startTime</a>;
+ readonly attribute double <a href=#dom-texttrackcue-endtime title=dom-TextTrackCue-endTime>endTime</a>;
+ readonly attribute boolean <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a>;
<!--TTVTT-->
- readonly attribute DOMString <a href=#dom-timedtrackcue-direction title=dom-TimedTrackCue-direction>direction</a>;
- readonly attribute boolean <a href=#dom-timedtrackcue-snaptolines title=dom-TimedTrackCue-snapToLines>snapToLines</a>;
- readonly attribute long <a href=#dom-timedtrackcue-lineposition title=dom-TimedTrackCue-linePosition>linePosition</a>;
- readonly attribute long <a href=#dom-timedtrackcue-textposition title=dom-TimedTrackCue-textPosition>textPosition</a>;
- readonly attribute long <a href=#dom-timedtrackcue-size title=dom-TimedTrackCue-size>size</a>;
- readonly attribute DOMString <a href=#dom-timedtrackcue-alignment title=dom-TimedTrackCue-alignment>alignment</a>;
+ readonly attribute DOMString <a href=#dom-texttrackcue-direction title=dom-TextTrackCue-direction>direction</a>;
+ readonly attribute boolean <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a>;
+ readonly attribute long <a href=#dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition>linePosition</a>;
+ readonly attribute long <a href=#dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition>textPosition</a>;
+ readonly attribute long <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a>;
+ readonly attribute DOMString <a href=#dom-texttrackcue-alignment title=dom-TextTrackCue-alignment>alignment</a>;
<!--TTVTT-->
- DOMString <a href=#dom-timedtrackcue-getcueassource() title=dom-TimedTrackCue-getCueAsSource()>getCueAsSource</a>();
- <a href=#documentfragment>DocumentFragment</a> <a href=#dom-timedtrackcue-getcueashtml() title=dom-TimedTrackCue-getCueAsHTML()>getCueAsHTML</a>();
+ DOMString <a href=#dom-texttrackcue-getcueassource title=dom-TextTrackCue-getCueAsSource>getCueAsSource</a>();
+ <a href=#documentfragment>DocumentFragment</a> <a href=#dom-texttrackcue-getcueashtml title=dom-TextTrackCue-getCueAsHTML>getCueAsHTML</a>();
- readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrackcue-onenter title=handler-TimedTrackCue-onenter>onenter</a>;
- readonly attribute <a href=#function>Function</a> <a href=#handler-timedtrackcue-onexit title=handler-TimedTrackCue-onexit>onexit</a>;
+ readonly attribute <a href=#function>Function</a> <a href=#handler-texttrackcue-onenter title=handler-TextTrackCue-onenter>onenter</a>;
+ readonly attribute <a href=#function>Function</a> <a href=#handler-texttrackcue-onexit title=handler-TextTrackCue-onexit>onexit</a>;
};</pre>
- <dl class=domintro><!--TTVTT--><dt><var title="">cue</var> = new <code title=dom-TimedTrackCue><a href=#dom-timedtrackcue>TimedTrackCue</a></code>( <var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var> [, <var title="">settings</var> [, <var title="">pauseOnExit</var> ] ] )</dt>
+ <dl class=domintro><!--TTVTT--><dt><var title="">cue</var> = new <code title=dom-TextTrackCue><a href=#dom-texttrackcue>TextTrackCue</a></code>( <var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var> [, <var title="">settings</var> [, <var title="">pauseOnExit</var> ] ] )</dt>
<dd>
- <p>Returns a new <code><a href=#timedtrackcue>TimedTrackCue</a></code> object, for use with the <code title=dom-MutableTimedTrack-addCue><a href=#dom-mutabletimedtrack-addcue>addCue()</a></code> method.</p>
- <p>The <var title="">id</var> argument sets the <a href=#timed-track-cue-identifier>timed track cue identifier</a>.</p>
- <p>The <var title="">startTime</var> argument sets the <a href=#timed-track-cue-start-time>timed track cue start time</a>.</p>
- <p>The <var title="">endTime</var> argument sets the <a href=#timed-track-cue-end-time>timed track cue end time</a>.</p>
- <p>The <var title="">text</var> argument sets the <a href=#timed-track-cue-text>timed track cue text</a>.</p>
+ <p>Returns a new <code><a href=#texttrackcue>TextTrackCue</a></code> object, for use with the <code title=dom-MutableTextTrack-addCue><a href=#dom-mutabletexttrack-addcue>addCue()</a></code> method.</p>
+ <p>The <var title="">id</var> argument sets the <a href=#text-track-cue-identifier>text track cue identifier</a>.</p>
+ <p>The <var title="">startTime</var> argument sets the <a href=#text-track-cue-start-time>text track cue start time</a>.</p>
+ <p>The <var title="">endTime</var> argument sets the <a href=#text-track-cue-end-time>text track cue end time</a>.</p>
+ <p>The <var title="">text</var> argument sets the <a href=#text-track-cue-text>text track cue text</a>.</p>
<p>The <var title="">settings</var> argument is a string in the format of <a href=#webvtt-cue-settings>WebVTT cue settings</a>. If omitted, the empty string is assumed.</p>
- <p>The <var title="">pauseOnExit</var> argument sets the <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit flag</a>. If omitted, false is assumed.</p>
+ <p>The <var title="">pauseOnExit</var> argument sets the <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit flag</a>. If omitted, false is assumed.</p>
</dd>
<!--TTVTT-->
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-track title=dom-TimedTrackCue-track>track</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-track title=dom-TextTrackCue-track>track</a></dt>
<dd>
- <p>Returns the <code><a href=#timedtrack>TimedTrack</a></code> object to which this
- <a href=#timed-track-cue>timed track cue</a> belongs, if any, or null
+ <p>Returns the <code><a href=#texttrack>TextTrack</a></code> object to which this
+ <a href=#text-track-cue>text track cue</a> belongs, if any, or null
otherwise.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-id title=dom-TimedTrackCue-id>id</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-id title=dom-TextTrackCue-id>id</a></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-identifier>timed track cue identifier</a>.</p>
+ <p>Returns the <a href=#text-track-cue-identifier>text track cue identifier</a>.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-starttime title=dom-TimedTrackCue-startTime>startTime</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-starttime title=dom-TextTrackCue-startTime>startTime</a></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-start-time>timed track cue start time</a>, in seconds.</p>
+ <p>Returns the <a href=#text-track-cue-start-time>text track cue start time</a>, in seconds.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-endtime title=dom-TimedTrackCue-endTime>endTime</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-endtime title=dom-TextTrackCue-endTime>endTime</a></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-end-time>timed track cue end time</a>, in seconds.</p>
+ <p>Returns the <a href=#text-track-cue-end-time>text track cue end time</a>, in seconds.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-pauseonexit title=dom-TimedTrackCue-pauseOnExit>pauseOnExit</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit>pauseOnExit</a></dt>
<dd>
- <p>Returns true if the <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit flag</a> is set, false otherwise.</p>
+ <p>Returns true if the <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit flag</a> is set, false otherwise.</p>
</dd>
<!--TTVTT-->
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-direction title=dom-TimedTrackCue-direction>direction</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-direction title=dom-TextTrackCue-direction>direction</a></dt>
<dd>
- <p>Returns a string representing the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a>, as follows:</p>
- <dl class=switch><dt>If it is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a></dt>
+ <p>Returns a string representing the <a href=#text-track-cue-writing-direction>text track cue writing direction</a>, as follows:</p>
+ <dl class=switch><dt>If it is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a></dt>
<dd><p>The string "<code title="">horizontal</code>".</dd>
- <dt>If it is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a></dt>
+ <dt>If it is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a></dt>
<dd><p>The string "<code title="">vertical</code>".</dd>
- <dt>If it is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a></dt>
+ <dt>If it is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a></dt>
<dd><p>The string "<code title="">vertical-lr</code>".</dd>
</dl></dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-snaptolines title=dom-TimedTrackCue-snapToLines>snapToLines</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines>snapToLines</a></dt>
<dd>
- <p>Returns true if the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is set, false otherwise.</p>
+ <p>Returns true if the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is set, false otherwise.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-lineposition title=dom-TimedTrackCue-linePosition>linePosition</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition>linePosition</a></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-line-position>timed track cue line position</a>. In the
- case of the value being <a href=#timed-track-cue-automatic-line-position title="timed track cue automatic
+ <p>Returns the <a href=#text-track-cue-line-position>text track cue line position</a>. In the
+ case of the value being <a href=#text-track-cue-automatic-line-position title="text track cue automatic
line position">auto</a>, the appropriate default is returned.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-textposition title=dom-TimedTrackCue-textPosition>textPosition</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition>textPosition</a></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-text-position>timed track cue text position</a>.</p>
+ <p>Returns the <a href=#text-track-cue-text-position>text track cue text position</a>.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-size title=dom-TimedTrackCue-size>size</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-size title=dom-TextTrackCue-size>size</a></dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-size>timed track cue size</a>.</p>
+ <p>Returns the <a href=#text-track-cue-size>text track cue size</a>.</p>
</dd>
- <dt><var title="">cue</var> . <a href=#dom-timedtrackcue-alignment title=dom-TimedTrackCue-alignment>alignment</a></dt>
+ <dt><var title="">cue</var> . <a href=#dom-texttrackcue-alignment title=dom-TextTrackCue-alignment>alignment</a></dt>
<dd>
- <p>Returns a string representing the <a href=#timed-track-cue-alignment>timed track cue alignment</a>, as follows:</p>
- <dl class=switch><dt>If it is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start alignment</a></dt>
+ <p>Returns a string representing the <a href=#text-track-cue-alignment>text track cue alignment</a>, as follows:</p>
+ <dl class=switch><dt>If it is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start alignment</a></dt>
<dd><p>The string "<code title="">start</code>".</dd>
- <dt>If it is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle alignment</a></dt>
+ <dt>If it is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle alignment</a></dt>
<dd><p>The string "<code title="">middle</code>".</dd>
- <dt>If it is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end alignment</a></dt>
+ <dt>If it is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end alignment</a></dt>
<dd><p>The string "<code title="">end</code>".</dd>
</dl></dd>
<!--TTVTT-->
- <dt><var title="">source</var> = <var title="">cue</var> . <span title=dom-TimedTrackCue-getCueAsSource>getCueAsSource</span>()</dt>
+ <dt><var title="">source</var> = <var title="">cue</var> . <a href=#dom-texttrackcue-getcueassource title=dom-TextTrackCue-getCueAsSource>getCueAsSource</a>()</dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-text>timed track cue text</a> in raw unparsed form.</p>
+ <p>Returns the <a href=#text-track-cue-text>text track cue text</a> in raw unparsed form.</p>
</dd>
- <dt><var title="">fragment</var> = <var title="">cue</var> . <span title=dom-TimedTrackCue-getCueAsHTML>getCueAsHTML</span>()</dt>
+ <dt><var title="">fragment</var> = <var title="">cue</var> . <a href=#dom-texttrackcue-getcueashtml title=dom-TextTrackCue-getCueAsHTML>getCueAsHTML</a>()</dt>
<dd>
- <p>Returns the <a href=#timed-track-cue-text>timed track cue text</a> as a <code><a href=#documentfragment>DocumentFragment</a></code> of <a href=#html-elements>HTML elements</a> and other DOM nodes.</p>
+ <p>Returns the <a href=#text-track-cue-text>text track cue text</a> as a <code><a href=#documentfragment>DocumentFragment</a></code> of <a href=#html-elements>HTML elements</a> and other DOM nodes.</p>
</dd>
</dl><div class=impl>
<!--TTVTT-->
- <p>The <dfn id=dom-timedtrackcue title=dom-TimedTrackCue><code>TimedTrackCue(<var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var>, <var title="">settings</var>, <var title="">pauseOnExit</var>)</code></dfn> constructor, when invoked,
+ <p>The <dfn id=dom-texttrackcue title=dom-TextTrackCue><code>TextTrackCue(<var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var>, <var title="">settings</var>, <var title="">pauseOnExit</var>)</code></dfn> constructor, when invoked,
must run the following steps:</p>
- <ol><li><p>Create a new <a href=#timed-track-cue>timed track cue</a> that is not
- associated with any <a href=#timed-track>timed track</a>. Let <var title="">cue</var> be that <a href=#timed-track-cue>timed track cue</a>.</li>
+ <ol><li><p>Create a new <a href=#text-track-cue>text track cue</a> that is not
+ associated with any <a href=#text-track>text track</a>. Let <var title="">cue</var> be that <a href=#text-track-cue>text track cue</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-identifier>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-identifier>text track cue
identifier</a> be the value of the <var title="">id</var>
argument.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-start-time>timed track cue start
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-start-time>text track cue start
time</a> be the value of the <var title="">startTime</var>
argument, interpreted as a time in seconds.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-end-time>timed track cue end
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-end-time>text track cue end
time</a> be the value of the <var title="">endTime</var>
argument, interpreted as a time in seconds.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-pause-on-exit-flag>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-pause-on-exit-flag>text track cue
pause-on-exit flag</a> be true if the <var title="">pauseOnExit</var> is present and true. Otherwise, let it
be false.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-text>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-text>text track cue
text</a> be the value of the <var title="">text</var> argument,
and let the rules for its interpretation be the <a href=#webvtt-cue-text-parsing-rules>WebVTT cue
text parsing rules</a>, the <a href=#webvtt-cue-text-rendering-rules>WebVTT cue text rendering
@@ -28890,25 +28888,25 @@
<!-- default settings -->
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-writing-direction>timed track cue
- writing direction</a> be <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-writing-direction>text track cue
+ writing direction</a> be <a href=#text-track-cue-horizontal-writing-direction title="text track cue
horizontal writing direction">horizontal</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-snap-to-lines-flag>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-snap-to-lines-flag>text track cue
snap-to-lines flag</a> be true.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-line-position>timed track cue line
- position</a> be <a href=#timed-track-cue-automatic-line-position title="timed track cue automatic line
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-line-position>text track cue line
+ position</a> be <a href=#text-track-cue-automatic-line-position title="text track cue automatic line
position">auto</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-text-position>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-text-position>text track cue
text position</a> be 50.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-size>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-size>text track cue
size</a> be 100.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-alignment>timed track cue
- alignment</a> be <a href=#timed-track-cue-middle-alignment title="timed track cue middle
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-alignment>text track cue
+ alignment</a> be <a href=#text-track-cue-middle-alignment title="text track cue middle
alignment">middle alignment</a>.</li>
<li><p>Let <var title="">input</var> be the string given by the
@@ -28919,100 +28917,100 @@
<li><p><a href=#parse-the-webvtt-settings>Parse the WebVTT settings</a> for <var title="">cue</var>.</li>
- <li><p>Return the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object representing
+ <li><p>Return the <code><a href=#texttrackcue>TextTrackCue</a></code> object representing
<var title="">cue</var>.</li>
- </ol><!--TTVTT--><p>The <dfn id=dom-timedtrackcue-track title=dom-TimedTrackCue-track><code>track</code></dfn>
- attribute must return the <code><a href=#timedtrack>TimedTrack</a></code> object of the
- <a href=#timed-track>timed track</a> with which the <a href=#timed-track-cue>timed track cue</a>
- that the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents is associated,
+ </ol><!--TTVTT--><p>The <dfn id=dom-texttrackcue-track title=dom-TextTrackCue-track><code>track</code></dfn>
+ attribute must return the <code><a href=#texttrack>TextTrack</a></code> object of the
+ <a href=#text-track>text track</a> with which the <a href=#text-track-cue>text track cue</a>
+ that the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is associated,
if any; or null otherwise.</p>
- <p>The <dfn id=dom-timedtrackcue-id title=dom-TimedTrackCue-id><code>id</code></dfn>
- attribute must return the <a href=#timed-track-cue-identifier>timed track cue identifier</a> of
- the <a href=#timed-track-cue>timed track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code>
+ <p>The <dfn id=dom-texttrackcue-id title=dom-TextTrackCue-id><code>id</code></dfn>
+ attribute must return the <a href=#text-track-cue-identifier>text track cue identifier</a> of
+ the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
object represents.</p>
- <p>The <dfn id=dom-timedtrackcue-starttime title=dom-TimedTrackCue-startTime><code>startTime</code></dfn>
- attribute must return the <a href=#timed-track-cue-start-time>timed track cue start time</a> of
- the <a href=#timed-track-cue>timed track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code>
+ <p>The <dfn id=dom-texttrackcue-starttime title=dom-TextTrackCue-startTime><code>startTime</code></dfn>
+ attribute must return the <a href=#text-track-cue-start-time>text track cue start time</a> of
+ the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
object represents, in seconds.</p>
- <p>The <dfn id=dom-timedtrackcue-endtime title=dom-TimedTrackCue-endTime><code>endTime</code></dfn>
- attribute must return the <a href=#timed-track-cue-end-time>timed track cue end time</a> of
- the <a href=#timed-track-cue>timed track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code>
+ <p>The <dfn id=dom-texttrackcue-endtime title=dom-TextTrackCue-endTime><code>endTime</code></dfn>
+ attribute must return the <a href=#text-track-cue-end-time>text track cue end time</a> of
+ the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
object represents, in seconds.</p>
- <p>The <dfn id=dom-timedtrackcue-pauseonexit title=dom-TimedTrackCue-pauseOnExit><code>pauseOnExit</code></dfn>
- attribute must return true if the <a href=#timed-track-cue-pause-on-exit-flag>timed track cue
- pause-on-exit flag</a> of the <a href=#timed-track-cue>timed track cue</a> that
- the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents is set; or false
+ <p>The <dfn id=dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit><code>pauseOnExit</code></dfn>
+ attribute must return true if the <a href=#text-track-cue-pause-on-exit-flag>text track cue
+ pause-on-exit flag</a> of the <a href=#text-track-cue>text track cue</a> that
+ the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is set; or false
otherwise.</p>
- <p>The <dfn id=dom-timedtrackcue-direction title=dom-TimedTrackCue-direction><code>direction</code></dfn>
- attribute must return the <a href=#timed-track-cue-writing-direction>timed track cue writing
- direction</a> of the <a href=#timed-track-cue>timed track cue</a> that the
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents.</p>
+ <p>The <dfn id=dom-texttrackcue-direction title=dom-TextTrackCue-direction><code>direction</code></dfn>
+ attribute must return the <a href=#text-track-cue-writing-direction>text track cue writing
+ direction</a> of the <a href=#text-track-cue>text track cue</a> that the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object represents.</p>
<!--TTVTT-->
- <p>The <dfn id=dom-timedtrackcue-snaptolines title=dom-TimedTrackCue-snapToLines><code>snapToLines</code></dfn>
- attribute must return true if the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue
- snap-to-lines flag</a> of the <a href=#timed-track-cue>timed track cue</a> that
- the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents is set; or false
+ <p>The <dfn id=dom-texttrackcue-snaptolines title=dom-TextTrackCue-snapToLines><code>snapToLines</code></dfn>
+ attribute must return true if the <a href=#text-track-cue-snap-to-lines-flag>text track cue
+ snap-to-lines flag</a> of the <a href=#text-track-cue>text track cue</a> that
+ the <code><a href=#texttrackcue>TextTrackCue</a></code> object represents is set; or false
otherwise.</p>
- <p>The <dfn id=dom-timedtrackcue-lineposition title=dom-TimedTrackCue-linePosition><code>linePosition</code></dfn>
- attribute must return the <a href=#timed-track-cue-line-position>timed track cue line position</a>
- of the <a href=#timed-track-cue>timed track cue</a> that the
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents, if that value is
- numeric. Otherwise, the value is the special value <a href=#timed-track-cue-automatic-line-position title="timed track cue automatic line position">auto</a>; if the
- <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> of the <a href=#timed-track-cue>timed
- track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object
+ <p>The <dfn id=dom-texttrackcue-lineposition title=dom-TextTrackCue-linePosition><code>linePosition</code></dfn>
+ attribute must return the <a href=#text-track-cue-line-position>text track cue line position</a>
+ of the <a href=#text-track-cue>text track cue</a> that the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object represents, if that value is
+ numeric. Otherwise, the value is the special value <a href=#text-track-cue-automatic-line-position title="text track cue automatic line position">auto</a>; if the
+ <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> of the <a href=#text-track-cue>text
+ track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object
represents is not set, the attribute must return the value 100;
otherwise, it must return the value returned by the following
algorithm:</p>
- <ol><li><p>Let <var title="">cue</var> be the <a href=#timed-track-cue>timed track
- cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object
+ <ol><li><p>Let <var title="">cue</var> be the <a href=#text-track-cue>text track
+ cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code> object
represents.</li>
<li><p>If <var title="">cue</var> is not associated with a
- <a href=#timed-track>timed track</a>, return −1 and abort these
+ <a href=#text-track>text track</a>, return −1 and abort these
steps.</li>
- <li><p>Let <var title="">track</var> be the <a href=#timed-track>timed
+ <li><p>Let <var title="">track</var> be the <a href=#text-track>text
track</a> that the <var title="">cue</var> is associated
with.</li>
- <li><p>Let <var title="">n</var> be the number of <a href=#timed-track title="timed track">timed tracks</a> whose <a href=#timed-track-mode>timed track
- mode</a> is <a href=#timed-track-showing title="timed track showing">showing</a> or
- <a href=#timed-track-showing-by-default title="timed track showing by default">showing by
+ <li><p>Let <var title="">n</var> be the number of <a href=#text-track title="text track">text tracks</a> whose <a href=#text-track-mode>text track
+ mode</a> is <a href=#text-track-showing title="text track showing">showing</a> or
+ <a href=#text-track-showing-by-default title="text track showing by default">showing by
default</a> and that are in the <a href=#media-element>media element</a>'s
- <a href=#list-of-timed-tracks>list of timed tracks</a> before <var title="">track</var>.</li>
+ <a href=#list-of-text-tracks>list of text tracks</a> before <var title="">track</var>.</li>
<li><p>Return <var title="">n</var>.</li>
- </ol><p>The <dfn id=dom-timedtrackcue-textposition title=dom-TimedTrackCue-textPosition><code>textPosition</code></dfn>
- attribute must return the <a href=#timed-track-cue-text-position>timed track cue text position</a>
- of the <a href=#timed-track-cue>timed track cue</a> that the
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents.</p>
+ </ol><p>The <dfn id=dom-texttrackcue-textposition title=dom-TextTrackCue-textPosition><code>textPosition</code></dfn>
+ attribute must return the <a href=#text-track-cue-text-position>text track cue text position</a>
+ of the <a href=#text-track-cue>text track cue</a> that the
+ <code><a href=#texttrackcue>TextTrackCue</a></code> object represents.</p>
- <p>The <dfn id=dom-timedtrackcue-size title=dom-TimedTrackCue-size><code>size</code></dfn>
- attribute must return the <a href=#timed-track-cue-size>timed track cue size</a> of the
- <a href=#timed-track-cue>timed track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code>
+ <p>The <dfn id=dom-texttrackcue-size title=dom-TextTrackCue-size><code>size</code></dfn>
+ attribute must return the <a href=#text-track-cue-size>text track cue size</a> of the
+ <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
object represents.</p>
- <p>The <dfn id=dom-timedtrackcue-alignment title=dom-TimedTrackCue-alignment><code>alignment</code></dfn>
- attribute must return the <a href=#timed-track-cue-alignment>timed track cue alignment</a> of
- the <a href=#timed-track-cue>timed track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code>
+ <p>The <dfn id=dom-texttrackcue-alignment title=dom-TextTrackCue-alignment><code>alignment</code></dfn>
+ attribute must return the <a href=#text-track-cue-alignment>text track cue alignment</a> of
+ the <a href=#text-track-cue>text track cue</a> that the <code><a href=#texttrackcue>TextTrackCue</a></code>
object represents.</p>
<!--TTVTT-->
- <p>The <dfn id=dom-timedtrackcue-getcueassource() title=dom-TimedTrackCue-getCueAsSource()><code>getCueAsSource()</code></dfn>
- method must return the raw <a href=#timed-track-cue-text>timed track cue text</a>.</p>
+ <p>The <dfn id=dom-texttrackcue-getcueassource title=dom-TextTrackCue-getCueAsSource><code>getCueAsSource()</code></dfn>
+ method must return the raw <a href=#text-track-cue-text>text track cue text</a>.</p>
- <p>The <dfn id=dom-timedtrackcue-getcueashtml() title=dom-TimedTrackCue-getCueAsHTML()><code>getCueAsHTML()</code></dfn>
- method must convert the <a href=#timed-track-cue-text>timed track cue text</a> to a
+ <p>The <dfn id=dom-texttrackcue-getcueashtml title=dom-TextTrackCue-getCueAsHTML><code>getCueAsHTML()</code></dfn>
+ method must convert the <a href=#text-track-cue-text>text track cue text</a> to a
<code><a href=#documentfragment>DocumentFragment</a></code> for the <a href=#media-element>media element</a>'s
<code><a href=#document>Document</a></code>, using the appropriate rules for doing
so.
@@ -29032,19 +29030,19 @@
<p>The following are the <a href=#event-handlers>event handlers</a> that must be
supported, as IDL attributes, by all objects implementing the
- <code><a href=#timedtrack>TimedTrack</a></code> interface:</p>
+ <code><a href=#texttrack>TextTrack</a></code> interface:</p>
<table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
- <tbody><tr><td><dfn id=handler-timedtrack-onload title=handler-TimedTrack-onload><code>onload</code></dfn> <td> <code title=event-load>load</code>
- <tr><td><dfn id=handler-timedtrack-onerror title=handler-TimedTrack-onerror><code>onerror</code></dfn> <td> <code title=event-error>error</code>
- <tr><td><dfn id=handler-timedtrack-oncuechange title=handler-TimedTrack-oncuechange><code>oncuechange</code></dfn> <td> <code title=event-cuechange>cuechange</code>
+ <tbody><tr><td><dfn id=handler-texttrack-onload title=handler-TextTrack-onload><code>onload</code></dfn> <td> <code title=event-load>load</code>
+ <tr><td><dfn id=handler-texttrack-onerror title=handler-TextTrack-onerror><code>onerror</code></dfn> <td> <code title=event-error>error</code>
+ <tr><td><dfn id=handler-texttrack-oncuechange title=handler-TextTrack-oncuechange><code>oncuechange</code></dfn> <td> <code title=event-cuechange>cuechange</code>
</table><p>The following are the <a href=#event-handlers>event handlers</a> that must be
supported, as IDL attributes, by all objects implementing the
- <code><a href=#timedtrackcue>TimedTrackCue</a></code> interface:</p>
+ <code><a href=#texttrackcue>TextTrackCue</a></code> interface:</p>
<table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
- <tbody><tr><td><dfn id=handler-timedtrackcue-onenter title=handler-TimedTrackCue-onenter><code>onenter</code></dfn> <td> <code title=event-enter>enter</code>
- <tr><td><dfn id=handler-timedtrackcue-onexit title=handler-TimedTrackCue-onexit><code>onexit</code></dfn> <td> <code title=event-exit>exit</code>
+ <tbody><tr><td><dfn id=handler-texttrackcue-onenter title=handler-TextTrackCue-onenter><code>onenter</code></dfn> <td> <code title=event-enter>enter</code>
+ <tr><td><dfn id=handler-texttrackcue-onexit title=handler-TextTrackCue-onexit><code>onexit</code></dfn> <td> <code title=event-exit>exit</code>
</table></div>
<!--KEEP-START w3c-html--><!--TT-->
@@ -29052,8 +29050,8 @@
<h5 id=webvtt-0><span class=secno>4.8.10.11 </span>WebVTT</h5>
- <p>The <dfn id=webvtt>WebVTT</dfn> format (Web Subtitle Resource Tracks) is a
- format intended for marking up external timed track resources.</p>
+ <p>The <dfn id=webvtt>WebVTT</dfn> format (Web Video Text Tracks) is a
+ format intended for marking up external text track resources.</p>
<h6 id=syntax-0><span class=secno>4.8.10.11.1 </span>Syntax</h6>
@@ -29100,7 +29098,7 @@
validating <a href=#webvtt>WebVTT</a> files, may offer to restrict all cues
to only having <a href=#webvtt-cue-text>WebVTT cue text</a> as their <a href=#cue-payload>cue
payload</a>; <a href=#webvtt-metadata-text>WebVTT metadata text</a> cues are only
- useful for scripted applications (using the <code title=dom-timedtrack-kind-metadata><a href=#dom-timedtrack-kind-metadata>metadata</a></code> <a href=#timed-track-kind>timed
+ useful for scripted applications (using the <code title=dom-timedtrack-kind-metadata>metadata</code> <a href=#text-track-kind>text
track kind</a>).</p>
<p>A <a href=#webvtt-file>WebVTT file</a> whose cues all have a <a href=#cue-payload>cue
@@ -29411,12 +29409,12 @@
<h6 id=parsing-0><span class=secno>4.8.10.11.2 </span>Parsing</h6>
<p>A <dfn id=webvtt-parser>WebVTT parser</dfn>, given an input byte stream and a
- <a href=#timed-track-list-of-cues>timed track list of cues</a> <var title="">output</var>,
+ <a href=#text-track-list-of-cues>text track list of cues</a> <var title="">output</var>,
must <a href=#decoded-as-utf-8,-with-error-handling title="decoded as UTF-8, with error handling">decode the
byte stream as UTF-8, with error handling</a>, and then must
parse the resulting string according to the <a href=#webvtt-parser-algorithm>WebVTT parser
- algorithm</a> below. This results in <a href=#timed-track-cue title="timed track
- cue">timed track cues</a> being added to <var title="">output</var>. <a href=#refsRFC3629>[RFC3629]</a></p>
+ algorithm</a> below. This results in <a href=#text-track-cue title="text track
+ cue">text track cues</a> being added to <var title="">output</var>. <a href=#refsRFC3629>[RFC3629]</a></p>
<p>A <a href=#webvtt-parser>WebVTT parser</a>, specifically its conversion and
parsing steps, is typically run asynchronously, with the input byte
@@ -29513,38 +29511,38 @@
characters</a> that are either U+000D CARRIAGE RETURN (CR) or
U+000A LINE FEED (LF) characters.</li>
- <li><p>Let <var title="">cue</var> be a new <a href=#timed-track-cue>timed track
- cue</a> associated with <var title="">output</var>'s <a href=#timed-track>timed
+ <li><p>Let <var title="">cue</var> be a new <a href=#text-track-cue>text track
+ cue</a> associated with <var title="">output</var>'s <a href=#text-track>text
track</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-identifier>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-identifier>text track cue
identifier</a> be the empty string.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-pause-on-exit-flag>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-pause-on-exit-flag>text track cue
pause-on-exit flag</a> be false.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-writing-direction>timed track cue
- writing direction</a> be <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-writing-direction>text track cue
+ writing direction</a> be <a href=#text-track-cue-horizontal-writing-direction title="text track cue
horizontal writing direction">horizontal</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-snap-to-lines-flag>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-snap-to-lines-flag>text track cue
snap-to-lines flag</a> be true.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-line-position>timed track cue line
- position</a> be <a href=#timed-track-cue-automatic-line-position title="timed track cue automatic line
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-line-position>text track cue line
+ position</a> be <a href=#text-track-cue-automatic-line-position title="text track cue automatic line
position">auto</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-text-position>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-text-position>text track cue
text position</a> be 50.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-size>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-size>text track cue
size</a> be 100.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-alignment>timed track cue
- alignment</a> be <a href=#timed-track-cue-middle-alignment title="timed track cue middle
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-alignment>text track cue
+ alignment</a> be <a href=#text-track-cue-middle-alignment title="text track cue middle
alignment">middle alignment</a>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-text>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-text>text track cue
text</a> be the empty string.</li>
<li><p><a href=#collect-a-sequence-of-characters>Collect a sequence of characters</a> that are
@@ -29561,7 +29559,7 @@
HYPHEN-MINUS, U+003E GREATER-THAN SIGN), then jump to the step
labeled <i>timings</i> below.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-identifier>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-identifier>text track cue
identifier</a> be <var title="">line</var>.<p></li>
<li><p>If <var title="">position</var> is past the end of <var title="">input</var>, then discard <var title="">cue</var> and jump
@@ -29622,14 +29620,14 @@
<li><p>Return to the step labeled <i>cue text loop</i>.</li>
- <li><p><i>Cue text processing</i>: Let the <a href=#timed-track-cue-text>timed track cue
+ <li><p><i>Cue text processing</i>: Let the <a href=#text-track-cue-text>text track cue
text</a> of <var title="">cue</var> be <var title="">cue
text</var>, and let the rules for its interpretation be the
<a href=#webvtt-cue-text-parsing-rules>WebVTT cue text parsing rules</a>, the <a href=#webvtt-cue-text-rendering-rules>WebVTT cue
text rendering rules</a>, and the <a href=#webvtt-cue-text-dom-construction-rules>WebVTT cue text DOM
construction rules</a>.</li>
- <li><p>Add <var title="">cue</var> to the <a href=#timed-track-list-of-cues>timed track list of
+ <li><p>Add <var title="">cue</var> to the <a href=#text-track-list-of-cues>text track list of
cues</a> <var title="">output</var>.</li>
<li><p>Jump to the step labeled <i>cue loop</i>.</li>
@@ -29667,7 +29665,7 @@
</ol><p>When the algorithm above requires that the user agent
<dfn id=collect-webvtt-cue-timings-and-settings>collect WebVTT cue timings and settings</dfn> from a string
- <var title="">input</var> for a <a href=#timed-track-cue>timed track cue</a> <var title="">cue</var>, the user agent must run the following
+ <var title="">input</var> for a <a href=#text-track-cue>text track cue</a> <var title="">cue</var>, the user agent must run the following
algorithm.</p>
<ol><li><p>Let <var title="">input</var> be the string being
@@ -29680,7 +29678,7 @@
<li><p><a href=#collect-a-webvtt-timestamp>Collect a WebVTT timestamp</a>. If that algorithm
fails, then abort these steps and return failure. Otherwise, let
- <var title="">cue</var>'s <a href=#timed-track-cue-start-time>timed track cue start time</a>
+ <var title="">cue</var>'s <a href=#text-track-cue-start-time>text track cue start time</a>
be the collected time.</li>
<li><p><a href=#skip-whitespace>Skip whitespace</a>.</li>
@@ -29705,7 +29703,7 @@
<li><p><a href=#collect-a-webvtt-timestamp>Collect a WebVTT timestamp</a>. If that algorithm
fails, then abort these steps and return failure. Otherwise, let
- <var title="">cue</var>'s <a href=#timed-track-cue-end-time>timed track cue end time</a>
+ <var title="">cue</var>'s <a href=#text-track-cue-end-time>text track cue end time</a>
be the collected time.</li>
<li><p><a href=#skip-whitespace>Skip whitespace</a>.</li>
@@ -29713,7 +29711,7 @@
<li><p><a href=#parse-the-webvtt-settings>Parse the WebVTT settings</a> for <var title="">cue</var>.</li>
</ol><p>When the user agent is to <dfn id=parse-the-webvtt-settings>parse the WebVTT settings</dfn>
- for a <a href=#timed-track-cue>timed track cue</a> <var title="">cue</var>, the
+ for a <a href=#text-track-cue>text track cue</a> <var title="">cue</var>, the
user agent must run the following steps:</p>
<ol><li><p>Let <var title="">input</var> and <var title="">position</var> be the same variables as those of the same
@@ -29752,12 +29750,12 @@
<li><p>If <var title="">value</var> is a
<a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">vertical</code>", then let <var title="">cue</var>'s
- <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> be <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing
+ <a href=#text-track-cue-writing-direction>text track cue writing direction</a> be <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing
direction">vertical growing left</a>.</li>
<li><p>Otherwise, if <var title="">value</var> is a
- <a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">vertical-lr</code>", then let <var title="">cue</var>'s <a href=#timed-track-cue-writing-direction>timed track cue writing
- direction</a> be <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical
+ <a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">vertical-lr</code>", then let <var title="">cue</var>'s <a href=#text-track-cue-writing-direction>text track cue writing
+ direction</a> be <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical
growing right writing direction">vertical growing
right</a>.</li>
@@ -29798,7 +29796,7 @@
<i>settings</i>.</li>
<li><p>If the last character in <var title="">value</var> is a
- U+0025 PERCENT SIGN character (%), then let <var title="">cue</var>'s <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines
+ U+0025 PERCENT SIGN character (%), then let <var title="">cue</var>'s <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines
flag</a> to true.</li>
<li><p>Ignoring the trailing percent sign, if any, interpret
@@ -29809,7 +29807,7 @@
the range 0 ≤ <var title="">number</var> ≤ 100, then jump back to the
step labeled <i>settings</i>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-line-position>timed track cue line
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-line-position>text track cue line
position</a> be <var title="">number</var>.</li>
</ol></dd>
@@ -29849,7 +29847,7 @@
0 ≤ <var title="">number</var> ≤ 100,
then jump back to the step labeled <i>settings</i>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-text-position>timed track cue text
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-text-position>text track cue text
position</a> be <var title="">number</var>.</li>
</ol></dd>
@@ -29889,7 +29887,7 @@
0 ≤ <var title="">number</var> ≤ 100,
then jump back to the step labeled <i>settings</i>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-size>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-size>text track cue
size</a> be <var title="">number</var>.</li>
</ol></dd>
@@ -29905,17 +29903,17 @@
<li><p>If <var title="">value</var> is a
<a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">start</code>", then let <var title="">cue</var>'s
- <a href=#timed-track-cue-alignment>timed track cue alignment</a> be <a href=#timed-track-cue-start-alignment title="timed
+ <a href=#text-track-cue-alignment>text track cue alignment</a> be <a href=#text-track-cue-start-alignment title="text
track cue start alignment">start alignment</a>.</li>
<li><p>If <var title="">value</var> is a
<a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">middle</code>", then let <var title="">cue</var>'s
- <a href=#timed-track-cue-alignment>timed track cue alignment</a> be <a href=#timed-track-cue-middle-alignment title="timed
+ <a href=#text-track-cue-alignment>text track cue alignment</a> be <a href=#text-track-cue-middle-alignment title="text
track cue middle alignment">middle alignment</a>.</li>
<li><p>If <var title="">value</var> is a
<a href=#case-sensitive>case-sensitive</a> match for the string "<code title="">end</code>", then let <var title="">cue</var>'s
- <a href=#timed-track-cue-alignment>timed track cue alignment</a> be <a href=#timed-track-cue-end-alignment title="timed
+ <a href=#text-track-cue-alignment>text track cue alignment</a> be <a href=#text-track-cue-end-alignment title="text
track cue end alignment">end alignment</a>.</li>
</ol></dd>
@@ -30707,7 +30705,7 @@
<p>Where possible (specifically, for starting, stopping, pausing,
and unpausing playback, for seeking,
<!--KEEP-END w3c-html--><!--TT-->
- for listing, enabling, and disabling timed tracks,
+ for listing, enabling, and disabling text tracks,
<!--KEEP-START w3c-html--><!--TT-->
and for muting or changing the volume of the audio), user interface
features exposed by the user agent must be implemented in terms of
@@ -30716,14 +30714,14 @@
<!--KEEP-END w3c-html--><!--TT-->
<p>For the purposes of listing chapters in the <a href=#media-resource>media
- resource</a>, only <a href=#timed-track title="timed track">timed tracks</a>
- in the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed
- tracks</a> <a href=#timed-track-showing title="timed track showing">showing</a> or
- <a href=#timed-track-showing-by-default title="timed track showing by default">showing by
- default</a> and whose <a href=#timed-track-kind>timed track kind</a> is <code title=dom-timedtrack-kind-chapters><a href=#dom-timedtrack-kind-chapters>chapters</a></code> should be used.
- Each <a href=#timed-track-cue title="timed track cue">cue</a> in such a <a href=#timed-track>timed
- track</a> represents a chapter starting at the cue's <a href=#timed-track-cue-start-time title="timed track cue start time">start time</a>. The name of
- the chapter is the <a href=#timed-track-cue-text>timed track cue text</a>, interpreted
+ resource</a>, only <a href=#text-track title="text track">text tracks</a>
+ in the <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text
+ tracks</a> <a href=#text-track-showing title="text track showing">showing</a> or
+ <a href=#text-track-showing-by-default title="text track showing by default">showing by
+ default</a> and whose <a href=#text-track-kind>text track kind</a> is <code title=dom-timedtrack-kind-chapters>chapters</code> should be used.
+ Each <a href=#text-track-cue title="text track cue">cue</a> in such a <a href=#text-track>text
+ track</a> represents a chapter starting at the cue's <a href=#text-track-cue-start-time title="text track cue start time">start time</a>. The name of
+ the chapter is the <a href=#text-track-cue-text>text track cue text</a>, interpreted
literally.</p>
<!--KEEP-START w3c-html--><!--TT-->
@@ -30987,7 +30985,7 @@
<td><code><a href=#event>Event</a></code>
<td>The user agent has just determined the duration and dimensions of the <a href=#media-resource>media resource</a>
<!--KEEP-END w3c-html--><!--TT-->
- and <a href=#the-timed-tracks-are-ready>the timed tracks are ready</a>.
+ and <a href=#the-text-tracks-are-ready>the text tracks are ready</a>.
<!--KEEP-START w3c-html--><!--TT-->
<td><code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> is newly equal to <code title=dom-media-HAVE_METADATA><a href=#dom-media-have_metadata>HAVE_METADATA</a></code> or greater for the first time.
<tr><td><dfn id=event-media-loadeddata title=event-media-loadeddata><code>loadeddata</code></dfn>
@@ -81257,12 +81255,12 @@
<p>When the user agent starts <a href=#expose-a-user-interface-to-the-user title="expose a user interface
to the user">exposing a user interface</a> for a
- <code><a href=#video>video</a></code> element, user agents should run the <a href=#rules-for-updating-the-timed-track-rendering>rules
- for updating the timed track rendering</a> of each of the <a href=#timed-track title="timed track">timed tracks</a> in the <code><a href=#video>video</a></code>
- element's <a href=#list-of-timed-tracks>list of timed tracks</a> that are <a href=#timed-track-showing title="timed track showing">showing</a> or <a href=#timed-track-showing-by-default title="timed
- track showing by default">showing by default</a> (e.g., for <a href=#timed-track title="timed track">timed tracks</a> based on
- <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the display of
- WebVTT timed tracks</a>).</p>
+ <code><a href=#video>video</a></code> element, user agents should run the <a href=#rules-for-updating-the-text-track-rendering>rules
+ for updating the text track rendering</a> of each of the <a href=#text-track title="text track">text tracks</a> in the <code><a href=#video>video</a></code>
+ element's <a href=#list-of-text-tracks>list of text tracks</a> that are <a href=#text-track-showing title="text track showing">showing</a> or <a href=#text-track-showing-by-default title="text
+ track showing by default">showing by default</a> (e.g., for <a href=#text-track title="text track">text tracks</a> based on
+ <a href=#webvtt>WebVTT</a>, the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the display of
+ WebVTT text tracks</a>).</p>
<!--KEEP-START w3c-html--><!--TT-->
<p class=note>Resizing <code><a href=#video>video</a></code> and <code><a href=#the-canvas-element>canvas</a></code>
@@ -81281,7 +81279,7 @@
<!--<div data-component="other Hixie drafts (editor: Ian Hickson)">-->
<div class=impl>
- <h4 id=timed-tracks><span class=secno>12.3.2 </span>Timed tracks</h4>
+ <h4 id=timed-text-tracks-0><span class=secno>12.3.2 </span>Timed text tracks</h4>
<p class=note>This section is intended to be moved to its own CSS
module once an editor is found to run with it.</p>
@@ -81289,11 +81287,11 @@
<h5 id=webvtt-cue-text-rendering-rules><span class=secno>12.3.2.1 </span><dfn>WebVTT cue text rendering rules</dfn></h5>
- <p>The <dfn id=rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the display of WebVTT timed
- tracks</dfn> render the <a href=#timed-track title="timed track">timed
+ <p>The <dfn id=rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the display of WebVTT text
+ tracks</dfn> render the <a href=#text-track title="text track">text
tracks</a> of a <a href=#media-element>media element</a> (specifically, a
<code><a href=#video>video</a></code> element), or of another playback mechanism, by
- applying the steps below. All the <a href=#timed-track title="timed track">timed
+ applying the steps below. All the <a href=#text-track title="text track">text
tracks</a> that use these rules for a given <a href=#media-element>media
element</a>, or other playback mechanism, are rendered together,
to avoid overlapping subtitles from multiple tracks.</p>
@@ -81325,35 +81323,35 @@
user interface</a> for <var title="">video</var>, but now it is,
let <var title="">reset</var> be true. Otherwise, let <var title="">reset</var> be false.</p>
- <li><p>Let <var title="">tracks</var> be the subset of <var title="">video</var>'s <a href=#list-of-timed-tracks>list of timed tracks</a> that have
- as their <a href=#rules-for-updating-the-timed-track-rendering>rules for updating the timed track rendering</a>
- these <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the display of WebVTT timed
- tracks</a>, and whose <a href=#timed-track-mode>timed track mode</a> is <a href=#timed-track-showing title="timed track showing">showing</a> or <a href=#timed-track-showing-by-default title="timed
+ <li><p>Let <var title="">tracks</var> be the subset of <var title="">video</var>'s <a href=#list-of-text-tracks>list of text tracks</a> that have
+ as their <a href=#rules-for-updating-the-text-track-rendering>rules for updating the text track rendering</a>
+ these <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the display of WebVTT text
+ tracks</a>, and whose <a href=#text-track-mode>text track mode</a> is <a href=#text-track-showing title="text track showing">showing</a> or <a href=#text-track-showing-by-default title="text
track showing by default">showing by default</a>.</li>
- <li><p>Let <var title="">cues</var> be an empty list of <a href=#timed-track-cue title="timed track cue">timed track cues</a>.</li>
+ <li><p>Let <var title="">cues</var> be an empty list of <a href=#text-track-cue title="text track cue">text track cues</a>.</li>
<li><p>For each track <var title="">track</var> in <var title="">tracks</var>, append to <var title="">cues</var> all the
- <a href=#timed-track-cue title="timed track cue">cues</a> from <var title="">track</var>'s <a href=#timed-track-list-of-cues title="timed track list of cues">list
- of cues</a> that have their <a href=#timed-track-cue-active-flag>timed track cue active
+ <a href=#text-track-cue title="text track cue">cues</a> from <var title="">track</var>'s <a href=#text-track-list-of-cues title="text track list of cues">list
+ of cues</a> that have their <a href=#text-track-cue-active-flag>text track cue active
flag</a> set.</li>
<li><p>If <var title="">reset</var> is false, then, for each
- <a href=#timed-track-cue>timed track cue</a> <var title="">cue</var> in <var title="">cues</var>: if <var title="">cue</var>'s <a href=#timed-track-cue-display-state>timed track
+ <a href=#text-track-cue>text track cue</a> <var title="">cue</var> in <var title="">cues</var>: if <var title="">cue</var>'s <a href=#text-track-cue-display-state>text track
cue display state</a> has a set of CSS boxes, then add those
boxes to <var title="">output</var>, and remove <var title="">cue</var> from <var title="">cues</var>.</li>
<li>
- <p>For each <a href=#timed-track-cue>timed track cue</a> <var title="">cue</var>
+ <p>For each <a href=#text-track-cue>text track cue</a> <var title="">cue</var>
in <var title="">cues</var> that has not yet had corresponding CSS
- boxes added to <var title="">output</var>, in <a href=#timed-track-cue-order>timed track
+ boxes added to <var title="">output</var>, in <a href=#text-track-cue-order>text track
cue order</a>, run the following substeps:</p>
<ol><li><p>Let <var title="">nodes</var> be the <a href=#list-of-webvtt-node-objects>list of WebVTT
Node Objects</a> obtained by applying the <a href=#webvtt-cue-text-parsing-rules>WebVTT cue
text parsing rules</a> to the <var title="">cue</var>'s
- <a href=#timed-track-cue-text>timed track cue text</a>.</p>
+ <a href=#text-track-cue-text>text track cue text</a>.</p>
<li>
@@ -81380,14 +81378,14 @@
</li>
- <li><p>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is
- <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing
- direction">horizontal</a>, then let <var title="">block-flow</var> be 'tb'. Otherwise, if the <a href=#timed-track-cue-writing-direction>timed
- track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track
+ <li><p>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is
+ <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing
+ direction">horizontal</a>, then let <var title="">block-flow</var> be 'tb'. Otherwise, if the <a href=#text-track-cue-writing-direction>text
+ track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track
cue vertical growing left writing direction">vertical growing
left</a>, then let <var title="">block-flow</var> be
- 'lr'. Otherwise, the <a href=#timed-track-cue-writing-direction>timed track cue writing
- direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing
+ 'lr'. Otherwise, the <a href=#text-track-cue-writing-direction>text track cue writing
+ direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing
right writing direction">vertical growing right</a>; let <var title="">block-flow</var> be 'rl'.</li>
<li>
@@ -81396,77 +81394,77 @@
<var title="">cue</var> as per the appropriate rules from the
following list:</p>
- <dl class=switch><dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a>,
+ <dl class=switch><dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a>,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a>,
and <var title="">direction</var> is 'rtl'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a></dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a></dt>
<dd>
- <p>Let <var title="">maximum size</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> subtracted from 100.</p>
+ <p>Let <var title="">maximum size</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> subtracted from 100.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a>,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a>,
and <var title="">direction</var> is 'rtl'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a></dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a></dt>
<dd>
- <p>Let <var title="">maximum size</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a>.</p>
+ <p>Let <var title="">maximum size</var> be the <a href=#text-track-cue-text-position>text track cue text position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- the <a href=#timed-track-cue-text-position>timed track cue text position</a> is less than or equal to 50,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ the <a href=#text-track-cue-text-position>text track cue text position</a> is less than or equal to 50,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- the <a href=#timed-track-cue-text-position>timed track cue text position</a> is greater than <!-- or equal to --> 50,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ the <a href=#text-track-cue-text-position>text track cue text position</a> is greater than <!-- or equal to --> 50,
and <var title="">direction</var> is 'rtl'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- and the <a href=#timed-track-cue-text-position>timed track cue text position</a> is less than or equal to 50</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- and the <a href=#timed-track-cue-text-position>timed track cue text position</a> is less than or equal to 50</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ and the <a href=#text-track-cue-text-position>text track cue text position</a> is less than or equal to 50</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ and the <a href=#text-track-cue-text-position>text track cue text position</a> is less than or equal to 50</dt>
<dd>
- <p>Let <var title="">maximum size</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> multiplied by two.</p>
+ <p>Let <var title="">maximum size</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> multiplied by two.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- the <a href=#timed-track-cue-text-position>timed track cue text position</a> is greater than <!-- or equal to --> 50,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ the <a href=#text-track-cue-text-position>text track cue text position</a> is greater than <!-- or equal to --> 50,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- the <a href=#timed-track-cue-text-position>timed track cue text position</a> is less than or equal to 50,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ the <a href=#text-track-cue-text-position>text track cue text position</a> is less than or equal to 50,
and <var title="">direction</var> is 'rtl'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- and the <a href=#timed-track-cue-text-position>timed track cue text position</a> is greater than <!-- or equal to --> 50</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
- and the <a href=#timed-track-cue-text-position>timed track cue text position</a> is greater than <!-- or equal to --> 50</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ and the <a href=#text-track-cue-text-position>text track cue text position</a> is greater than <!-- or equal to --> 50</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
+ and the <a href=#text-track-cue-text-position>text track cue text position</a> is greater than <!-- or equal to --> 50</dt>
<dd>
- <p>Let <var title="">maximum size</var> be the result of subtracting <a href=#timed-track-cue-text-position>timed track cue text position</a> from 100 and then multiplying the result by two.</p>
+ <p>Let <var title="">maximum size</var> be the result of subtracting <a href=#text-track-cue-text-position>text track cue text position</a> from 100 and then multiplying the result by two.</p>
</dd>
</dl></li>
- <li><p>If the <a href=#timed-track-cue-size>timed track cue size</a> is less than <var title="">maximum size</var>, then let <var title="">size</var> be
- <a href=#timed-track-cue-size>timed track cue size</a>. Otherwise, let <var title="">size</var> be <var title="">maximum size</var>.</li>
+ <li><p>If the <a href=#text-track-cue-size>text track cue size</a> is less than <var title="">maximum size</var>, then let <var title="">size</var> be
+ <a href=#text-track-cue-size>text track cue size</a>. Otherwise, let <var title="">size</var> be <var title="">maximum size</var>.</li>
- <li><p>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is
- <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing
+ <li><p>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is
+ <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing
direction">horizontal</a>, then let <var title="">width</var>
be '<var title="">size</var> vw' and <var title="">height</var> be 'auto'. Otherwise, let <var title="">width</var> be 'auto' and <var title="">height</var> be
'<var title="">size</var> vh'. (These are CSS values used
@@ -81478,63 +81476,63 @@
<p>Determine the value of <var title="">x-position</var> or <var title="">y-position</var> for <var title="">cue</var> as per the
appropriate rules from the following list:</p>
- <dl class=switch><dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a>,
+ <dl class=switch><dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a>,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a>,
and <var title="">direction</var> is 'rtl'</dt>
<dd>
- <p>Let <var title="">x-position</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a>.</p>
+ <p>Let <var title="">x-position</var> be the <a href=#text-track-cue-text-position>text track cue text position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a>,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a>,
and <var title="">direction</var> is 'rtl'</dt>
<dd>
- <p>Let <var title="">x-position</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> subtracted from 100.</p>
+ <p>Let <var title="">x-position</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> subtracted from 100.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a></dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-start-alignment title="timed track cue start alignment">start</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-start-alignment title="text track cue start alignment">start</a></dt>
<dd>
- <p>Let <var title="">y-position</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a>.</p>
+ <p>Let <var title="">y-position</var> be the <a href=#text-track-cue-text-position>text track cue text position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a></dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-end-alignment title="timed track cue end alignment">end</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-end-alignment title="text track cue end alignment">end</a></dt>
<dd>
- <p>Let <var title="">y-position</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> subtracted from 100.</p>
+ <p>Let <var title="">y-position</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> subtracted from 100.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
and <var title="">direction</var> is 'ltr'</dt>
<dd>
- <p>Let <var title="">x-position</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> minus half of <var title="">size</var>.</p>
+ <p>Let <var title="">x-position</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> minus half of <var title="">size</var>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a>,
and <var title="">direction</var> is 'rtl'</dt>
<dd>
- <p>Let <var title="">x-position-reverse</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> minus half of <var title="">size</var>.</p>
+ <p>Let <var title="">x-position-reverse</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> minus half of <var title="">size</var>.</p>
<p>Let <var title="">x-position</var> be <var title="">x-position-reverse</var> subtracted from 100.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a></dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-alignment>timed track cue alignment</a> is <a href=#timed-track-cue-middle-alignment title="timed track cue middle alignment">middle</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-alignment>text track cue alignment</a> is <a href=#text-track-cue-middle-alignment title="text track cue middle alignment">middle</a></dt>
<dd>
- <p>Let <var title="">y-position</var> be the <a href=#timed-track-cue-text-position>timed track cue text position</a> minus half of <var title="">size</var>.</p>
+ <p>Let <var title="">y-position</var> be the <a href=#text-track-cue-text-position>text track cue text position</a> minus half of <var title="">size</var>.</p>
</dd>
</dl></li>
@@ -81545,32 +81543,32 @@
not yet calculated for <var title="">cue</var> as per the
appropriate rules from the following list:</p>
- <dl class=switch><dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- and the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is set</dt>
+ <dl class=switch><dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ and the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is set</dt>
<dd>
<p>Let <var title="">y-position</var> be zero.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
- and the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is not set</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
+ and the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is not set</dt>
<dd>
- <p>Let <var title="">y-position</var> be the <a href=#timed-track-cue-line-position>timed track cue line position</a>.</p>
+ <p>Let <var title="">y-position</var> be the <a href=#text-track-cue-line-position>text track cue line position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is set</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is set</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is set</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is set</dt>
<dd>
<p>Let <var title="">x-position</var> be zero.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a>,
- and the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is not set</dt>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a>,
- and the <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is not set</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a>,
+ and the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is not set</dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a>,
+ and the <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is not set</dt>
<dd>
- <p>Let <var title="">x-position</var> be the <a href=#timed-track-cue-line-position>timed track cue line position</a>.</p>
+ <p>Let <var title="">x-position</var> be the <a href=#text-track-cue-line-position>text track cue line position</a>.</p>
</dd>
</dl></li>
@@ -81640,26 +81638,26 @@
<p>Adjust the positions of <var title="">boxes</var> according
to the appropriate steps from the following list:</p>
- <dl class=switch><dt>If <var title="">cue</var>'s <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is set</dt>
+ <dl class=switch><dt>If <var title="">cue</var>'s <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is set</dt>
<dd>
<p>Many of the steps in this algorithm vary according to the
- <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a>. Steps labeled
+ <a href=#text-track-cue-writing-direction>text track cue writing direction</a>. Steps labeled
"<strong>Horizontal</strong>" must be followed only when the
- <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing
+ <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing
direction">horizontal</a>, steps labeled
"<strong>Vertical</strong>" must be followed when the
- <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is either <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing
- direction">vertical growing left</a> or <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed
+ <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is either <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing
+ direction">vertical growing left</a> or <a href=#text-track-cue-vertical-growing-right-writing-direction title="text
track cue vertical growing right writing direction">vertical
growing right</a>, steps labeled "<strong>Vertical Growing
- Left</strong>" must be followed only when the <a href=#timed-track-cue-writing-direction>timed
- track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track
+ Left</strong>" must be followed only when the <a href=#text-track-cue-writing-direction>text
+ track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track
cue vertical growing left writing direction">vertical growing
left</a>, and steps labeled "<strong>Vertical Growing
- Right</strong>" must be followed only when the <a href=#timed-track-cue-writing-direction>timed
- track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track
+ Right</strong>" must be followed only when the <a href=#text-track-cue-writing-direction>text
+ track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track
cue vertical growing right writing direction">vertical growing
right</a>.</p>
@@ -81677,7 +81675,7 @@
step labeled <i>done positioning</i> below.</li>
<li><p>Let <var title="">line position</var> be the
- <a href=#timed-track-cue-line-position>timed track cue line position</a>.</li>
+ <a href=#text-track-cue-line-position>text track cue line position</a>.</li>
<li><p><strong>Vertical Growing Left</strong>: Add one to
<var title="">line position</var> then negate it.</li>
@@ -81766,7 +81764,7 @@
</ol></dd>
- <dt>If <var title="">cue</var>'s <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> is not set</dt>
+ <dt>If <var title="">cue</var>'s <a href=#text-track-cue-snap-to-lines-flag>text track cue snap-to-lines flag</a> is not set</dt>
<dd>
<ol><li>
@@ -81774,35 +81772,35 @@
<p>Set up <var title="">x</var> and <var title="">y</var> as
follows:</p>
- <dl class=switch><dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
+ <dl class=switch><dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
and <var title="">direction</var> is 'ltr'</dt>
<dd>
<p>Let <var title="">x</var> be a percentage given by the
- <a href=#timed-track-cue-text-position>timed track cue text position</a>, and let <var title="">y</var> be a percentage given by the <a href=#timed-track-cue-line-position>timed
+ <a href=#text-track-cue-text-position>text track cue text position</a>, and let <var title="">y</var> be a percentage given by the <a href=#text-track-cue-line-position>text
track cue line position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing direction">horizontal</a>,
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a>,
and <var title="">direction</var> is 'rtl'</dt>
<dd>
<p>Let <var title="">x</var> be a percentage given by the
- <a href=#timed-track-cue-text-position>timed track cue text position</a> subtracted from
+ <a href=#text-track-cue-text-position>text track cue text position</a> subtracted from
100, and let <var title="">y</var> be a percentage given
- by the <a href=#timed-track-cue-line-position>timed track cue line position</a>.</p>
+ by the <a href=#text-track-cue-line-position>text track cue line position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-left-writing-direction title="timed track cue vertical growing left writing direction">vertical growing left</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a></dt>
<dd>
<p>Let <var title="">x</var> be a percentage given by the
- <a href=#timed-track-cue-line-position>timed track cue line position</a> subtracted from
+ <a href=#text-track-cue-line-position>text track cue line position</a> subtracted from
100, and let <var title="">y</var> be a percentage given
- by the <a href=#timed-track-cue-text-position>timed track cue text position</a>.</p>
+ by the <a href=#text-track-cue-text-position>text track cue text position</a>.</p>
</dd>
- <dt>If the <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a> is <a href=#timed-track-cue-vertical-growing-right-writing-direction title="timed track cue vertical growing right writing direction">vertical growing right</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a></dt>
<dd>
<p>Let <var title="">x</var> be a percentage given by the
- <a href=#timed-track-cue-line-position>timed track cue line position</a>, and let <var title="">y</var> be a percentage given by the <a href=#timed-track-cue-text-position>timed
+ <a href=#text-track-cue-line-position>text track cue line position</a>, and let <var title="">y</var> be a percentage given by the <a href=#text-track-cue-text-position>text
track cue text position</a>.</p>
</dd>
@@ -81847,7 +81845,7 @@
not completely fit inside <var title="">video</var>'s rendering
area, remove those offending line boxes from <var title="">boxes</var>.</li>
- <li><p>Let <var title="">cue</var>'s <a href=#timed-track-cue-display-state>timed track cue
+ <li><p>Let <var title="">cue</var>'s <a href=#text-track-cue-display-state>text track cue
display state</a> have the CSS boxes in <var title="">boxes</var>.</li>
<li><p>Add the CSS boxes in <var title="">boxes</var> to <var title="">output</var>.</li>
@@ -81858,8 +81856,8 @@
</ol><h5 id=applying-css-properties-to-webvtt-node-objects><span class=secno>12.3.2.2 </span>Applying CSS properties to <a href=#webvtt-node-object title="WebVTT Node Object">WebVTT Node Objects</a></h5>
- <p>When following the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the display of WebVTT
- timed tracks</a>, user agents must set properties of <a href=#webvtt-node-object title="WebVTT Node Object">WebVTT Node Objects</a> as defined in
+ <p>When following the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the display of WebVTT
+ text tracks</a>, user agents must set properties of <a href=#webvtt-node-object title="WebVTT Node Object">WebVTT Node Objects</a> as defined in
this section. <a href=#refsCSS>[CSS]</a></p>
<p>On the (root) <a href=#list-of-webvtt-node-objects>List of WebVTT Node Objects</a>, the
@@ -81870,9 +81868,9 @@
'left' property must be set to <var title="">left</var>, the 'width'
property must be set to <var title="">width</var>, and the 'height'
property must be set to <var title="">height</var>, where <var title="">direction</var>, <var title="">block-flow</var>, <var title="">top</var>, <var title="">left</var>, <var title="">width</var>, and <var title="">height</var> are the values
- with those names determined by the <a href=#rules-for-updating-the-display-of-webvtt-timed-tracks>rules for updating the
- display of WebVTT timed tracks</a> for the <a href=#timed-track-cue>timed track
- cue</a> from whose <a href=#timed-track-cue-text title="timed track cue text">text</a>
+ with those names determined by the <a href=#rules-for-updating-the-display-of-webvtt-text-tracks>rules for updating the
+ display of WebVTT text tracks</a> for the <a href=#text-track-cue>text track
+ cue</a> from whose <a href=#text-track-cue-text title="text track cue text">text</a>
the <a href=#list-of-webvtt-node-objects>List of WebVTT Node Objects</a> was constructed.</p>
<p>The 'font' shorthand property on the (root) <a href=#list-of-webvtt-node-objects>List of WebVTT
@@ -81907,9 +81905,9 @@
<p>All other non-inherited properties must be set to their initial
values; inherited properties on the root <a href=#list-of-webvtt-node-objects>List of WebVTT Node
Objects</a> must inherit their values from the <a href=#media-element>media
- element</a> for which the <a href=#timed-track-cue>timed track cue</a> is being
+ element</a> for which the <a href=#text-track-cue>text track cue</a> is being
rendered, if any. If there is no <a href=#media-element>media element</a> (i.e. if
- the <a href=#timed-track>timed track</a> is being rendered for another media
+ the <a href=#text-track>text track</a> is being rendered for another media
playback mechanism), then inherited properties on the root
<a href=#list-of-webvtt-node-objects>List of WebVTT Node Objects</a> must take their initial
values.</p>
@@ -81917,14 +81915,14 @@
<h5 id=css-extensions><span class=secno>12.3.2.3 </span>CSS extensions</h5>
- <p>When a user agent is rendering one or more <a href=#timed-track-cue title="timed
- track cue">timed track cues</a> according to the <a href=#webvtt-cue-text-rendering-rules>WebVTT cue
+ <p>When a user agent is rendering one or more <a href=#text-track-cue title="text
+ track cue">text track cues</a> according to the <a href=#webvtt-cue-text-rendering-rules>WebVTT cue
text rendering rules</a>, <a href=#webvtt-node-object title="WebVTT Node Object">WebVTT
Node Objects</a> in the <a href=#list-of-webvtt-node-objects>list of WebVTT Node Objects</a>
used in the rendering can be matched by certain pseudo-selectors as
defined below. These selectors can begin or stop matching individual
<a href=#webvtt-node-object title="WebVTT Node Object">WebVTT Node Objects</a> while a
- <a href=#timed-track-cue title="timed track cue">cue</a> is being rendered, even in
+ <a href=#text-track-cue title="text track cue">cue</a> is being rendered, even in
between applications of the <a href=#webvtt-cue-text-rendering-rules>WebVTT cue text rendering
rules</a> (which are only run when the set of active cues
changes). User agents that support the pseudo-element described
@@ -81933,16 +81931,16 @@
<p>Pseudo-elements apply to elements that are matched by
selectors. For the purpose of this section, that element is the
<i>matched element</i>. The pseudo-elements defined in the following
- sections affect the styling of parts of <a href=#timed-track-cue title="timed track
- cue">timed track cues</a> that are being rendered for the
+ sections affect the styling of parts of <a href=#text-track-cue title="text track
+ cue">text track cues</a> that are being rendered for the
<i>matched element</i>.</p>
<p class=note>If the <i>matched element</i> is not a
<code><a href=#video>video</a></code> element, the pseudo-elements defined below won't
have any effect according to this specification.</p>
- <p>A CSS user agent that implements the <a href=#timed-track title="timed
- track">timed tracks</a> model must implement the '::cue' and
+ <p>A CSS user agent that implements the <a href=#text-track title="text
+ track">text tracks</a> model must implement the '::cue' and
'::cue(<var title="">selector</var>)' pseudo-elements, and the
':past' and ':future' pseudo-classes.</p>
@@ -82089,7 +82087,7 @@
<p>A <a href=#webvtt-node-object>WebVTT Node Object</a> <var title="">c</var> is
<dfn id=in-the-past>in the past</dfn> if, in a pre-order, depth-first traversal of
- the <a href=#timed-track-cue>timed track cue</a>'s <a href=#list-of-webvtt-node-objects>List of WebVTT Node
+ the <a href=#text-track-cue>text track cue</a>'s <a href=#list-of-webvtt-node-objects>List of WebVTT Node
Objects</a>, there exists a <a href=#webvtt-timestamp-object>WebVTT Timestamp Object</a>
whose value is less than the <a href=#current-playback-position>current playback position</a>
of the <a href=#media-element>media element</a> that is the <i>matched
@@ -82100,7 +82098,7 @@
<p>A <a href=#webvtt-node-object>WebVTT Node Object</a> <var title="">c</var> is
<dfn id=in-the-future>in the future</dfn> if, in a pre-order, depth-first traversal
- of the <a href=#timed-track-cue>timed track cue</a>'s <a href=#list-of-webvtt-node-objects>List of WebVTT Node
+ of the <a href=#text-track-cue>text track cue</a>'s <a href=#list-of-webvtt-node-objects>List of WebVTT Node
Objects</a>, there exists a <a href=#webvtt-timestamp-object>WebVTT Timestamp Object</a>
whose value is greater than the <a href=#current-playback-position>current playback
position</a> of the <a href=#media-element>media element</a> that is the
@@ -85463,10 +85461,10 @@
<dd>Must always be UTF-8.</dd>
<dt>Security considerations:</dt>
<dd>
- <p>Timed track files themselves pose no immediate risk unless
+ <p>Text track files themselves pose no immediate risk unless
sensitive information is included within the
data. Implementations, however, are required to follow specific
- rules when processing timed tracks, to ensure that certain
+ rules when processing text tracks, to ensure that certain
origin-based restrictions are honored. Failure to correctly
implement these rules can result in information leakage,
cross-site scripting attacks, and the like.</p>
@@ -86725,7 +86723,7 @@
<td><a href=#global-attributes title="global attributes">globals</a></td>
<td><code><a href=#htmltablerowelement>HTMLTableRowElement</a></code></td>
</tr><!--KEEP-END w3c-html--><!--TT--><tr><th><code><a href=#the-track-element>track</a></code></th>
- <td>Timed track</td>
+ <td>Timed text track</td>
<td>none</td>
<td><code><a href=#audio>audio</a></code>;
<code><a href=#video>video</a></code></td>
@@ -87236,7 +87234,7 @@
<td> <a href=#valid-date-or-time-string>Valid date or time string</a>*
<tr><th> <code title="">default</code>
<td> <code title=attr-track-default><a href=#attr-track-default>track</a></code>
- <td> Enable the track if no other <a href=#timed-track>timed track</a> is more suitable.
+ <td> Enable the track if no other <a href=#text-track>text track</a> is more suitable.
<td> <a href=#boolean-attribute>Boolean attribute</a>
<tr><th> <code title="">defer</code>
<td> <code title=attr-script-defer><a href=#attr-script-defer>script</a></code>
@@ -87409,7 +87407,7 @@
<!--KEEP-END w3c-html--><!--TT-->
<tr><th> <code title="">kind</code>
<td> <code title=attr-track-kind><a href=#attr-track-kind>track</a></code>
- <td> The type of timed track
+ <td> The type of text track
<td> "<code title=attr-track-kind-subtitles><a href=#attr-track-kind-subtitles>subtitles</a></code>";
"<code title=attr-track-kind-captions><a href=#attr-track-kind-captions>captions</a></code>";
"<code title=attr-track-kind-descriptions><a href=#attr-track-kind-descriptions>descriptions</a></code>";
@@ -87666,7 +87664,7 @@
<!--KEEP-END w3c-html--><!--TT-->
<tr><th> <code title="">srclang</code>
<td> <code title=attr-track-srclang><a href=#attr-track-srclang>track</a></code>
- <td> Language of the timed track
+ <td> Language of the text track
<td> Valid BCP 47 language tag
<!--KEEP-START w3c-html--><!--TT-->
<tr><th> <code title="">start</code>
@@ -89914,7 +89912,7 @@
<!--TT-->
<p>Thanks to the SubRip community, including in particular Zuggy and
ai4spam, for their work on the SubRip software program whose SRT
- file format was used as the basis for the WebVTT timed track file
+ file format was used as the basis for the WebVTT text track file
format.</p>
<!--TT-->
Modified: source
===================================================================
--- source 2010-12-25 06:42:53 UTC (rev 5722)
+++ source 2010-12-25 06:56:43 UTC (rev 5723)
@@ -76,7 +76,7 @@
<ul class="brief">
<li>The <code>device</code> element.</li> <!--DEVICE-->
<li>The <code title="attr-hyperlink-ping">ping</code> attribute and related <span>hyperlink auditing</span> features.</li> <!--PING-->
- <li>The <span>WebVTT</span> format and some <span>timed track</span> API features.</li> <!--TT--> <!--TTVTT-->
+ <li>The <span>WebVTT</span> format and some <span>text track</span> API features.</li> <!--TT--> <!--TTVTT-->
<li>Rules for <a href="#atom">converting HTML to Atom</a>.</li> <!--MD-->
<li>The <code title="dom-document-cssElementMap">cssElementMap</code> feature for defining <span title="CSS element reference identifier">CSS element reference identifiers</span>.</li> <!--CSSREF-->
</ul>
@@ -26246,10 +26246,10 @@
<!--KEEP-END w3c-html--><!--TT-->
<p>The <code>video</code> element also <span>represents</span> any
- <span title="timed track cue">timed track cues</span> whose
- <span>timed track cue active flag</span> is set and whose
- <span>timed track</span> is in the <span title="timed track
- showing">showing</span> or <span title="timed track showing by
+ <span title="text track cue">text track cues</span> whose
+ <span>text track cue active flag</span> is set and whose
+ <span>text track</span> is in the <span title="text track
+ showing">showing</span> or <span title="text track showing by
default">showing by default</span> modes.</p>
<!--KEEP-START w3c-html--><!--TT-->
@@ -26838,15 +26838,15 @@
attribute DOMString <span title="dom-track-label">label</span>;
attribute boolean <span title="dom-track-default">default</span>;
- readonly attribute <span>TimedTrack</span> <span title="dom-track-track">track</span>;
+ readonly attribute <span>TextTrack</span> <span title="dom-track-track">track</span>;
};</pre>
</dd>
</dl>
<p>The <code>track</code> element allows authors to specify explicit
- external text-based <span title="timed track">timed tracks</span>
- for <span title="media element">media elements</span>. It does not
- <span title="represents">represent</span> anything on its own.</p>
+ external timed <span title="text track">text tracks</span> for <span
+ title="media element">media elements</span>. It does not <span
+ title="represents">represent</span> anything on its own.</p>
<p>The <dfn title="attr-track-kind"><code>kind</code></dfn>
attribute is an <span>enumerated attribute</span>. The following
@@ -26897,7 +26897,7 @@
the <span title="attr-track-kind-subtitles">subtitles</span> state.</p>
<p>The <dfn title="attr-track-src"><code>src</code></dfn> attribute
- gives the address of the timed track data. The value must be a
+ gives the address of the text track data. The value must be a
<span>valid non-empty URL potentially surrounded by
spaces</span>. This attribute must be present.</p>
@@ -26923,7 +26923,7 @@
<!--START w3c-html--><!--TTVTT-->
<p>The <dfn title="attr-track-srclang"><code>srclang</code></dfn>
- attribute gives the language of the timed track data. The value must
+ attribute gives the language of the text track data. The value must
be a valid BCP 47 language tag. This attribute must be present if
the element's <code title="attr-track-kind">kind</code> attribute is
in the <span title="attr-track-kind-subtitles">subtitles</span>
@@ -26981,7 +26981,7 @@
<dd>
- <p>Returns the <code>TimedTrack</code> object corresponding to the <span>timed track</span> of the <code>track</code> element.</p>
+ <p>Returns the <code>TextTrack</code> object corresponding to the <span>text track</span> of the <code>track</code> element.</p>
</dd>
@@ -26991,7 +26991,7 @@
<p>The <dfn title="dom-track-track"><code>track</code></dfn> IDL
attribute must, on getting, return the <code>track</code> element's
- <span>timed track</span>'s corresponding <code>TimedTrack</code>
+ <span>text track</span>'s corresponding <code>TextTrack</code>
object.</p>
<p>The <dfn title="dom-track-src"><code>src</code></dfn>, <dfn
@@ -27078,9 +27078,9 @@
attribute double <span title="dom-media-volume">volume</span>;
attribute boolean <span title="dom-media-muted">muted</span>;
<!--KEEP-END w3c-html--><!--TT-->
- // timed tracks
- readonly attribute <span>TimedTrack</span>[] <span title="dom-media-tracks">tracks</span>;
- <span>MutableTimedTrack</span> <span title="dom-media-addTrack">addTrack</span>(in DOMString kind, in optional DOMString label, in optional DOMString language);
+ // text tracks
+ readonly attribute <span>TextTrack</span>[] <span title="dom-media-tracks">tracks</span>;
+ <span>MutableTextTrack</span> <span title="dom-media-addTrack">addTrack</span>(in DOMString kind, in optional DOMString label, in optional DOMString language);
<!--KEEP-START w3c-html--><!--TT-->
};</pre>
@@ -27541,7 +27541,7 @@
<!--KEEP-END w3c-html--><!--TT-->
<li><p><span>Forget the media element's media-resource-specific
- timed tracks</span>.</p></li>
+ text tracks</span>.</p></li>
<!--KEEP-START w3c-html--><!--TT-->
<li><p>If <code title="dom-media-readyState">readyState</code> is
@@ -27732,7 +27732,7 @@
<!--KEEP-END w3c-html--><!--TT-->
<li><p><span>Forget the media element's media-resource-specific
- timed tracks</span>.</p></li>
+ text tracks</span>.</p></li>
<!--KEEP-START w3c-html--><!--TT-->
<li><p>Set the element's <code
@@ -27885,7 +27885,7 @@
<!--KEEP-END w3c-html--><!--TT-->
<li><p>⌛ <span>Forget the media element's
- media-resource-specific timed tracks</span>.</p></li>
+ media-resource-specific text tracks</span>.</p></li>
<!--KEEP-START w3c-html--><!--TT-->
<li><p>⌛ <i title="">Find next candidate</i>: Let <var
@@ -28084,7 +28084,7 @@
<span>media resource</span>, its dimensions, and other
metadata,
<!--KEEP-END w3c-html--><!--TT-->
- and once <span>the timed tracks are ready</span>
+ and once <span>the text tracks are ready</span>
<!--KEEP-START w3c-html--><!--TT-->
</dt>
@@ -28396,7 +28396,7 @@
<!--KEEP-END w3c-html--><!--TT-->
- <dt id="found-a-media-resource-specific-timed-track">If the <span>media resource</span> is found to declare a <span>media-resource-specific timed track</span> that the user agent supports</dt>
+ <dt id="found-a-media-resource-specific-timed-track">If the <span>media resource</span> is found to declare a <span>media-resource-specific text track</span> that the user agent supports</dt>
<dd>
@@ -28404,7 +28404,7 @@
the <span>same origin</span> as the <span>media element</span>'s
<code>Document</code>'s <span>origin</span>, <span>queue a
task</span> to run the <span>steps to expose a
- media-resource-specific timed track</span> with the relevant
+ media-resource-specific text track</span> with the relevant
data.</p> <!-- CORS -->
<p class="note">Cross-origin files do not expose their subtitles
@@ -28870,8 +28870,8 @@
data</span> is available for the immediate <span>current playback
position</span>.
<!--KEEP-END w3c-html--><!--TT-->
- The <span title="timed track">timed tracks</span>
- are <span title="the timed tracks are ready">ready</span>.
+ The <span title="text track">text tracks</span>
+ are <span title="the text tracks are ready">ready</span>.
<!--KEEP-START w3c-html--><!--TT-->
</dd>
@@ -29520,7 +29520,7 @@
<!--KEEP-END w3c-html--><!--TT-->
(These steps are thus run as often as possible or needed — if
one iteration takes a long time, this can cause certain <span
- title="timed track cue">cues</span> to be skipped over as the user
+ title="text track cue">cues</span> to be skipped over as the user
agent rushes ahead to "catch up".)
<!--KEEP-START w3c-html--><!--TT-->
</p>
@@ -29529,27 +29529,27 @@
<!--KEEP-END w3c-html--><!--TT-->
<li><p>Let <var title="">current cues</var> be an ordered list of
- <span title="timed track cue">cues</span>, initialized to contain
- all the <span title="timed track cue">cues</span> of all the <span
- title="timed track hidden">hidden</span>, <span title="timed track
- showing">showing</span>, or <span title="timed track showing by
- default">showing by default</span> <span title="timed track">timed
+ <span title="text track cue">cues</span>, initialized to contain
+ all the <span title="text track cue">cues</span> of all the <span
+ title="text track hidden">hidden</span>, <span title="text track
+ showing">showing</span>, or <span title="text track showing by
+ default">showing by default</span> <span title="text track">text
tracks</span> of the <span>media element</span> (not the <span
- title="timed track disabled">disabled</span> ones) whose <span
- title="timed track cue start time">start times</span> are less than
+ title="text track disabled">disabled</span> ones) whose <span
+ title="text track cue start time">start times</span> are less than
or equal to the <span>current playback position</span> and whose
- <span title="timed track cue end time">end times</span> are greater
- than the <span>current playback position</span>, in <span>timed
+ <span title="text track cue end time">end times</span> are greater
+ than the <span>current playback position</span>, in <span>text
track cue order</span>.</p></li>
<li><p>Let <var title="">other cues</var> be an ordered list of
- <span title="timed track cue">cues</span>, initialized to contain
- all the <span title="timed track cue">cues</span> of <span
- title="timed track hidden">hidden</span>, <span title="timed track
- showing">showing</span>, and <span title="timed track showing by
- default">showing by default</span> <span title="timed track">timed
+ <span title="text track cue">cues</span>, initialized to contain
+ all the <span title="text track cue">cues</span> of <span
+ title="text track hidden">hidden</span>, <span title="text track
+ showing">showing</span>, and <span title="text track showing by
+ default">showing by default</span> <span title="text track">text
tracks</span> of the <span>media element</span> that are not
- present in <var title="">current cues</var>, also in <span>timed
+ present in <var title="">current cues</var>, also in <span>text
track cue order</span>.</p></li>
<!--KEEP-START w3c-html--><!--TT-->
@@ -29574,18 +29574,18 @@
while decoding the video.</p></li>
<!--KEEP-END w3c-html--><!--TT-->
- <li><p>If all of the <span title="timed track cue">cues</span> in
- <var title="">current cues</var> have their <span>timed track cue
- active flag</span> set, and none of the <span title="timed track
+ <li><p>If all of the <span title="text track cue">cues</span> in
+ <var title="">current cues</var> have their <span>text track cue
+ active flag</span> set, and none of the <span title="text track
cue">cues</span> in <var title="">other cues</var> have their
- <span>timed track cue active flag</span> set, then abort these
+ <span>text track cue active flag</span> set, then abort these
steps.</p></li>
<li><p>If the time was reached through the usual monotonic increase
of the current playback position during normal playback, and there
- are <span title="timed track cue">cues</span> in <var
- title="">other cues</var> that have both their <span>timed track
- cue active flag</span> set and their <span>timed track cue
+ are <span title="text track cue">cues</span> in <var
+ title="">other cues</var> that have both their <span>text track
+ cue active flag</span> set and their <span>text track cue
pause-on-exit flag</span> set, then immediately act as if the
element's <code title="dom-media-pause">pause()</code> method had
been invoked. <!-- pause() can in theory call load(), but never can
@@ -29593,61 +29593,61 @@
algorithm if the media element was empty. So, no need to couch all
this in a task. --> (In the other cases, such as explicit seeks,
playback is not paused by going past the end time of a <span
- title="timed track cue">cue</span>, even if that <span title="timed
- track cue">cue</span> has its <span>timed track cue pause-on-exit
+ title="text track cue">cue</span>, even if that <span title="text
+ track cue">cue</span> has its <span>text track cue pause-on-exit
flag</span> set.)</p></li>
<li><p>Let <var title="">affected tracks</var> be a list of <span
- title="timed track">timed tracks</span>, initially empty.</p></li>
+ title="text track">text tracks</span>, initially empty.</p></li>
- <li><p>For each <span title="timed track cue">timed track
+ <li><p>For each <span title="text track cue">text track
cue</span> in <var title="">other cues</var> that has its
- <span>timed track cue active flag</span> set, in list order,
+ <span>text track cue active flag</span> set, in list order,
<span>queue a task</span> to <span>fire a simple event</span> named
<code title="event-exit">exit</code> at the
- <code>TimedTrackCue</code> object, and add the <span title="timed
- track cue">cue</span>'s <span>timed track</span> to <var
+ <code>TextTrackCue</code> object, and add the <span title="text
+ track cue">cue</span>'s <span>text track</span> to <var
title="">affected tracks</var>, if it's not already in the
list.</p></li>
- <li><p>For each <span title="timed track cue">timed track
+ <li><p>For each <span title="text track cue">text track
cue</span> in <var title="">current cues</var> that does not have
- its <span>timed track cue active flag</span> set, in list order,
+ its <span>text track cue active flag</span> set, in list order,
<span>queue a task</span> to <span>fire a simple event</span> named
<code title="event-enter">enter</code> at the
- <code>TimedTrackCue</code> object, and add the <span title="timed
- track cue">cue</span>'s <span>timed track</span> to <var
+ <code>TextTrackCue</code> object, and add the <span title="text
+ track cue">cue</span>'s <span>text track</span> to <var
title="">affected tracks</var>, if it's not already in the
list.</p></li>
- <li><p>For each <span>timed track</span> in <var title="">affected
+ <li><p>For each <span>text track</span> in <var title="">affected
tracks</var>, in the order they were added to the list (which will
- match the relative order of the <span title="timed track">timed
+ match the relative order of the <span title="text track">text
tracks</span> in the <span>media element</span>'s <span>list of
- timed tracks</span>), <span>queue a task</span> to <span>fire a
+ text tracks</span>), <span>queue a task</span> to <span>fire a
simple event</span> named <code
title="event-cuechange">cuechange</code> at the
- <code>TimedTrack</code> object, and, if the <span>timed
+ <code>TextTrack</code> object, and, if the <span>text
track</span> has a corresponding <code>track</code> element, to
then <span>fire a simple event</span> named <code
title="event-cuechange">cuechange</code> at the <code>track</code>
element as well.</p></li>
- <li><p>Set the <span>timed track cue active flag</span> of all the
- <span title="timed track cue">cues</span> in the <var
- title="">current cues</var>, and unset the <span>timed track cue
- active flag</span> of all the <span title="timed track
+ <li><p>Set the <span>text track cue active flag</span> of all the
+ <span title="text track cue">cues</span> in the <var
+ title="">current cues</var>, and unset the <span>text track cue
+ active flag</span> of all the <span title="text track
cue">cues</span> in the <var title="">other cues</var>.</p></li>
- <li><p>Run the <span>rules for updating the timed track
- rendering</span> of each of the <span title="timed track">timed
+ <li><p>Run the <span>rules for updating the text track
+ rendering</span> of each of the <span title="text track">text
tracks</span> in <var title="">affected tracks</var> that are <span
- title="timed track showing">showing</span> or <span title="timed
+ title="text track showing">showing</span> or <span title="text
track showing by default">showing by default</span>.
<!--END w3c-html--><!--TTVTT-->
- For example, for <span title="timed track">timed tracks</span>
+ For example, for <span title="text track">text tracks</span>
based on <span>WebVTT</span>, the <span>rules for updating the
- display of WebVTT timed tracks</span>.
+ display of WebVTT text tracks</span>.
<!--START w3c-html--><!--TTVTT-->
</p></li>
<!--KEEP-START w3c-html--><!--TT-->
@@ -29655,10 +29655,10 @@
</ol>
<!--KEEP-END w3c-html--><!--TT-->
- <p>For the purposes of the algorithm above, a <span>timed track
- cue</span> is considered to be part of a <span>timed track</span>
- only if it is listed in the <span>timed track list of cues</span>,
- not merely if it is associated with the <span>timed
+ <p>For the purposes of the algorithm above, a <span>text track
+ cue</span> is considered to be part of a <span>text track</span>
+ only if it is listed in the <span>text track list of cues</span>,
+ not merely if it is associated with the <span>text
track</span>.</p>
<!--KEEP-START w3c-html--><!--TT-->
@@ -29842,38 +29842,38 @@
<!--KEEP-END w3c-html--><!--TT-->
<!--<div data-component="other Hixie drafts (editor: Ian Hickson)">-->
- <h5>Text timed tracks</h5>
+ <h5>Timed text tracks</h5>
- <h6>Timed track model</h6>
+ <h6>Text track model</h6>
<p>A <span>media element</span> can have a group of associated <dfn
- title="timed track">timed tracks</dfn>, known as the <span>media
- element</span>'s <dfn>list of timed tracks</dfn>. The <span
- title="timed track">timed tracks</span> are sorted as follows:</p>
+ title="text track">text tracks</dfn>, known as the <span>media
+ element</span>'s <dfn>list of text tracks</dfn>. The <span
+ title="text track">text tracks</span> are sorted as follows:</p>
<ol class="brief">
- <li>The <span title="timed track">timed tracks</span> corresponding
+ <li>The <span title="text track">text tracks</span> corresponding
to <code>track</code> element children of the <span>media
element</span>, in <span>tree order</span>.</li>
- <li>Any <span title="timed track">timed tracks</span> added using
+ <li>Any <span title="text track">text tracks</span> added using
the <code title="dom-media-addTrack">addTrack()</code> method, in
the order they were added, oldest first.</li>
- <li>Any <span title="media-resource-specific timed
- track">media-resource-specific timed tracks</span> (<span
- title="timed track">timed tracks</span> corresponding to data in
+ <li>Any <span title="media-resource-specific text
+ track">media-resource-specific text tracks</span> (<span
+ title="text track">text tracks</span> corresponding to data in
the <span>media resource</span>), in the order defined by the
<span>media resource</span>'s format specification.</li>
</ol>
- <p>A <span>timed track</span> consists of:</p>
+ <p>A <span>text track</span> consists of:</p>
<dl>
- <dt><dfn title="timed track kind">The kind of timed track</dfn>
+ <dt><dfn title="text track kind">The kind of text track</dfn>
<dd>
@@ -29881,20 +29881,20 @@
kind is represented by a string. The possible strings are:</p>
<ul class="brief">
- <li><dfn title="dom-TimedTrack-kind-subtitles"><code>subtitles</code></dfn>
- <li><dfn title="dom-TimedTrack-kind-captions"><code>captions</code></dfn>
- <li><dfn title="dom-TimedTrack-kind-descriptions"><code>descriptions</code></dfn>
- <li><dfn title="dom-TimedTrack-kind-chapters"><code>chapters</code></dfn>
- <li><dfn title="dom-TimedTrack-kind-metadata"><code>metadata</code></dfn>
+ <li><dfn title="dom-TextTrack-kind-subtitles"><code>subtitles</code></dfn>
+ <li><dfn title="dom-TextTrack-kind-captions"><code>captions</code></dfn>
+ <li><dfn title="dom-TextTrack-kind-descriptions"><code>descriptions</code></dfn>
+ <li><dfn title="dom-TextTrack-kind-chapters"><code>chapters</code></dfn>
+ <li><dfn title="dom-TextTrack-kind-metadata"><code>metadata</code></dfn>
</ul>
- <p>The <span title="timed track kind">kind of track</span> can
- change dynamically, in the case of a <span>timed track</span>
+ <p>The <span title="text track kind">kind of track</span> can
+ change dynamically, in the case of a <span>text track</span>
corresponding to a <code>track</code> element.</p>
</dd>
- <dt><dfn title="timed track label">A label</dfn>
+ <dt><dfn title="text track label">A label</dfn>
<dd>
@@ -29902,29 +29902,29 @@
for the user. In certain cases, the label might be generated
automatically.</p>
- <p>The <span title="timed track label">label of a track</span> can
- change dynamically, in the case of a <span>timed track</span>
+ <p>The <span title="text track label">label of a track</span> can
+ change dynamically, in the case of a <span>text track</span>
corresponding to a <code>track</code> element or in the case of an
automatically-generated label whose value depends on variable
factors such as the user's preferred user interface language.</p>
</dd>
- <dt><dfn title="timed track language">A language</dfn>
+ <dt><dfn title="text track language">A language</dfn>
<dd>
<p>This is a string (a BCP 47 language tag) representing the
- language of the timed track's cues. <a
+ language of the text track's cues. <a
href="#refsBCP47">[BCP47]</a></p>
- <p>The <span title="timed track language">language of a timed
- track</span> can change dynamically, in the case of a <span>timed
+ <p>The <span title="text track language">language of a text
+ track</span> can change dynamically, in the case of a <span>text
track</span> corresponding to a <code>track</code> element.</p>
</dd>
- <dt><dfn title="timed track readiness state">A readiness state</dfn>
+ <dt><dfn title="text track readiness state">A readiness state</dfn>
<dd>
@@ -29932,45 +29932,45 @@
<dl>
- <dt><dfn title="timed track not loaded">Not loaded</dfn>
+ <dt><dfn title="text track not loaded">Not loaded</dfn>
<dd>
- <p>Indicates that the timed track is known to exist (e.g. it has
+ <p>Indicates that the text track is known to exist (e.g. it has
been declared with a <code>track</code> element), but its cues
have not been obtained.</p>
</dd>
- <dt><dfn title="timed track loading">Loading</dfn>
+ <dt><dfn title="text track loading">Loading</dfn>
<dd>
- <p>Indicates that the timed track is loading and there have been
+ <p>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.</p>
</dd>
- <dt><dfn title="timed track loaded">Loaded</dfn>
+ <dt><dfn title="text track loaded">Loaded</dfn>
<dd>
- <p>Indicates that the timed track has been loaded with no fatal
+ <p>Indicates that the text track has been loaded with no fatal
errors. No new cues will be added to the track except if the
- <span>timed track</span> corresponds to a
- <code>MutableTimedTrack</code> object.</p>
+ <span>text track</span> corresponds to a
+ <code>MutableTextTrack</code> object.</p>
</dd>
- <dt><dfn title="timed track failed to load">Failed to load</dfn>
+ <dt><dfn title="text track failed to load">Failed to load</dfn>
<dd>
- <p>Indicates that the timed track was enabled, but when the user
+ <p>Indicates that the text track was enabled, but when the user
agent attempted to obtain it, this failed in some way
(e.g. <span>URL</span> could not be <span title="resolve a
- url">resolved</span>, network error, unknown timed track
+ url">resolved</span>, network error, unknown text track
format). Some or all of the cues are likely missing and will not
be obtained.</p>
@@ -29978,13 +29978,13 @@
</dl>
- <p>The <span title="timed track readiness state">readiness
- state</span> of a <span>timed track</span> changes dynamically as
+ <p>The <span title="text track readiness state">readiness
+ state</span> of a <span>text track</span> changes dynamically as
the track is obtained.</p>
</dd>
- <dt><dfn title="timed track mode">A mode</dfn>
+ <dt><dfn title="text track mode">A mode</dfn>
<dd>
@@ -29992,23 +29992,23 @@
<dl>
- <dt><dfn title="timed track disabled">Disabled</dfn>
+ <dt><dfn title="text track disabled">Disabled</dfn>
<dd>
- <p>Indicates that the timed track is not active. Other than for
+ <p>Indicates that the text track is not active. Other than for
the purposes of exposing the track in the DOM, the user agent is
- ignoring the timed track. No cues are active, no events are
+ ignoring the text track. No cues are active, no events are
fired, and the user agent will not attempt to obtain the track's
cues.</p>
</dd>
- <dt><dfn title="timed track hidden">Hidden</dfn>
+ <dt><dfn title="text track hidden">Hidden</dfn>
<dd>
- <p>Indicates that the timed track is active, but that the user
+ <p>Indicates that the text track is active, but that the user
agent is not actively displaying the cues. If no attempt has yet
been made to obtain the track's cues, the user agent will
perform such an attempt momentarily. The user agent is
@@ -30017,34 +30017,34 @@
</dd>
- <dt><dfn title="timed track showing">Showing</dfn>
- <dt><dfn title="timed track showing by default">Showing by default</dfn>
+ <dt><dfn title="text track showing">Showing</dfn>
+ <dt><dfn title="text track showing by default">Showing by default</dfn>
<dd>
- <p>Indicates that the timed track is active. If no attempt has
+ <p>Indicates that the text track is active. If no attempt has
yet been made to obtain the track's cues, the user agent will
perform such an attempt momentarily. The user agent is
maintaining a list of which cues are active, and events are
- being fired accordingly. In addition, for timed tracks whose
- <span title="timed track kind">kind</span> is <code
+ being fired accordingly. In addition, for text tracks whose
+ <span title="text track kind">kind</span> is <code
title="dom-mediatrack-kind-subtitles">subtitles</code> or <code
title="dom-mediatrack-kind-captions">captions</code>, the cues
- are being displayed over the video as appropriate; for timed
- tracks whose <span title="timed track kind">kind</span> is <code
+ are being displayed over the video as appropriate; for text
+ tracks whose <span title="text track kind">kind</span> is <code
title="dom-mediatrack-kind-descriptions">descriptions</code>,
the user agent is making the cues available to the user in a
- non-visual fashion; and for timed tracks whose <span
- title="timed track kind">kind</span> is <code
+ non-visual fashion; and for text tracks whose <span
+ title="text track kind">kind</span> is <code
title="dom-mediatrack-kind-chapters">chapters</code>, the user
agent is making available to the user a mechanism by which the
user can navigate to any point in the <span>media
resource</span> by selecting a cue.</p>
- <p>The <span title="timed track showing by default">showing by
+ <p>The <span title="text track showing by default">showing by
default</span> state is used in conjunction with the <code
title="attr-track-default">default</code> attribute on
- <code>track</code> elements to indicate that the timed track was
+ <code>track</code> elements to indicate that the text track was
enabled due to that attribute. This allows the user agent to
override the state if a later track is discovered that is more
appropriate per the user's preferences.</p>
@@ -30055,25 +30055,25 @@
</dd>
- <dt><dfn title="timed track list of cues">A list of zero or more cues</dfn>
+ <dt><dfn title="text track list of cues">A list of zero or more cues</dfn>
<dd>
- <p>A list of <span title="timed track cue">timed track
- cues</span>, along with <dfn>rules for updating the timed track
+ <p>A list of <span title="text track cue">text track
+ cues</span>, along with <dfn>rules for updating the text track
rendering</dfn>.
<!--END w3c-html--><!--TTVTT-->
For example, for <span>WebVTT</span>, the <span>rules for updating
- the display of WebVTT timed tracks</span>.
+ the display of WebVTT text tracks</span>.
<!--START w3c-html--><!--TTVTT-->
</p>
- <p>The <span title="timed track list of cues">list of cues of a
- timed track</span> can change dynamically, either because the
- <span>timed track</span> has <span title="timed track not
- loaded">not yet been loaded</span> or is still <span title="timed
- track loading">loading</span>, or because the <span>timed
- track</span> corresponds to a <code>MutableTimedTrack</code>
+ <p>The <span title="text track list of cues">list of cues of a
+ text track</span> can change dynamically, either because the
+ <span>text track</span> has <span title="text track not
+ loaded">not yet been loaded</span> or is still <span title="text
+ track loading">loading</span>, or because the <span>text
+ track</span> corresponds to a <code>MutableTextTrack</code>
object, whose API allows individual cues can be added or removed
dynamically.</p>
@@ -30081,143 +30081,143 @@
</dl>
- <p>Each <span>timed track</span> has a corresponding
- <code>TimedTrack</code> object.</p>
+ <p>Each <span>text track</span> has a corresponding
+ <code>TextTrack</code> object.</p>
- <p>The <span title="timed track">timed tracks</span> of a
- <span>media element</span> are <dfn title="the timed tracks are
- ready">ready</dfn> if all the <span title="timed track">timed
- tracks</span> whose <span title="timed track mode">mode</span> was
- not in the <span title="timed track disabled">disabled</span> state
+ <p>The <span title="text track">text tracks</span> of a
+ <span>media element</span> are <dfn title="the text tracks are
+ ready">ready</dfn> if all the <span title="text track">text
+ tracks</span> whose <span title="text track mode">mode</span> was
+ not in the <span title="text track disabled">disabled</span> state
when the element's <span
title="concept-media-load-algorithm">resource selection
- algorithm</span> last started now have a <span>timed track readiness
- state</span> of <span title="timed track loaded">loaded</span> or
- <span title="timed track failed to load">failed to load</span>.</p>
+ algorithm</span> last started now have a <span>text track readiness
+ state</span> of <span title="text track loaded">loaded</span> or
+ <span title="text track failed to load">failed to load</span>.</p>
<hr>
- <p>A <dfn>timed track cue</dfn> is the unit of time-sensitive data
- in a <span>timed track</span>, corresponding for instance for
+ <p>A <dfn>text track cue</dfn> is the unit of time-sensitive data
+ in a <span>text track</span>, corresponding for instance for
subtitles and captions to the text that appears at a particular time
and disappears at another time.</p>
- <p>Each <span>timed track cue</span> consists of:</p>
+ <p>Each <span>text track cue</span> consists of:</p>
<dl>
- <dt><dfn title="timed track cue identifier">An identifier</dfn>
+ <dt><dfn title="text track cue identifier">An identifier</dfn>
<dd>
<p>An arbitrary string.</p>
</dd>
- <dt><dfn title="timed track cue start time">A start time</dfn>
+ <dt><dfn title="text track cue start time">A start time</dfn>
<dd>
<p>A time, in seconds and fractions of a second, at which the cue
becomes relevant.</p>
</dd>
- <dt><dfn title="timed track cue end time">An end time</dfn>
+ <dt><dfn title="text track cue end time">An end time</dfn>
<dd>
<p>A time, in seconds and fractions of a second, at which the cue
stops being relevant.</p>
</dd>
- <dt><dfn title="timed track cue pause-on-exit flag">A pause-on-exit flag</dfn>
+ <dt><dfn title="text track cue pause-on-exit flag">A pause-on-exit flag</dfn>
<dd>
<p>A boolean indicating whether playback of the <span>media
resource</span> is to pause when the cue stops being relevant.</p>
</dd>
- <dt><dfn title="timed track cue writing direction">A writing direction</dfn>
+ <dt><dfn title="text track cue writing direction">A writing direction</dfn>
<dd>
- <p>A writing direction, either <dfn title="timed track cue
+ <p>A writing direction, either <dfn title="text track cue
horizontal writing direction">horizontal</dfn> (a line extends
horizontally and is positioned vertically, with consecutive lines
- displayed below each other), <dfn title="timed track cue vertical
+ displayed below each other), <dfn title="text track cue vertical
growing left writing direction">vertical growing left</dfn> (a
line extends vertically and is positioned horizontally, with
consecutive lines displayed to the left of each other<!-- used
- for east asian-->), or <dfn title="timed track cue vertical
+ for east asian-->), or <dfn title="text track cue vertical
growing right writing direction">vertical growing right</dfn> (a
line extends vertically and is positioned horizontally, with
consecutive lines displayed to the right of each other<!-- used for
mongolian -->).</p>
<!--END w3c-html--><!--TTVTT-->
- <p>If the <span title="timed track cue writing direction">writing
- direction</span> is <span title="timed track cue horizontal
- writing direction">horizontal</span>, then <span title="timed
+ <p>If the <span title="text track cue writing direction">writing
+ direction</span> is <span title="text track cue horizontal
+ writing direction">horizontal</span>, then <span title="text
track cue line position">line position</span> percentages are
- relative to the height of the video, and <span title="timed track
- cue text position">text position</span> and <span title="timed
+ relative to the height of the video, and <span title="text track
+ cue text position">text position</span> and <span title="text
track cue size">size</span> percentages are relative to the width
of the video.</p>
- <p>Otherwise, <span title="timed track cue line position">line
+ <p>Otherwise, <span title="text track cue line position">line
position</span> percentages are relative to the width of the
- video, and <span title="timed track cue text position">text
- position</span> and <span title="timed track cue size">size</span>
+ video, and <span title="text track cue text position">text
+ position</span> and <span title="text track cue size">size</span>
percentages are relative to the height of the video.</p>
<!--START w3c-html--><!--TTVTT-->
</dd>
<!--END w3c-html--><!--TTVTT-->
- <dt><dfn title="timed track cue snap-to-lines flag">A snap-to-lines flag</dfn>
+ <dt><dfn title="text track cue snap-to-lines flag">A snap-to-lines flag</dfn>
<dd>
- <p>A boolean indicating whether the <span title="timed track cue
+ <p>A boolean indicating whether the <span title="text track cue
line position">line's position</span> is a line position
(positioned to a multiple of the line dimensions of the first line
of the cue), or whether it is a percentage of the dimension of the
video.</p>
</dd>
- <dt><dfn title="timed track cue line position">A line position</dfn>
+ <dt><dfn title="text track cue line position">A line position</dfn>
<dd>
<p>Either a number giving the position of the lines of the cue, to
- be interpreted as defined by the <span title="timed track cue
- writing direction">writing direction</span> and <span title="timed
+ be interpreted as defined by the <span title="text track cue
+ writing direction">writing direction</span> and <span title="text
track cue snap-to-lines flag">snap-to-lines flag</span> of the
- cue, or the special value <dfn title="timed track cue automatic line
+ cue, or the special value <dfn title="text track cue automatic line
position">auto</dfn>, which means the position is to depend on
the other active tracks.</p>
</dd>
- <dt><dfn title="timed track cue text position">A text position</dfn>
+ <dt><dfn title="text track cue text position">A text position</dfn>
<dd>
<p>A number giving the position of the text of the cue within each
line, to be interpreted as a percentage of the video, as defined
- by the <span title="timed track cue writing direction">writing
+ by the <span title="text track cue writing direction">writing
direction</span>.</p>
</dd>
<!--START w3c-html--><!--TTVTT-->
- <dt><dfn title="timed track cue size">A size</dfn>
+ <dt><dfn title="text track cue size">A size</dfn>
<dd>
<p>A number giving the size of the box within which the text of
each line of the cue is to be aligned, to be interpreted as a
- percentage of the video, as defined by the <span title="timed
+ percentage of the video, as defined by the <span title="text
track cue writing direction">writing direction</span>.</p>
</dd>
<!--END w3c-html--><!--TTVTT-->
- <dt><dfn title="timed track cue alignment">An alignment</dfn>
+ <dt><dfn title="text track cue alignment">An alignment</dfn>
<dd>
<p>An alignment for the text of each line of the cue, either <dfn
- title="timed track cue start alignment">start alignment</dfn> (the
- text is aligned towards its start side), <dfn title="timed track
+ title="text track cue start alignment">start alignment</dfn> (the
+ text is aligned towards its start side), <dfn title="text track
cue middle alignment">middle alignment</dfn> (the text is aligned
- centered between its start and end sides), <dfn title="timed track
+ centered between its start and end sides), <dfn title="text track
cue end alignment">end alignment</dfn> (the text is aligned
towards its end side). Which sides are the start and end sides
depends on the Unicode bidirectional algorithm and the <span
- title="timed track cue writing direction">writing
+ title="text track cue writing direction">writing
direction</span>. <a href="#refsBIDI">[BIDI]</a></p>
</dd>
<!--START w3c-html--><!--TTVTT-->
- <dt><dfn title="timed track cue text">The text of the cue</dfn>
+ <dt><dfn title="text track cue text">The text of the cue</dfn>
<dd>
<p>The raw text of the cue, and rules for its interpretation,
allowing the text to be rendered and converted to a DOM fragment.</p>
@@ -30225,20 +30225,20 @@
</dl>
- <p>A <span>timed track cue</span> is immutable.</p>
+ <p>A <span>text track cue</span> is immutable.</p>
- <p>Each <span>timed track cue</span> has a corresponding
- <code>TimedTrackCue</code> object, and can be associated with a
- particular <span>timed track</span>. Once a <span>timed track
- cue</span> is associated with a particular <span>timed track</span>,
+ <p>Each <span>text track cue</span> has a corresponding
+ <code>TextTrackCue</code> object, and can be associated with a
+ particular <span>text track</span>. Once a <span>text track
+ cue</span> is associated with a particular <span>text track</span>,
the association is permanent.</p>
- <p>In addition, each <span>timed track cue</span> has two pieces of
+ <p>In addition, each <span>text track cue</span> has two pieces of
dynamic information:</p>
<dl>
- <dt>The <dfn title="timed track cue active flag">active flag</dfn>
+ <dt>The <dfn title="text track cue active flag">active flag</dfn>
<dd>
<p>This flag must be initially unset. The flag is used to ensure
@@ -30246,66 +30246,66 @@
inactive, and to make sure the right cues are rendered.</p>
<p>The user agent must synchronously unset this flag whenever the
- <span>timed track cue</span> is removed from its <span>timed
- track</span>'s <span>timed track list of cues</span>; whenever the
- <span>timed track</span> itself is removed from its <span>media
- element</span>'s <span>list of timed tracks</span> or has its
- <span>timed track mode</span> changed to <span title="timed track
+ <span>text track cue</span> is removed from its <span>text
+ track</span>'s <span>text track list of cues</span>; whenever the
+ <span>text track</span> itself is removed from its <span>media
+ element</span>'s <span>list of text tracks</span> or has its
+ <span>text track mode</span> changed to <span title="text track
disabled">disabled</span>; and whenever the <span>media
element</span>'s <code
title="dom-media-readyState">readyState</code> is changed back to
<code title="dom-media-HAVE_NOTHING">HAVE_NOTHING</code>. When the
flag is unset in this way for one or more cues in <span
- title="timed track">timed tracks</span> that were <span
- title="timed track showing">showing</span> or <span title="timed
+ title="text track">text tracks</span> that were <span
+ title="text track showing">showing</span> or <span title="text
track showing by default">showing by default</span> prior to the
relevant incident, the user agent must, after having unset the
flag for all the affected cues, apply the <span>rules for updating
- the timed track rendering</span> of those <span title="timed
- track">timed tracks</span>.
+ the text track rendering</span> of those <span title="text
+ track">text tracks</span>.
<!--END w3c-html--><!--TTVTT-->
- For example, for <span title="timed track">timed tracks</span>
+ For example, for <span title="text track">text tracks</span>
based on <span>WebVTT</span>, the <span>rules for updating the
- display of WebVTT timed tracks</span>.</p>
+ display of WebVTT text tracks</span>.</p>
<!--START w3c-html--><!--TTVTT-->
</dd>
- <dt>The <dfn title="timed track cue display state">display state</dfn>
+ <dt>The <dfn title="text track cue display state">display state</dfn>
<dd>
<p>This is used as part of the rendering model, to keep cues in a
consistent position. It must initially be empty. Whenever the
- <span>timed track cue active flag</span> is unset, the user agent
- must empty the <span>timed track cue display state</span>.</p>
+ <span>text track cue active flag</span> is unset, the user agent
+ must empty the <span>text track cue display state</span>.</p>
</dd>
</dl>
- <p>The <span title="timed track cue">timed track cues</span> of a
- <span>media element</span>'s <span title="timed track">timed
- tracks</span> are ordered relative to each other in the <dfn>timed
+ <p>The <span title="text track cue">text track cues</span> of a
+ <span>media element</span>'s <span title="text track">text
+ tracks</span> are ordered relative to each other in the <dfn>text
track cue order</dfn>, which is determined as follows: first group
- the <span title="timed track cue">cues</span> by their <span>timed
+ the <span title="text track cue">cues</span> by their <span>text
track</span>, with the groups being sorted in the same order as
- their <span title="timed track">timed tracks</span> appear in the
- <span>media element</span>'s <span>list of timed tracks</span>;
- then, within each group, <span title="timed track cue">cues</span>
- must be sorted by their <span title="timed track cue start
+ their <span title="text track">text tracks</span> appear in the
+ <span>media element</span>'s <span>list of text tracks</span>;
+ then, within each group, <span title="text track cue">cues</span>
+ must be sorted by their <span title="text track cue start
time">start time</span>, earliest first; then, any <span
- title="timed track cue">cues</span> with the same <span title="timed
+ title="text track cue">cues</span> with the same <span title="text
track cue start time">start time</span> must be sorted by their
- <span title="timed track cue end time">end time</span>, earliest
- first; and finally, any <span title="timed track cue">cues</span>
- with identical <span title="timed track cue end time">end
+ <span title="text track cue end time">end time</span>, earliest
+ first; and finally, any <span title="text track cue">cues</span>
+ with identical <span title="text track cue end time">end
times</span> must be sorted in the order they were created (so
e.g. for cues from a <span>WebVTT</span> file, that would be the
order in which the cues were listed in the file).</p>
- <h6>Sourcing in-band timed tracks</h6>
+ <h6>Sourcing in-band text tracks</h6>
- <p>A <dfn>media-resource-specific timed track</dfn> is a <span>timed
+ <p>A <dfn>media-resource-specific text track</dfn> is a <span>text
track</span> that corresponds to data found in the <span>media
resource</span>.</p>
@@ -30317,68 +30317,68 @@
if the <span>media resource</span> is a video.</p>
<p>When a <span>media resource</span> contains data that the user
- agent recognises and supports as being equivalent to a <span>timed
+ agent recognises and supports as being equivalent to a <span>text
track</span>, the user agent <a
href="#found-a-media-resource-specific-timed-track">runs</a> the
- <dfn>steps to expose a media-resource-specific timed track</dfn>
+ <dfn>steps to expose a media-resource-specific text track</dfn>
with the relevant data, as follows:</p>
<ol>
- <li><p>Associate the relevant data with a new <span>timed
- track</span> and its corresponding new <code>TimedTrack</code>
- object. The <span>timed track</span> is a
- <span>media-resource-specific timed track</span>.</p></li>
+ <li><p>Associate the relevant data with a new <span>text
+ track</span> and its corresponding new <code>TextTrack</code>
+ object. The <span>text track</span> is a
+ <span>media-resource-specific text track</span>.</p></li>
- <li><p>Set the new <span>timed track</span>'s <span title="timed track
- kind">kind</span>, <span title="timed track label">label</span>,
- and <span title="timed track language">language</span> based on the
+ <li><p>Set the new <span>text track</span>'s <span title="text track
+ kind">kind</span>, <span title="text track label">label</span>,
+ and <span title="text track language">language</span> based on the
semantics of the relevant data, as defined by the relevant
specification.</p></li>
- <li><p>Populate the new <span>timed track</span>'s <span
- title="timed track list of cues">list of cues</span> with the cues
+ <li><p>Populate the new <span>text track</span>'s <span
+ title="text track list of cues">list of cues</span> with the cues
parsed so far, folllowing the <span>guidelines for exposing
cues</span>, and begin updating it dynamically as
necessary.</p></li>
<li>
- <p>Set the new <span>timed track</span>'s <span title="timed track
+ <p>Set the new <span>text track</span>'s <span title="text track
readiness state">readiness state</span> to the value that most
correctly describes the current state, and begin updating it
dynamically as necessary.</p>
<p class="example">For example, if the relevant data in the
<span>media resource</span> has been fully parsed and completely
- describes the cues, then the <span>timed track</span> would be
- <span title="timed track loaded">loaded</span>. On the other hand,
+ describes the cues, then the <span>text track</span> would be
+ <span title="text track loaded">loaded</span>. On the other hand,
if the data for the cues is interleaved with the <span>media
data</span>, and the <span>media resource</span> as a whole is
- still being downloaded, then the <span title="timed track
+ still being downloaded, then the <span title="text track
loading">loading</span> state might be more accurate.</p>
</li>
- <li><p>Set the new <span>timed track</span>'s <span title="timed
+ <li><p>Set the new <span>text track</span>'s <span title="text
track mode">mode</span> to the mode consistent with the user's
preferences and the requirements of the relevant specification for
the data.</p></li>
- <li><p>Leave the <span>timed track list of cues</span> empty, and
- associate with it the <span>rules for updating the timed track
+ <li><p>Leave the <span>text track list of cues</span> empty, and
+ associate with it the <span>rules for updating the text track
rendering</span> appropriate for the format in question.</p>
- <li><p>Add the new <span>timed track</span> to the <span>media
- element</span>'s <span>list of timed tracks</span>.</p></li>
+ <li><p>Add the new <span>text track</span> to the <span>media
+ element</span>'s <span>list of text tracks</span>.</p></li>
</ol>
<p>When a <span>media element</span> is to <dfn>forget the media
- element's media-resource-specific timed tracks</dfn>, the user
+ element's media-resource-specific text tracks</dfn>, the user
agent must remove from the <span>media element</span>'s <span>list
- of timed tracks</span> all the <span title="media-resource-specific
- timed track">media-resource-specific timed tracks</span>.</p>
+ of text tracks</span> all the <span title="media-resource-specific
+ text track">media-resource-specific text tracks</span>.</p>
</div>
@@ -30386,17 +30386,17 @@
<div class="impl">
- <h6>Sourcing out-of-band timed tracks</h6>
+ <h6>Sourcing out-of-band text tracks</h6>
<p>When a <code>track</code> element is created, it must be
- associated with a new <span>timed track</span> (with its value set
- as defined below) and its corresponding new <code>TimedTrack</code>
+ associated with a new <span>text track</span> (with its value set
+ as defined below) and its corresponding new <code>TextTrack</code>
object.</p>
- <p>The <span>timed track kind</span> is determined from the state of
+ <p>The <span>text track kind</span> is determined from the state of
the element's <code title="attr-track-kind">kind</code> attribute
according to the following table; for a state given in a cell of the
- first column, the <span title="timed track kind">kind</span> is the
+ first column, the <span title="text track kind">kind</span> is the
string given in the second column:</p>
<table>
@@ -30422,95 +30422,95 @@
<td><code title="dom-timedtrack-kind-metadata">metadata</code>
</table>
- <p>The <span>timed track label</span> is the element's <span>track
+ <p>The <span>text track label</span> is the element's <span>track
label</span>.</p>
- <p>The <span>timed track language</span> is the element's
+ <p>The <span>text track language</span> is the element's
<span>track language</span>, if any, or the empty string
otherwise.</p>
<p>As the <code title="attr-track-kind">kind</code>, <code
title="attr-track-label">label</code>, and <code
title="attr-track-srclang">srclang</code> attributes are added,
- removed, or changed, the <span>timed track</span> must update
+ removed, or changed, the <span>text track</span> must update
accordingly, as per the definitions above.</p>
<p class="note">Changes to the <span>track URL</span> are handled in
the algorithm below.</p>
- <p>The <span>timed track list of cues</span> is initially empty. It
+ <p>The <span>text track list of cues</span> is initially empty. It
is dynamically modified when the referenced file is parsed.
- Associated with the list are the <span>rules for updating the timed
+ Associated with the list are the <span>rules for updating the text
track rendering</span> appropriate for the format in question; for
<span>WebVTT</span>, this is the <span>rules for updating the
- display of WebVTT timed tracks</span>.</p>
+ display of WebVTT text tracks</span>.</p>
<p>When a <code>track</code> element's parent element changes and
the new parent is a <span>media element</span>, then the user agent
- must add the <code>track</code> element's corresponding <span>timed
- track</span> to the <span>media element</span>'s <span>list of timed
+ must add the <code>track</code> element's corresponding <span>text
+ track</span> to the <span>media element</span>'s <span>list of text
tracks</span>.</p>
<p>When a <code>track</code> element's parent element changes and
the old parent was a <span>media element</span>, then the user agent
must remove the <code>track</code> element's corresponding
- <span>timed track</span> from the <span>media element</span>'s
- <span>list of timed tracks</span>.</p>
+ <span>text track</span> from the <span>media element</span>'s
+ <span>list of text tracks</span>.</p>
- <p>When a <span>timed track</span> corresponding to a
+ <p>When a <span>text track</span> corresponding to a
<code>track</code> element is added to a <span>media
- element</span>'s <span>list of timed tracks</span>, the user agent
- must set the <span>timed track mode</span> appropriately, as
+ element</span>'s <span>list of text tracks</span>, the user agent
+ must set the <span>text track mode</span> appropriately, as
determined by the following conditions:</p>
<dl class="switch">
- <dt>If the <span>timed track kind</span> is <code
- title="dom-TimedTrack-kind-subtitles">subtitles</code> or <code
- title="dom-TimedTrack-kind-captions">captions</code> and the user
- has indicated an interest in having a track with this <span>timed
- track kind</span>, <span>timed track language</span>, and
- <span>timed track label</span> enabled, and there is no other
- <span>timed track</span> in the <span>media element</span>'s
- <span>list of timed tracks</span> with a <span>timed track
+ <dt>If the <span>text track kind</span> is <code
+ title="dom-TextTrack-kind-subtitles">subtitles</code> or <code
+ title="dom-TextTrack-kind-captions">captions</code> and the user
+ has indicated an interest in having a track with this <span>text
+ track kind</span>, <span>text track language</span>, and
+ <span>text track label</span> enabled, and there is no other
+ <span>text track</span> in the <span>media element</span>'s
+ <span>list of text tracks</span> with a <span>text track
kind</span> of either <code
- title="dom-TimedTrack-kind-subtitles">subtitles</code> or <code
- title="dom-TimedTrack-kind-captions">captions</code> whose
- <span>timed track mode</span> is <span title="timed track
+ title="dom-TextTrack-kind-subtitles">subtitles</code> or <code
+ title="dom-TextTrack-kind-captions">captions</code> whose
+ <span>text track mode</span> is <span title="text track
showing">showing</span></dt>
- <dt>If the <span>timed track kind</span> is <code
- title="dom-TimedTrack-kind-descriptions">descriptions</code> and
+ <dt>If the <span>text track kind</span> is <code
+ title="dom-TextTrack-kind-descriptions">descriptions</code> and
the user has indicated an interest in having text descriptions with
- this <span>timed track language</span> and <span>timed track
- label</span> enabled, and there is no other <span>timed
+ this <span>text track language</span> and <span>text track
+ label</span> enabled, and there is no other <span>text
track</span> in the <span>media element</span>'s <span>list of
- timed tracks</span> with a <span>timed track kind</span> of <code
- title="dom-TimedTrack-kind-descriptions">descriptions</code> whose
- <span>timed track mode</span> is <span title="timed track
+ text tracks</span> with a <span>text track kind</span> of <code
+ title="dom-TextTrack-kind-descriptions">descriptions</code> whose
+ <span>text track mode</span> is <span title="text track
showing">showing</span></dt>
- <dt>If the <span>timed track kind</span> is <code
- title="dom-TimedTrack-kind-chapters">chapters</code> and the
- <span>timed track language</span> is one that the user agent has
+ <dt>If the <span>text track kind</span> is <code
+ title="dom-TextTrack-kind-chapters">chapters</code> and the
+ <span>text track language</span> is one that the user agent has
reason to believe is appropriate for the user, and there is no
- other <span>timed track</span> in the <span>media element</span>'s
- <span>list of timed tracks</span> with a <span>timed track
+ other <span>text track</span> in the <span>media element</span>'s
+ <span>list of text tracks</span> with a <span>text track
kind</span> of <code
- title="dom-TimedTrack-kind-chapters">chapters</code> whose
- <span>timed track mode</span> is <span title="timed track
+ title="dom-TextTrack-kind-chapters">chapters</code> whose
+ <span>text track mode</span> is <span title="text track
showing">showing</span></dt>
<dd>
- <p>Let the <span>timed track mode</span> be <span title="timed
+ <p>Let the <span>text track mode</span> be <span title="text
track showing">showing</span>.</p>
- <p>If there is a <span>timed track</span> in the <span>media
- element</span>'s <span>list of timed tracks</span> whose
- <span>timed track mode</span> is <span title="timed track showing
+ <p>If there is a <span>text track</span> in the <span>media
+ element</span>'s <span>list of text tracks</span> whose
+ <span>text track mode</span> is <span title="text track showing
by default">showing by default</span>, the user agent must
- furthermore change <em>that</em> <span>timed track</span>'s
- <span>timed track mode</span> to <span title="timed track
+ furthermore change <em>that</em> <span>text track</span>'s
+ <span>text track mode</span> to <span title="text track
hidden">hidden</span>.</p> <!-- so that we still get events and
stuff: we can expect authors to forget that default doesn't mean
that it'll always be turned on, and that they'll still rely on
@@ -30520,38 +30520,38 @@
<dt>If the <code>track</code> element has a <code
title="attr-track-default">default</code> attribute specified, and
- there is no other <span>timed track</span> in the <span>media
- element</span>'s <span>list of timed tracks</span> whose
- <span>timed track mode</span> is <span title="timed track
- showing">showing</span> or <span title="timed track
+ there is no other <span>text track</span> in the <span>media
+ element</span>'s <span>list of text tracks</span> whose
+ <span>text track mode</span> is <span title="text track
+ showing">showing</span> or <span title="text track
showing by default">showing by default</span></dt>
<dd>
- <p>Let the <span>timed track mode</span> be <span title="timed
+ <p>Let the <span>text track mode</span> be <span title="text
track showing by default">showing by default</span>.</p>
</dd>
<dt>Otherwise</dt>
<dd>
- <p>Let the <span>timed track mode</span> be <span title="timed
+ <p>Let the <span>text track mode</span> be <span title="text
track disabled">disabled</span>.</p>
</dd>
</dl>
- <p>When a <span>timed track</span> corresponding to a
- <code>track</code> element is created with <span>timed track
- mode</span> set to <span title="timed track hidden">hidden</span>,
- <span title="timed track showing">showing</span>, or <span
- title="timed track showing by default">showing by default</span>,
- and when a <span>timed track</span> corresponding to a
- <code>track</code> element is created with <span>timed track
- mode</span> set to <span title="timed track
- disabled">disabled</span> and subsequently changes its <span>timed
- track mode</span> to <span title="timed track hidden">hidden</span>,
- <span title="timed track showing">showing</span>, or <span
- title="timed track showing by default">showing by default</span> for
+ <p>When a <span>text track</span> corresponding to a
+ <code>track</code> element is created with <span>text track
+ mode</span> set to <span title="text track hidden">hidden</span>,
+ <span title="text track showing">showing</span>, or <span
+ title="text track showing by default">showing by default</span>,
+ and when a <span>text track</span> corresponding to a
+ <code>track</code> element is created with <span>text track
+ mode</span> set to <span title="text track
+ disabled">disabled</span> and subsequently changes its <span>text
+ track mode</span> to <span title="text track hidden">hidden</span>,
+ <span title="text track showing">showing</span>, or <span
+ title="text track showing by default">showing by default</span> for
the first time, the user agent must immediately and synchronously
run the following algorithm. This algorithm interacts closely with
the <span>event loop</span> mechanism; in particular, it has a
@@ -30561,15 +30561,15 @@
<ol>
- <li><p>Set the <span>timed track readiness state</span> to <span
- title="timed track loading">loading</span>.</p></li>
+ <li><p>Set the <span>text track readiness state</span> to <span
+ title="text track loading">loading</span>.</p></li>
<li><p>Let <var title="">URL</var> be the <span>track URL</span> of
the <code>track</code> element.</p></li>
<li><p>Asynchronously run the remaining steps, while continuing
- with whatever task was responsible for creating the <span>timed
- track</span> or changing the <span>timed track
+ with whatever task was responsible for creating the <span>text
+ track</span> or changing the <span>text track
mode</span>.</p></li>
<li>
@@ -30589,17 +30589,17 @@
resource's <span title="Content-Type">Content Type
metadata</span>, once it is available, if it ever is. If no <span
title="Content-Type">Content Type metadata</span> is ever
- available, or if the type is not recognised as a timed track
+ available, or if the type is not recognised as a text track
format, then the resource's format must be assumed to be
unsupported (this causes the load to fail, as described below). If
- a type is obtained, and represents a supported timed track format,
+ a type is obtained, and represents a supported text track format,
then the resource's data must be passed to the appropriate parser
<!--END w3c-html--><!--TTVTT-->
(e.g. the <span>WebVTT parser</span> if the <span
title="Content-Type">Content Type metadata</span> is
<code>text/vtt</code>)
<!--START w3c-html--><!--TTVTT-->
- as it is received, with the <span>timed
+ as it is received, with the <span>text
track list of cues</span> being used for that parser's output.</p>
<p>If the <span title="fetch">fetching algorithm</span> fails for
@@ -30608,8 +30608,8 @@
the empty string or has the wrong <span>origin</span> as
determined by the condition at the start of this step, or if the
fetched resource is not in a supported format, then <span>queue a
- task</span> to first change the <span>timed track readiness
- state</span> to <span title="timed track failed to load">failed to
+ task</span> to first change the <span>text track readiness
+ state</span> to <span title="text track failed to load">failed to
load</span> and then <span>fire a simple event</span> named <code
title="event-error">error</code> at the <code>track</code>
element; and then, once that <span
@@ -30619,8 +30619,8 @@
<p>If the <span title="fetch">fetching algorithm</span> does not
fail, then, when it completes, <span>queue a task</span> to first
- change the <span>timed track readiness state</span> to <span
- title="timed track loaded">loaded</span> and then <span>fire a
+ change the <span>text track readiness state</span> to <span
+ title="text track loaded">loaded</span> and then <span>fire a
simple event</span> named <code title="event-load">load</code> at
the <code>track</code> element; and then, once that <span
title="concept-task">task</span> is <span title="queue a
@@ -30633,15 +30633,15 @@
<ul>
<li>the <span>track URL</span> changes so that it is no longer
- equal to <var title="">URL</var>, while the <span>timed track
- mode</span> is set to <span title="timed track
- hidden">hidden</span>, <span title="timed track
- showing">showing</span>, or <span title="timed track showing by
+ equal to <var title="">URL</var>, while the <span>text track
+ mode</span> is set to <span title="text track
+ hidden">hidden</span>, <span title="text track
+ showing">showing</span>, or <span title="text track showing by
default">showing by default</span>; or</li>
- <li>the <span>timed track mode</span> changes to <span
- title="timed track hidden">hidden</span>, <span title="timed
- track showing">showing</span>, or <span title="timed track
+ <li>the <span>text track mode</span> changes to <span
+ title="text track hidden">hidden</span>, <span title="text
+ track showing">showing</span>, or <span title="text track
showing by default">showing by default</span>, while the
<span>track URL</span> is not equal to <var
title="">URL</var></li>
@@ -30674,21 +30674,21 @@
<li><p><i>Monitoring</i>: Wait until the <span>track URL</span> is
no longer equal to <var title="">URL</var>, at the same time as the
- <span>timed track mode</span> is set to <span title="timed track
- hidden">hidden</span>, <span title="timed track
- showing">showing</span>, or <span title="timed track showing by
+ <span>text track mode</span> is set to <span title="text track
+ hidden">hidden</span>, <span title="text track
+ showing">showing</span>, or <span title="text track showing by
default">showing by default</span>.</p></li>
- <li><p>Wait until the <span>timed track readiness state</span> is
- no longer set to <span title="timed track
+ <li><p>Wait until the <span>text track readiness state</span> is
+ no longer set to <span title="text track
loading">loading</span>.</p></li>
<li><p><span>Await a stable state</span>. The <span>synchronous
section</span> consists of the following step. (The step in the
<span>synchronous section</span> is marked with ⌛.)</p></li>
- <li><p>⌛ Set the <span>timed track readiness state</span> to
- <span title="timed track loading">loading</span>.</p></li>
+ <li><p>⌛ Set the <span>text track readiness state</span> to
+ <span title="text track loading">loading</span>.</p></li>
<!-- if you add more, change the grammar of the sentences above to
be plural with respect to the number of synchronous steps (both in
@@ -30708,54 +30708,54 @@
<div class="impl">
<h6><dfn>Guidelines for exposing cues</dfn> in various formats as
- <span title="timed track cue">timed track cues</span></h6>
+ <span title="text track cue">text track cues</span></h6>
- <p>How a specific format's timed track cues are to be interpreted
+ <p>How a specific format's text track cues are to be interpreted
for the purposes of processing by an HTML user agent is defined by
that format. In the absence of such a specification, this section
provides some constraints within which implementations can attempt
to consistently expose such formats.</p>
- <p>To support the <span>timed track</span> model of HTML, each unit
- of timed data is converted to a <span>timed track cue</span>. Where
- the mapping of the format's features to the aspects of a <span>timed
+ <p>To support the <span>text track</span> model of HTML, each unit
+ of timed data is converted to a <span>text track cue</span>. Where
+ the mapping of the format's features to the aspects of a <span>text
track cue</span> as defined in this specification are not defined,
implementations must ensure that the mapping is consistent with the
- definitions of the aspects of a <span>timed track cue</span> as
+ definitions of the aspects of a <span>text track cue</span> as
defined above, as well as with the following constraints:</p>
<dl>
- <dt>The <span>timed track cue identifier</span>
+ <dt>The <span>text track cue identifier</span>
<dd>
<p>Should be set to the empty string if the format has no
obvious analogue to a per-cue identifier.</p>
</dd>
- <dt>The <span>timed track cue pause-on-exit flag</span>
+ <dt>The <span>text track cue pause-on-exit flag</span>
<dd>
<p>Should be set to false.</p>
</dd>
- <dt>The <span>timed track cue writing direction</span>
+ <dt>The <span>text track cue writing direction</span>
<dd>
- <p>Should be set to <span title="timed track cue horizontal writing
+ <p>Should be set to <span title="text track cue horizontal writing
direction">horizontal</span> if the concept of writing direction
doesn't really apply (e.g. the cue consists of a bitmap
image).</p>
</dd>
- <dt>The <span>timed track cue snap-to-lines flag</span>
+ <dt>The <span>text track cue snap-to-lines flag</span>
<dd>
<p>Should be set to false unless the format uses a rendering and
positioning model for cues that is largely consistent with the
<span>WebVTT cue text rendering rules</span>.</p>
</dd>
- <dt>The <span>timed track cue line position</span>
- <dt>The <span>timed track cue text position</span>
- <dt>The <span>timed track cue size</span>
- <dt>The <span>timed track cue alignment</span>
+ <dt>The <span>text track cue line position</span>
+ <dt>The <span>text track cue text position</span>
+ <dt>The <span>text track cue size</span>
+ <dt>The <span>text track cue alignment</span>
<dd>
<p>If the format uses a rendering and positioning model for
cues that can be largely simulated using the <span>WebVTT cue text
@@ -30770,23 +30770,23 @@
<!--START w3c-html--><!--TTVTT-->
- <h6>Timed track API</h6>
+ <h6>Text track API</h6>
<dl class="domintro">
<dt><var title="">media</var> . <code title="dom-media-tracks">tracks</code> . <code title="">length</code></dt>
<dd>
- <p>Returns the number of <span title="timed track">timed tracks</span> associated with the <span>media element</span> (e.g. from <code>track</code> elements). This is the number of <span title="timed track">timed tracks</span> in the <span>media element</span>'s <span>list of timed tracks</span>.</p>
+ <p>Returns the number of <span title="text track">text tracks</span> associated with the <span>media element</span> (e.g. from <code>track</code> elements). This is the number of <span title="text track">text tracks</span> in the <span>media element</span>'s <span>list of text tracks</span>.</p>
</dd>
<dt><var title="">media</var> . <code title="dom-media-tracks">tracks[</code> <var title="">n</var> <code title="">]</code></dt>
<dd>
- <p>Returns the <code>TimedTrack</code> object representing the <var title="">n</var>th <span>timed track</span> in the <span>media element</span>'s <span>list of timed tracks</span>.</p>
+ <p>Returns the <code>TextTrack</code> object representing the <var title="">n</var>th <span>text track</span> in the <span>media element</span>'s <span>list of text tracks</span>.</p>
</dd>
<dt><var title="">track</var> . <code title="dom-track-track">track</code></dt>
<dd>
- <p>Returns the <code>TimedTrack</code> object representing the <code>track</code> element's <span>timed track</span>.</p>
+ <p>Returns the <code>TextTrack</code> object representing the <code>track</code> element's <span>text track</span>.</p>
</dd>
</dl>
@@ -30796,167 +30796,167 @@
<p>The <dfn title="dom-media-tracks"><code>tracks</code></dfn>
attribute of <span title="media element">media elements</span> must
return an <span title="array host objects">array host object</span>
- for objects of type <code>TimedTrack</code> that is <i>fixed
+ for objects of type <code>TextTrack</code> that is <i>fixed
length</i> and <i>read only</i>. The same object must be returned
each time the attribute is accessed. <a
href="#refsWEBIDL">[WEBIDL]</a></p>
- <p>The array must contain the <code>TimedTrack</code> objects of the
- <span title="timed track">timed tracks</span> in the <span>media
- element</span>'s <span>list of timed tracks</span>, in the same
- order as in the <span>list of timed tracks</span>.</p>
+ <p>The array must contain the <code>TextTrack</code> objects of the
+ <span title="text track">text tracks</span> in the <span>media
+ element</span>'s <span>list of text tracks</span>, in the same
+ order as in the <span>list of text tracks</span>.</p>
</div>
<hr>
- <pre class="idl">interface <dfn>TimedTrack</dfn> {
- readonly attribute DOMString <span title="dom-TimedTrack-kind">kind</span>;
- readonly attribute DOMString <span title="dom-TimedTrack-label">label</span>;
- readonly attribute DOMString <span title="dom-TimedTrack-language">language</span>;
+ <pre class="idl">interface <dfn>TextTrack</dfn> {
+ readonly attribute DOMString <span title="dom-TextTrack-kind">kind</span>;
+ readonly attribute DOMString <span title="dom-TextTrack-label">label</span>;
+ readonly attribute DOMString <span title="dom-TextTrack-language">language</span>;
- const unsigned short <span title="dom-TimedTrack-NONE">NONE</span> = 0;
- const unsigned short <span title="dom-TimedTrack-LOADING">LOADING</span> = 1;
- const unsigned short <span title="dom-TimedTrack-LOADED">LOADED</span> = 2;
- const unsigned short <span title="dom-TimedTrack-ERROR">ERROR</span> = 3;
- readonly attribute unsigned short <span title="dom-TimedTrack-readyState">readyState</span>;
- readonly attribute <span>Function</span> <span title="handler-TimedTrack-onload">onload</span>;
- readonly attribute <span>Function</span> <span title="handler-TimedTrack-onerror">onerror</span>;
+ const unsigned short <span title="dom-TextTrack-NONE">NONE</span> = 0;
+ const unsigned short <span title="dom-TextTrack-LOADING">LOADING</span> = 1;
+ const unsigned short <span title="dom-TextTrack-LOADED">LOADED</span> = 2;
+ const unsigned short <span title="dom-TextTrack-ERROR">ERROR</span> = 3;
+ readonly attribute unsigned short <span title="dom-TextTrack-readyState">readyState</span>;
+ readonly attribute <span>Function</span> <span title="handler-TextTrack-onload">onload</span>;
+ readonly attribute <span>Function</span> <span title="handler-TextTrack-onerror">onerror</span>;
- const unsigned short <span title="dom-TimedTrack-OFF">OFF</span> = 0;
- const unsigned short <span title="dom-TimedTrack-HIDDEN">HIDDEN</span> = 1;
- const unsigned short <span title="dom-TimedTrack-SHOWING">SHOWING</span> = 2;
- attribute unsigned short <span title="dom-TimedTrack-mode">mode</span>;
+ const unsigned short <span title="dom-TextTrack-OFF">OFF</span> = 0;
+ const unsigned short <span title="dom-TextTrack-HIDDEN">HIDDEN</span> = 1;
+ const unsigned short <span title="dom-TextTrack-SHOWING">SHOWING</span> = 2;
+ attribute unsigned short <span title="dom-TextTrack-mode">mode</span>;
- readonly attribute <span>TimedTrackCueList</span> <span title="dom-TimedTrack-cues">cues</span>;
- readonly attribute <span>TimedTrackCueList</span> <span title="dom-TimedTrack-activeCues">activeCues</span>;
+ readonly attribute <span>TextTrackCueList</span> <span title="dom-TextTrack-cues">cues</span>;
+ readonly attribute <span>TextTrackCueList</span> <span title="dom-TextTrack-activeCues">activeCues</span>;
- readonly attribute <span>Function</span> <span title="handler-TimedTrack-oncuechange">oncuechange</span>;
+ readonly attribute <span>Function</span> <span title="handler-TextTrack-oncuechange">oncuechange</span>;
};</pre>
<dl class="domintro">
- <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-kind">kind</code></dt>
+ <dt><var title="">timedTrack</var> . <code title="dom-TextTrack-kind">kind</code></dt>
<dd>
- <p>Returns the <span>timed track kind</span> string.</p>
+ <p>Returns the <span>text track kind</span> string.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-label">label</code></dt>
+ <dt><var title="">timedTrack</var> . <code title="dom-TextTrack-label">label</code></dt>
<dd>
- <p>Returns the <span>timed track label</span>.</p>
+ <p>Returns the <span>text track label</span>.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-language">language</code></dt>
+ <dt><var title="">timedTrack</var> . <code title="dom-TextTrack-language">language</code></dt>
<dd>
- <p>Returns the <span>timed track language</span> string.</p>
+ <p>Returns the <span>text track language</span> string.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-readyState">readyState</code></dt>
+ <dt><var title="">timedTrack</var> . <code title="dom-TextTrack-readyState">readyState</code></dt>
<dd>
- <p>Returns the <span>timed track readiness state</span>,
+ <p>Returns the <span>text track readiness state</span>,
represented by a number from the following list:</p>
<dl>
- <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-NONE">NONE</code> (0)</dt>
+ <dt><code>TextTrack</code> . <code title="dom-TextTrack-NONE">NONE</code> (0)</dt>
<dd>
- <p>The <span>timed track not loaded</span> state.</p>
+ <p>The <span>text track not loaded</span> state.</p>
</dd>
- <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-LOADING">LOADING</code> (1)</dt>
+ <dt><code>TextTrack</code> . <code title="dom-TextTrack-LOADING">LOADING</code> (1)</dt>
<dd>
- <p>The <span>timed track loading</span> state.</p>
+ <p>The <span>text track loading</span> state.</p>
</dd>
- <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-LOADED">LOADED</code> (2)</dt>
+ <dt><code>TextTrack</code> . <code title="dom-TextTrack-LOADED">LOADED</code> (2)</dt>
<dd>
- <p>The <span>timed track loaded</span> state.</p>
+ <p>The <span>text track loaded</span> state.</p>
</dd>
- <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-ERROR">ERROR</code> (3)</dt>
+ <dt><code>TextTrack</code> . <code title="dom-TextTrack-ERROR">ERROR</code> (3)</dt>
<dd>
- <p>The <span>timed track failed to load</span> state.</p>
+ <p>The <span>text track failed to load</span> state.</p>
</dd>
</dl>
</dd>
- <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-mode">mode</code></dt>
+ <dt><var title="">timedTrack</var> . <code title="dom-TextTrack-mode">mode</code></dt>
<dd>
- <p>Returns the <span>timed track mode</span>, represented by a
+ <p>Returns the <span>text track mode</span>, represented by a
number from the following list:</p>
<dl>
- <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-OFF">OFF</code> (0)</dt>
+ <dt><code>TextTrack</code> . <code title="dom-TextTrack-OFF">OFF</code> (0)</dt>
<dd>
- <p>The <span>timed track disabled</span> mode.</p>
+ <p>The <span>text track disabled</span> mode.</p>
</dd>
- <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-HIDDEN">HIDDEN</code> (1)</dt>
+ <dt><code>TextTrack</code> . <code title="dom-TextTrack-HIDDEN">HIDDEN</code> (1)</dt>
<dd>
- <p>The <span>timed track hidden</span> mode.</p>
+ <p>The <span>text track hidden</span> mode.</p>
</dd>
- <dt><code>TimedTrack</code> . <code title="dom-TimedTrack-SHOWING">SHOWING</code> (2)</dt>
+ <dt><code>TextTrack</code> . <code title="dom-TextTrack-SHOWING">SHOWING</code> (2)</dt>
<dd>
- <p>The <span>timed track showing</span> and <span title="timed track showing by default">showing by default</span> modes.</p>
+ <p>The <span>text track showing</span> and <span title="text track showing by default">showing by default</span> modes.</p>
</dd>
</dl>
<p>Can be set, to change the mode.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-cues">cues</code></dt>
+ <dt><var title="">timedTrack</var> . <code title="dom-TextTrack-cues">cues</code></dt>
<dd>
- <p>Returns the <span>timed track list of cues</span>, as a <code>TimedTrackCueList</code> object.</p>
+ <p>Returns the <span>text track list of cues</span>, as a <code>TextTrackCueList</code> object.</p>
</dd>
- <dt><var title="">timedTrack</var> . <code title="dom-TimedTrack-activeCues">activeCues</code></dt>
+ <dt><var title="">timedTrack</var> . <code title="dom-TextTrack-activeCues">activeCues</code></dt>
<dd>
- <p>Returns the <span title="timed track cue">timed track cues</span> from the <span>timed track list of cues</span> that are currently active (i.e. that start before the <span>current playback position</span> and end after it), as a <code>TimedTrackCueList</code> object.</p>
+ <p>Returns the <span title="text track cue">text track cues</span> from the <span>text track list of cues</span> that are currently active (i.e. that start before the <span>current playback position</span> and end after it), as a <code>TextTrackCueList</code> object.</p>
</dd>
</dl>
<div class="impl">
- <p>The <dfn title="dom-TimedTrack-kind"><code>kind</code></dfn>
- attribute must return the <span>timed track kind</span> of the
- <span>timed track</span> that the <code>TimedTrack</code> object
+ <p>The <dfn title="dom-TextTrack-kind"><code>kind</code></dfn>
+ attribute must return the <span>text track kind</span> of the
+ <span>text track</span> that the <code>TextTrack</code> object
represents.</p>
- <p>The <dfn title="dom-TimedTrack-label"><code>label</code></dfn>
- attribute must return the <span>timed track label</span> of the
- <span>timed track</span> that the <code>TimedTrack</code> object
+ <p>The <dfn title="dom-TextTrack-label"><code>label</code></dfn>
+ attribute must return the <span>text track label</span> of the
+ <span>text track</span> that the <code>TextTrack</code> object
represents.</p>
<p>The <dfn
- title="dom-TimedTrack-language"><code>language</code></dfn>
- attribute must return the <span>timed track language</span> of the
- <span>timed track</span> that the <code>TimedTrack</code> object
+ title="dom-TextTrack-language"><code>language</code></dfn>
+ attribute must return the <span>text track language</span> of the
+ <span>text track</span> that the <code>TextTrack</code> object
represents.</p>
<p>The <dfn
- title="dom-TimedTrack-readyState"><code>readyState</code></dfn>
+ title="dom-TextTrack-readyState"><code>readyState</code></dfn>
attribute must return the numeric value corresponding to the
- <span>timed track readiness state</span> of the <span>timed
- track</span> that the <code>TimedTrack</code> object represents, as
+ <span>text track readiness state</span> of the <span>text
+ track</span> that the <code>TextTrack</code> object represents, as
defined by the following list:</p>
<dl>
- <dt><dfn title="dom-TimedTrack-NONE"><code>NONE</code></dfn> (numeric value 0)</dt>
- <dd>The <span>timed track not loaded</span> state.</dd>
- <dt><dfn title="dom-TimedTrack-LOADING"><code>LOADING</code></dfn> (numeric value 1)</dt>
- <dd>The <span>timed track loading</span> state.</dd>
- <dt><dfn title="dom-TimedTrack-LOADED"><code>LOADED</code></dfn> (numeric value 2)</dt>
- <dd>The <span>timed track loaded</span> state.</dd>
- <dt><dfn title="dom-TimedTrack-ERROR"><code>ERROR</code></dfn> (numeric value 3)</dt>
- <dd>The <span>timed track failed to load</span> state.</dd>
+ <dt><dfn title="dom-TextTrack-NONE"><code>NONE</code></dfn> (numeric value 0)</dt>
+ <dd>The <span>text track not loaded</span> state.</dd>
+ <dt><dfn title="dom-TextTrack-LOADING"><code>LOADING</code></dfn> (numeric value 1)</dt>
+ <dd>The <span>text track loading</span> state.</dd>
+ <dt><dfn title="dom-TextTrack-LOADED"><code>LOADED</code></dfn> (numeric value 2)</dt>
+ <dd>The <span>text track loaded</span> state.</dd>
+ <dt><dfn title="dom-TextTrack-ERROR"><code>ERROR</code></dfn> (numeric value 3)</dt>
+ <dd>The <span>text track failed to load</span> state.</dd>
</dl>
- <p>The <dfn title="dom-TimedTrack-mode"><code>mode</code></dfn>
+ <p>The <dfn title="dom-TextTrack-mode"><code>mode</code></dfn>
attribute, on getting, must return the numeric value corresponding
- to the <span>timed track mode</span> of the <span>timed track</span>
- that the <code>TimedTrack</code> object represents, as defined by
+ to the <span>text track mode</span> of the <span>text track</span>
+ that the <code>TextTrack</code> object represents, as defined by
the following list:</p>
<dl>
- <dt><dfn title="dom-TimedTrack-OFF"><code>OFF</code></dfn> (numeric value 0)</dt>
- <dd>The <span>timed track disabled</span> mode.</dd>
- <dt><dfn title="dom-TimedTrack-HIDDEN"><code>HIDDEN</code></dfn> (numeric value 1)</dt>
- <dd>The <span>timed track hidden</span> mode.</dd>
- <dt><dfn title="dom-TimedTrack-SHOWING"><code>SHOWING</code></dfn> (numeric value 2)</dt>
- <dd>The <span>timed track showing</span> and <span title="timed track showing by default">showing by default</span> modes.</dd>
+ <dt><dfn title="dom-TextTrack-OFF"><code>OFF</code></dfn> (numeric value 0)</dt>
+ <dd>The <span>text track disabled</span> mode.</dd>
+ <dt><dfn title="dom-TextTrack-HIDDEN"><code>HIDDEN</code></dfn> (numeric value 1)</dt>
+ <dd>The <span>text track hidden</span> mode.</dd>
+ <dt><dfn title="dom-TextTrack-SHOWING"><code>SHOWING</code></dfn> (numeric value 2)</dt>
+ <dd>The <span>text track showing</span> and <span title="text track showing by default">showing by default</span> modes.</dd>
</dl>
<p>On setting, if the new value is not either 0, 1, or 2, the user
@@ -30971,9 +30971,9 @@
<dd>
- <p>Set the <span>timed track mode</span> of the <span>timed
- track</span> that the <code>TimedTrack</code> object represents to
- the <span>timed track disabled</span> mode.</p>
+ <p>Set the <span>text track mode</span> of the <span>text
+ track</span> that the <code>TextTrack</code> object represents to
+ the <span>text track disabled</span> mode.</p>
</dd>
@@ -30981,9 +30981,9 @@
<dd>
- <p>Set the <span>timed track mode</span> of the <span>timed
- track</span> that the <code>TimedTrack</code> object represents to
- the <span>timed track hidden</span> mode.</p>
+ <p>Set the <span>text track mode</span> of the <span>text
+ track</span> that the <code>TextTrack</code> object represents to
+ the <span>text track hidden</span> mode.</p>
</dd>
@@ -30991,31 +30991,31 @@
<dd>
- <p>Set the <span>timed track mode</span> of the <span>timed
- track</span> that the <code>TimedTrack</code> object represents to
- the <span>timed track showing</span> mode.</p>
+ <p>Set the <span>text track mode</span> of the <span>text
+ track</span> that the <code>TextTrack</code> object represents to
+ the <span>text track showing</span> mode.</p>
- <p class="note">If the mode had been <span title="timed track
+ <p class="note">If the mode had been <span title="text track
showing by default">showing by default</span>, this will change it
- to <span title="timed track showing">showing</span>, even though
- the value of <code title="dom-TimedTrack-mode">mode</code> would
+ to <span title="text track showing">showing</span>, even though
+ the value of <code title="dom-TextTrack-mode">mode</code> would
appear not to change.</p>
</dd>
</dl>
- <p>If the <span>timed track mode</span> of the <span>timed
- track</span> that the <code>TimedTrack</code> object represents is
- not the <span>timed track disabled</span> mode, then the <dfn
- title="dom-TimedTrack-cues"><code>cues</code></dfn> attribute must
- return a <span>live</span> <code>TimedTrackCueList</code> object
- that represents the subset of the <span>timed track list of
- cues</span> of the <span>timed track</span> that the
- <code>TimedTrack</code> object represents whose <span title="timed
+ <p>If the <span>text track mode</span> of the <span>text
+ track</span> that the <code>TextTrack</code> object represents is
+ not the <span>text track disabled</span> mode, then the <dfn
+ title="dom-TextTrack-cues"><code>cues</code></dfn> attribute must
+ return a <span>live</span> <code>TextTrackCueList</code> object
+ that represents the subset of the <span>text track list of
+ cues</span> of the <span>text track</span> that the
+ <code>TextTrack</code> object represents whose <span title="text
track cue start time">start times</span> occur before the
<span>earliest possible position when the script started</span>, in
- <span>timed track cue order</span>. Otherwise, it must return
+ <span>text track cue order</span>. Otherwise, it must return
null. When an object is returned, the same object must be returned
each time.</p>
@@ -31023,21 +31023,21 @@
is whatever the <span>earliest possible position</span> was the last
time the <span>event loop</span> reached step 1.</p>
- <p>If the <span>timed track mode</span> of the <span>timed
- track</span> that the <code>TimedTrack</code> object represents is
- not the <span>timed track disabled</span> mode, then the <dfn
- title="dom-TimedTrack-activeCues"><code>activeCues</code></dfn>
+ <p>If the <span>text track mode</span> of the <span>text
+ track</span> that the <code>TextTrack</code> object represents is
+ not the <span>text track disabled</span> mode, then the <dfn
+ title="dom-TextTrack-activeCues"><code>activeCues</code></dfn>
attribute must return a <span>live</span>
- <code>TimedTrackCueList</code> object that represents the subset of
- the <span>timed track list of cues</span> of the <span>timed
- track</span> that the <code>TimedTrack</code> object represents
+ <code>TextTrackCueList</code> object that represents the subset of
+ the <span>text track list of cues</span> of the <span>text
+ track</span> that the <code>TextTrack</code> object represents
whose <span>active flag was set when the script started</span>, in
- <span>timed track cue order</span>. Otherwise, it must return
+ <span>text track cue order</span>. Otherwise, it must return
null. When an object is returned, the same object must be returned
each time.</p>
- <p>A <span>timed track cue</span>'s <dfn>active flag was set when
- the script started</dfn> if its <span>timed track cue active
+ <p>A <span>text track cue</span>'s <dfn>active flag was set when
+ the script started</dfn> if its <span>text track cue active
flag</span> was set the last time the <span>event loop</span>
reached step 1.</p>
@@ -31045,28 +31045,28 @@
<hr>
- <pre class="idl">interface <dfn>MutableTimedTrack</dfn> : <span>TimedTrack</span> {
- void <span title="dom-MutableTimedTrack-addCue">addCue</span>(in <span>TimedTrackCue</span> cue);
- void <span title="dom-MutableTimedTrack-removeCue">removeCue</span>(in <span>TimedTrackCue</span> cue);
+ <pre class="idl">interface <dfn>MutableTextTrack</dfn> : <span>TextTrack</span> {
+ void <span title="dom-MutableTextTrack-addCue">addCue</span>(in <span>TextTrackCue</span> cue);
+ void <span title="dom-MutableTextTrack-removeCue">removeCue</span>(in <span>TextTrackCue</span> cue);
};</pre>
<dl class="domintro">
- <dt><var title="">mutableTimedTrack</var> = <var title="">media</var> . <code title="dom-media-addTrack">addTrack</code>( <var title="">kind</var> [, <var title="">label</var> [, <var title="">language</var> ] ] )</dt>
+ <dt><var title="">mutableTextTrack</var> = <var title="">media</var> . <code title="dom-media-addTrack">addTrack</code>( <var title="">kind</var> [, <var title="">label</var> [, <var title="">language</var> ] ] )</dt>
<dd>
- <p>Creates and returns a new <code>MutableTimedTrack</code> object, which is also added to the <span>media element</span>'s <span>list of timed tracks</span>.</p>
+ <p>Creates and returns a new <code>MutableTextTrack</code> object, which is also added to the <span>media element</span>'s <span>list of text tracks</span>.</p>
</dd>
- <dt><var title="">mutableTimedTrack</var> . <code title="dom-MutableTimedTrack-addCue">addCue</code>( <var title="">cue</var> )</dt>
+ <dt><var title="">mutableTextTrack</var> . <code title="dom-MutableTextTrack-addCue">addCue</code>( <var title="">cue</var> )</dt>
<dd>
- <p>Adds the given cue to <var title="">mutableTimedTrack</var>'s <span>timed track list of cues</span>.</p>
- <p>Raises an exception if the argument is null, associated with another <span>timed track</span>, or already in the list of cues.</p>
+ <p>Adds the given cue to <var title="">mutableTextTrack</var>'s <span>text track list of cues</span>.</p>
+ <p>Raises an exception if the argument is null, associated with another <span>text track</span>, or already in the list of cues.</p>
</dd>
- <dt><var title="">mutableTimedTrack</var> . <code title="dom-MutableTimedTrack-removeCue">removeCue</code>( <var title="">cue</var> )</dt>
+ <dt><var title="">mutableTextTrack</var> . <code title="dom-MutableTextTrack-removeCue">removeCue</code>( <var title="">cue</var> )</dt>
<dd>
- <p>Removes the given cue from <var title="">mutableTimedTrack</var>'s <span>timed track list of cues</span>.</p>
- <p>Raises an exception if the argument is null, associated with another <span>timed track</span>, or not in the list of cues.</p>
+ <p>Removes the given cue from <var title="">mutableTextTrack</var>'s <span>text track list of cues</span>.</p>
+ <p>Raises an exception if the argument is null, associated with another <span>text track</span>, or not in the list of cues.</p>
</dd>
</dl>
@@ -31088,11 +31088,11 @@
these steps:</p>
<ul class="brief">
- <li><code title="dom-TimedTrack-kind-subtitles">subtitles</code>
- <li><code title="dom-TimedTrack-kind-captions">captions</code>
- <li><code title="dom-TimedTrack-kind-descriptions">descriptions</code>
- <li><code title="dom-TimedTrack-kind-chapters">chapters</code>
- <li><code title="dom-TimedTrack-kind-metadata">metadata</code>
+ <li><code title="dom-TextTrack-kind-subtitles">subtitles</code>
+ <li><code title="dom-TextTrack-kind-captions">captions</code>
+ <li><code title="dom-TextTrack-kind-descriptions">descriptions</code>
+ <li><code title="dom-TextTrack-kind-chapters">chapters</code>
+ <li><code title="dom-TextTrack-kind-metadata">metadata</code>
</ul>
</li>
@@ -31113,18 +31113,18 @@
<li>
- <p>Create a new <span>timed track</span>, and set its <span>timed
- track kind</span> to <var title="">kind</var>, its <span>timed
- track label</span> to <var title="">label</var>, its <span>timed
+ <p>Create a new <span>text track</span>, and set its <span>text
+ track kind</span> to <var title="">kind</var>, its <span>text
+ track label</span> to <var title="">label</var>, its <span>text
track language</span> to <var title="">language</var>, its
- <span>timed track readiness state</span> to the <span>timed track
- loaded</span> state, its <span>timed track mode</span> to the
- <span>timed track hidden</span> mode, and its <span>timed track
+ <span>text track readiness state</span> to the <span>text track
+ loaded</span> state, its <span>text track mode</span> to the
+ <span>text track hidden</span> mode, and its <span>text track
list of cues</span> to an empty list.
<!--END w3c-html--><!--TTVTT-->
- Associate the <span>timed track list of cues</span> with the
- <span>rules for updating the display of WebVTT timed tracks</span>
- as its <span>rules for updating the timed track rendering</span>.
+ Associate the <span>text track list of cues</span> with the
+ <span>rules for updating the display of WebVTT text tracks</span>
+ as its <span>rules for updating the text track rendering</span>.
<!--START w3c-html--><!--TTVTT-->
</p>
@@ -31132,14 +31132,14 @@
<li>
- <p>Add the new <span>timed track</span> to the <span>media
- element</span>'s <span>list of timed tracks</span>.</p>
+ <p>Add the new <span>text track</span> to the <span>media
+ element</span>'s <span>list of text tracks</span>.</p>
</ol>
- <p>The <dfn title="dom-MutableTimedTrack-addCue"><code>addCue(<var
+ <p>The <dfn title="dom-MutableTextTrack-addCue"><code>addCue(<var
title="">cue</var>)</code></dfn> method of
- <code>MutableTimedTrack</code> objects, when invoked, must run the
+ <code>MutableTextTrack</code> objects, when invoked, must run the
following steps:</p>
<ol>
@@ -31149,31 +31149,31 @@
steps.</p></li>
<li><p>If the given <var title="">cue</var> is already associated
- with a <span>timed track</span> other than the method's
- <code>MutableTimedTrack</code> object's <span>timed track</span>,
+ with a <span>text track</span> other than the method's
+ <code>MutableTextTrack</code> object's <span>text track</span>,
then throw an <code>INVALID_STATE_ERR</code> exception and abort
these steps.</p></li>
<li><p>Associate <var title="">cue</var> with the method's
- <code>MutableTimedTrack</code> object's <span>timed track</span>,
- if it is not currently associated with a <span>timed
+ <code>MutableTextTrack</code> object's <span>text track</span>,
+ if it is not currently associated with a <span>text
track</span>.</p></li>
<li><p>If the given <var title="">cue</var> is already listed in
- the method's <code>MutableTimedTrack</code> object's <span>timed
- track</span>'s <span>timed track list of cues</span>, then throw an
+ the method's <code>MutableTextTrack</code> object's <span>text
+ track</span>'s <span>text track list of cues</span>, then throw an
<code>INVALID_STATE_ERR</code> exception.</p></li>
<li><p>Add <var title="">cue</var> to the method's
- <code>MutableTimedTrack</code> object's <span>timed track</span>'s
- <span>timed track list of cues</span>.</p></li>
+ <code>MutableTextTrack</code> object's <span>text track</span>'s
+ <span>text track list of cues</span>.</p></li>
</ol>
<p>The <dfn
- title="dom-MutableTimedTrack-removeCue"><code>removeCue(<var
+ title="dom-MutableTextTrack-removeCue"><code>removeCue(<var
title="">cue</var>)</code></dfn> method of
- <code>MutableTimedTrack</code> objects, when invoked, must run the
+ <code>MutableTextTrack</code> objects, when invoked, must run the
following steps:</p>
<ol>
@@ -31183,18 +31183,18 @@
steps.</p></li>
<li><p>If the given <var title="">cue</var> is not associated with
- the method's <code>MutableTimedTrack</code> object's <span>timed
+ the method's <code>MutableTextTrack</code> object's <span>text
track</span>, then throw an <code>INVALID_STATE_ERR</code>
exception.</p></li>
<li><p>If the given <var title="">cue</var> is not currently listed
- in the method's <code>MutableTimedTrack</code> object's <span>timed
- track</span>'s <span>timed track list of cues</span>, then throw a
+ in the method's <code>MutableTextTrack</code> object's <span>text
+ track</span>'s <span>text track list of cues</span>, then throw a
<code>NOT_FOUND_ERR</code> exception.</p></li>
<li><p>Remove <var title="">cue</var> from the method's
- <code>MutableTimedTrack</code> object's <span>timed track</span>'s
- <span>timed track list of cues</span>.</p></li>
+ <code>MutableTextTrack</code> object's <span>text track</span>'s
+ <span>text track list of cues</span>.</p></li>
</ol>
@@ -31213,8 +31213,8 @@
<pre>var sfx = new Audio('sfx.wav');
var sounds = a.addTrack('metadata');
// add sounds we care about
-sounds.addCue(new TimedTrackCue('dog bark', 12.783, 13.612, '', '', '', true));
-sounds.addCue(new TimedTrackCue('kitten mew', 13.612, 15.091, '', '', '', true));
+sounds.addCue(new TextTrackCue('dog bark', 12.783, 13.612, '', '', '', true));
+sounds.addCue(new TextTrackCue('kitten mew', 13.612, 15.091, '', '', '', true));
function playSound(id) {
sfx.currentTime = sounds.getCueById(id).startTime;
@@ -31233,27 +31233,27 @@
<hr>
- <pre class="idl">interface <dfn>TimedTrackCueList</dfn> {
- readonly attribute unsigned long <span title="dom-TimedTrackCueList-length">length</span>;
- getter <span>TimedTrackCue</span> (in unsigned long index);
- <span>TimedTrackCue</span> <span title="dom-TimedTrackCueList-getCueById">getCueById</span>(in DOMString id);
+ <pre class="idl">interface <dfn>TextTrackCueList</dfn> {
+ readonly attribute unsigned long <span title="dom-TextTrackCueList-length">length</span>;
+ getter <span>TextTrackCue</span> (in unsigned long index);
+ <span>TextTrackCue</span> <span title="dom-TextTrackCueList-getCueById">getCueById</span>(in DOMString id);
};</pre>
<dl class="domintro">
- <dt><var title="">cuelist</var> . <code title="dom-TimedTrackCueList-length">length</code></dt>
+ <dt><var title="">cuelist</var> . <code title="dom-TextTrackCueList-length">length</code></dt>
<dd>
- <p>Returns the number of <span title="timed track cue">cues</span> in the list.</p>
+ <p>Returns the number of <span title="text track cue">cues</span> in the list.</p>
</dd>
<dt><var title="">cuelist</var>[<var title="">index</var>]</dt>
<dd>
- <p>Returns the <span>timed track cue</span> with index <var title="">index</var> in the list. The cues are sorted in <span>timed track cue order</span>.</p>
+ <p>Returns the <span>text track cue</span> with index <var title="">index</var> in the list. The cues are sorted in <span>text track cue order</span>.</p>
</dd>
- <dt><var title="">cuelist</var> . <code title="dom-TimedTrackCueList-getCueById">getCueById</code>( <var title="">id</var> )</dt>
+ <dt><var title="">cuelist</var> . <code title="dom-TextTrackCueList-getCueById">getCueById</code>( <var title="">id</var> )</dt>
<dd>
- <p>Returns the first <span>timed track cue</span> (in <span>timed track cue order</span>) with <span>timed track cue identifier</span> <var title="">id</var>.</p>
+ <p>Returns the first <span>text track cue</span> (in <span>text track cue order</span>) with <span>text track cue identifier</span> <var title="">id</var>.</p>
<p>Returns null if none of the cues have the given identifier or if the argument is the empty string.</p>
</dd>
@@ -31261,35 +31261,35 @@
<div class="impl">
- <p>A <code>TimedTrackCueList</code> object represents a dynamically
- updating list of <span title="timed track cue">timed track
+ <p>A <code>TextTrackCueList</code> object represents a dynamically
+ updating list of <span title="text track cue">text track
cues</span> in a given order.</p>
<p>The <dfn
- title="dom-TimedTrackCueList-length"><code>length</code></dfn>
- attribute must return the number of <span title="timed track
+ title="dom-TextTrackCueList-length"><code>length</code></dfn>
+ attribute must return the number of <span title="text track
cue">cues</span> in the list represented by the
- <code>TimedTrackCueList</code> object.</p>
+ <code>TextTrackCueList</code> object.</p>
<p>The <span>supported property indicies</span> of a
- <code>TimedTrackCueList</code> object at any instant are the numbers
- from zero to the number of <span title="timed track cue">cues</span>
- in the list represented by the <code>TimedTrackCueList</code> object
- minus one, if any. If there are no <span title="timed track
+ <code>TextTrackCueList</code> object at any instant are the numbers
+ from zero to the number of <span title="text track cue">cues</span>
+ in the list represented by the <code>TextTrackCueList</code> object
+ minus one, if any. If there are no <span title="text track
cue">cues</span> in the list, there are no <span>supported property
indicies</span>.</p>
<p>To <span>determine the value of an indexed property</span> for a
given index <var title="">index</var>, the user agent must return
- the <var title="">index</var>th <span>timed track cue</span> in the
- list represented by the <code>TimedTrackCueList</code> object.</p>
+ the <var title="">index</var>th <span>text track cue</span> in the
+ list represented by the <code>TextTrackCueList</code> object.</p>
<p>The <dfn
- title="dom-TimedTrackCueList-getCueById"><code>getCueById(<var
+ title="dom-TextTrackCueList-getCueById"><code>getCueById(<var
title="">id</var>)</code></dfn> method, when called with an argument
- other than the empty string, must return the first <span>timed track
+ other than the empty string, must return the first <span>text track
cue</span> in the list represented by the
- <code>TimedTrackCueList</code> object whose <span>timed track cue
+ <code>TextTrackCueList</code> object whose <span>text track cue
identifier</span> is <var title="">id</var>, if any, or null
otherwise. If the argument is the empty string, then the method must
return null.</p>
@@ -31300,132 +31300,132 @@
<pre class="idl">
<!--END w3c-html--><!--TTVTT-->
-[<span title="dom-TimedTrackCue">Constructor</span>(in DOMString id, in double startTime, in double endTime, in DOMString text, in optional DOMString settings, in optional boolean pauseOnExit)]
+[<span title="dom-TextTrackCue">Constructor</span>(in DOMString id, in double startTime, in double endTime, in DOMString text, in optional DOMString settings, in optional boolean pauseOnExit)]
<!--START w3c-html--><!--TTVTT-->
-interface <dfn>TimedTrackCue</dfn> {
- readonly attribute <span>TimedTrack</span> <span title="dom-TimedTrackCue-track">track</span>;
- readonly attribute DOMString <span title="dom-TimedTrackCue-id">id</span>;
+interface <dfn>TextTrackCue</dfn> {
+ readonly attribute <span>TextTrack</span> <span title="dom-TextTrackCue-track">track</span>;
+ readonly attribute DOMString <span title="dom-TextTrackCue-id">id</span>;
- readonly attribute double <span title="dom-TimedTrackCue-startTime">startTime</span>;
- readonly attribute double <span title="dom-TimedTrackCue-endTime">endTime</span>;
- readonly attribute boolean <span title="dom-TimedTrackCue-pauseOnExit">pauseOnExit</span>;
+ readonly attribute double <span title="dom-TextTrackCue-startTime">startTime</span>;
+ readonly attribute double <span title="dom-TextTrackCue-endTime">endTime</span>;
+ readonly attribute boolean <span title="dom-TextTrackCue-pauseOnExit">pauseOnExit</span>;
<!--END w3c-html--><!--TTVTT-->
- readonly attribute DOMString <span title="dom-TimedTrackCue-direction">direction</span>;
- readonly attribute boolean <span title="dom-TimedTrackCue-snapToLines">snapToLines</span>;
- readonly attribute long <span title="dom-TimedTrackCue-linePosition">linePosition</span>;
- readonly attribute long <span title="dom-TimedTrackCue-textPosition">textPosition</span>;
- readonly attribute long <span title="dom-TimedTrackCue-size">size</span>;
- readonly attribute DOMString <span title="dom-TimedTrackCue-alignment">alignment</span>;
+ readonly attribute DOMString <span title="dom-TextTrackCue-direction">direction</span>;
+ readonly attribute boolean <span title="dom-TextTrackCue-snapToLines">snapToLines</span>;
+ readonly attribute long <span title="dom-TextTrackCue-linePosition">linePosition</span>;
+ readonly attribute long <span title="dom-TextTrackCue-textPosition">textPosition</span>;
+ readonly attribute long <span title="dom-TextTrackCue-size">size</span>;
+ readonly attribute DOMString <span title="dom-TextTrackCue-alignment">alignment</span>;
<!--START w3c-html--><!--TTVTT-->
- DOMString <span title="dom-TimedTrackCue-getCueAsSource()">getCueAsSource</span>();
- <span>DocumentFragment</span> <span title="dom-TimedTrackCue-getCueAsHTML()">getCueAsHTML</span>();
+ DOMString <span title="dom-TextTrackCue-getCueAsSource">getCueAsSource</span>();
+ <span>DocumentFragment</span> <span title="dom-TextTrackCue-getCueAsHTML">getCueAsHTML</span>();
- readonly attribute <span>Function</span> <span title="handler-TimedTrackCue-onenter">onenter</span>;
- readonly attribute <span>Function</span> <span title="handler-TimedTrackCue-onexit">onexit</span>;
+ readonly attribute <span>Function</span> <span title="handler-TextTrackCue-onenter">onenter</span>;
+ readonly attribute <span>Function</span> <span title="handler-TextTrackCue-onexit">onexit</span>;
};</pre>
<dl class="domintro">
<!--END w3c-html--><!--TTVTT-->
- <dt><var title="">cue</var> = new <code title="dom-TimedTrackCue">TimedTrackCue</code>( <var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var> [, <var title="">settings</var> [, <var title="">pauseOnExit</var> ] ] )</dt>
+ <dt><var title="">cue</var> = new <code title="dom-TextTrackCue">TextTrackCue</code>( <var title="">id</var>, <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var> [, <var title="">settings</var> [, <var title="">pauseOnExit</var> ] ] )</dt>
<dd>
- <p>Returns a new <code>TimedTrackCue</code> object, for use with the <code title="dom-MutableTimedTrack-addCue">addCue()</code> method.</p>
- <p>The <var title="">id</var> argument sets the <span>timed track cue identifier</span>.</p>
- <p>The <var title="">startTime</var> argument sets the <span>timed track cue start time</span>.</p>
- <p>The <var title="">endTime</var> argument sets the <span>timed track cue end time</span>.</p>
- <p>The <var title="">text</var> argument sets the <span>timed track cue text</span>.</p>
+ <p>Returns a new <code>TextTrackCue</code> object, for use with the <code title="dom-MutableTextTrack-addCue">addCue()</code> method.</p>
+ <p>The <var title="">id</var> argument sets the <span>text track cue identifier</span>.</p>
+ <p>The <var title="">startTime</var> argument sets the <span>text track cue start time</span>.</p>
+ <p>The <var title="">endTime</var> argument sets the <span>text track cue end time</span>.</p>
+ <p>The <var title="">text</var> argument sets the <span>text track cue text</span>.</p>
<p>The <var title="">settings</var> argument is a string in the format of <span>WebVTT cue settings</span>. If omitted, the empty string is assumed.</p>
- <p>The <var title="">pauseOnExit</var> argument sets the <span>timed track cue pause-on-exit flag</span>. If omitted, false is assumed.</p>
+ <p>The <var title="">pauseOnExit</var> argument sets the <span>text track cue pause-on-exit flag</span>. If omitted, false is assumed.</p>
</dd>
<!--START w3c-html--><!--TTVTT-->
- <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-track">track</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-track">track</span></dt>
<dd>
- <p>Returns the <code>TimedTrack</code> object to which this
- <span>timed track cue</span> belongs, if any, or null
+ <p>Returns the <code>TextTrack</code> object to which this
+ <span>text track cue</span> belongs, if any, or null
otherwise.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-id">id</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-id">id</span></dt>
<dd>
- <p>Returns the <span>timed track cue identifier</span>.</p>
+ <p>Returns the <span>text track cue identifier</span>.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-startTime">startTime</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-startTime">startTime</span></dt>
<dd>
- <p>Returns the <span>timed track cue start time</span>, in seconds.</p>
+ <p>Returns the <span>text track cue start time</span>, in seconds.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-endTime">endTime</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-endTime">endTime</span></dt>
<dd>
- <p>Returns the <span>timed track cue end time</span>, in seconds.</p>
+ <p>Returns the <span>text track cue end time</span>, in seconds.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-pauseOnExit">pauseOnExit</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-pauseOnExit">pauseOnExit</span></dt>
<dd>
- <p>Returns true if the <span>timed track cue pause-on-exit flag</span> is set, false otherwise.</p>
+ <p>Returns true if the <span>text track cue pause-on-exit flag</span> is set, false otherwise.</p>
</dd>
<!--END w3c-html--><!--TTVTT-->
- <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-direction">direction</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-direction">direction</span></dt>
<dd>
- <p>Returns a string representing the <span>timed track cue writing direction</span>, as follows:</p>
+ <p>Returns a string representing the <span>text track cue writing direction</span>, as follows:</p>
<dl class="switch">
- <dt>If it is <span title="timed track cue horizontal writing direction">horizontal</span></dt>
+ <dt>If it is <span title="text track cue horizontal writing direction">horizontal</span></dt>
<dd><p>The string "<code title="">horizontal</code>".</p></dd>
- <dt>If it is <span title="timed track cue vertical growing left writing direction">vertical growing left</span></dt>
+ <dt>If it is <span title="text track cue vertical growing left writing direction">vertical growing left</span></dt>
<dd><p>The string "<code title="">vertical</code>".</p></dd>
- <dt>If it is <span title="timed track cue vertical growing right writing direction">vertical growing right</span></dt>
+ <dt>If it is <span title="text track cue vertical growing right writing direction">vertical growing right</span></dt>
<dd><p>The string "<code title="">vertical-lr</code>".</p></dd>
</dl>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-snapToLines">snapToLines</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-snapToLines">snapToLines</span></dt>
<dd>
- <p>Returns true if the <span>timed track cue snap-to-lines flag</span> is set, false otherwise.</p>
+ <p>Returns true if the <span>text track cue snap-to-lines flag</span> is set, false otherwise.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-linePosition">linePosition</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-linePosition">linePosition</span></dt>
<dd>
- <p>Returns the <span>timed track cue line position</span>. In the
- case of the value being <span title="timed track cue automatic
+ <p>Returns the <span>text track cue line position</span>. In the
+ case of the value being <span title="text track cue automatic
line position">auto</span>, the appropriate default is returned.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-textPosition">textPosition</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-textPosition">textPosition</span></dt>
<dd>
- <p>Returns the <span>timed track cue text position</span>.</p>
+ <p>Returns the <span>text track cue text position</span>.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-size">size</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-size">size</span></dt>
<dd>
- <p>Returns the <span>timed track cue size</span>.</p>
+ <p>Returns the <span>text track cue size</span>.</p>
</dd>
- <dt><var title="">cue</var> . <span title="dom-TimedTrackCue-alignment">alignment</span></dt>
+ <dt><var title="">cue</var> . <span title="dom-TextTrackCue-alignment">alignment</span></dt>
<dd>
- <p>Returns a string representing the <span>timed track cue alignment</span>, as follows:</p>
+ <p>Returns a string representing the <span>text track cue alignment</span>, as follows:</p>
<dl class="switch">
- <dt>If it is <span title="timed track cue start alignment">start alignment</span></dt>
+ <dt>If it is <span title="text track cue start alignment">start alignment</span></dt>
<dd><p>The string "<code title="">start</code>".</p></dd>
- <dt>If it is <span title="timed track cue middle alignment">middle alignment</span></dt>
+ <dt>If it is <span title="text track cue middle alignment">middle alignment</span></dt>
<dd><p>The string "<code title="">middle</code>".</p></dd>
- <dt>If it is <span title="timed track cue end alignment">end alignment</span></dt>
+ <dt>If it is <span title="text track cue end alignment">end alignment</span></dt>
<dd><p>The string "<code title="">end</code>".</p></dd>
</dl>
</dd>
<!--START w3c-html--><!--TTVTT-->
- <dt><var title="">source</var> = <var title="">cue</var> . <span title="dom-TimedTrackCue-getCueAsSource">getCueAsSource</span>()</dt>
+ <dt><var title="">source</var> = <var title="">cue</var> . <span title="dom-TextTrackCue-getCueAsSource">getCueAsSource</span>()</dt>
<dd>
- <p>Returns the <span>timed track cue text</span> in raw unparsed form.</p>
+ <p>Returns the <span>text track cue text</span> in raw unparsed form.</p>
</dd>
- <dt><var title="">fragment</var> = <var title="">cue</var> . <span title="dom-TimedTrackCue-getCueAsHTML">getCueAsHTML</span>()</dt>
+ <dt><var title="">fragment</var> = <var title="">cue</var> . <span title="dom-TextTrackCue-getCueAsHTML">getCueAsHTML</span>()</dt>
<dd>
- <p>Returns the <span>timed track cue text</span> as a <code>DocumentFragment</code> of <span>HTML elements</span> and other DOM nodes.</p>
+ <p>Returns the <span>text track cue text</span> as a <code>DocumentFragment</code> of <span>HTML elements</span> and other DOM nodes.</p>
</dd>
</dl>
@@ -31433,7 +31433,7 @@
<div class="impl">
<!--END w3c-html--><!--TTVTT-->
- <p>The <dfn title="dom-TimedTrackCue"><code>TimedTrackCue(<var
+ <p>The <dfn title="dom-TextTrackCue"><code>TextTrackCue(<var
title="">id</var>, <var title="">startTime</var>, <var
title="">endTime</var>, <var title="">text</var>, <var
title="">settings</var>, <var
@@ -31442,28 +31442,28 @@
<ol>
- <li><p>Create a new <span>timed track cue</span> that is not
- associated with any <span>timed track</span>. Let <var
- title="">cue</var> be that <span>timed track cue</span>.</p></li>
+ <li><p>Create a new <span>text track cue</span> that is not
+ associated with any <span>text track</span>. Let <var
+ title="">cue</var> be that <span>text track cue</span>.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
identifier</span> be the value of the <var title="">id</var>
argument.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue start
+ <li><p>Let <var title="">cue</var>'s <span>text track cue start
time</span> be the value of the <var title="">startTime</var>
argument, interpreted as a time in seconds.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue end
+ <li><p>Let <var title="">cue</var>'s <span>text track cue end
time</span> be the value of the <var title="">endTime</var>
argument, interpreted as a time in seconds.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
pause-on-exit flag</span> be true if the <var
title="">pauseOnExit</var> is present and true. Otherwise, let it
be false.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
text</span> be the value of the <var title="">text</var> argument,
and let the rules for its interpretation be the <span>WebVTT cue
text parsing rules</span>, the <span>WebVTT cue text rendering
@@ -31472,25 +31472,25 @@
<!-- default settings -->
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
- writing direction</span> be <span title="timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
+ writing direction</span> be <span title="text track cue
horizontal writing direction">horizontal</span>.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
snap-to-lines flag</span> be true.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue line
- position</span> be <span title="timed track cue automatic line
+ <li><p>Let <var title="">cue</var>'s <span>text track cue line
+ position</span> be <span title="text track cue automatic line
position">auto</span>.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
text position</span> be 50.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
size</span> be 100.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
- alignment</span> be <span title="timed track cue middle
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
+ alignment</span> be <span title="text track cue middle
alignment">middle alignment</span>.</p></li>
<li><p>Let <var title="">input</var> be the string given by the
@@ -31503,89 +31503,89 @@
<li><p><span>Parse the WebVTT settings</span> for <var
title="">cue</var>.</p></li>
- <li><p>Return the <code>TimedTrackCue</code> object representing
+ <li><p>Return the <code>TextTrackCue</code> object representing
<var title="">cue</var>.</p></li>
</ol>
<!--START w3c-html--><!--TTVTT-->
- <p>The <dfn title="dom-TimedTrackCue-track"><code>track</code></dfn>
- attribute must return the <code>TimedTrack</code> object of the
- <span>timed track</span> with which the <span>timed track cue</span>
- that the <code>TimedTrackCue</code> object represents is associated,
+ <p>The <dfn title="dom-TextTrackCue-track"><code>track</code></dfn>
+ attribute must return the <code>TextTrack</code> object of the
+ <span>text track</span> with which the <span>text track cue</span>
+ that the <code>TextTrackCue</code> object represents is associated,
if any; or null otherwise.</p>
- <p>The <dfn title="dom-TimedTrackCue-id"><code>id</code></dfn>
- attribute must return the <span>timed track cue identifier</span> of
- the <span>timed track cue</span> that the <code>TimedTrackCue</code>
+ <p>The <dfn title="dom-TextTrackCue-id"><code>id</code></dfn>
+ attribute must return the <span>text track cue identifier</span> of
+ the <span>text track cue</span> that the <code>TextTrackCue</code>
object represents.</p>
<p>The <dfn
- title="dom-TimedTrackCue-startTime"><code>startTime</code></dfn>
- attribute must return the <span>timed track cue start time</span> of
- the <span>timed track cue</span> that the <code>TimedTrackCue</code>
+ title="dom-TextTrackCue-startTime"><code>startTime</code></dfn>
+ attribute must return the <span>text track cue start time</span> of
+ the <span>text track cue</span> that the <code>TextTrackCue</code>
object represents, in seconds.</p>
<p>The <dfn
- title="dom-TimedTrackCue-endTime"><code>endTime</code></dfn>
- attribute must return the <span>timed track cue end time</span> of
- the <span>timed track cue</span> that the <code>TimedTrackCue</code>
+ title="dom-TextTrackCue-endTime"><code>endTime</code></dfn>
+ attribute must return the <span>text track cue end time</span> of
+ the <span>text track cue</span> that the <code>TextTrackCue</code>
object represents, in seconds.</p>
<p>The <dfn
- title="dom-TimedTrackCue-pauseOnExit"><code>pauseOnExit</code></dfn>
- attribute must return true if the <span>timed track cue
- pause-on-exit flag</span> of the <span>timed track cue</span> that
- the <code>TimedTrackCue</code> object represents is set; or false
+ title="dom-TextTrackCue-pauseOnExit"><code>pauseOnExit</code></dfn>
+ attribute must return true if the <span>text track cue
+ pause-on-exit flag</span> of the <span>text track cue</span> that
+ the <code>TextTrackCue</code> object represents is set; or false
otherwise.</p>
<p>The <dfn
- title="dom-TimedTrackCue-direction"><code>direction</code></dfn>
- attribute must return the <span>timed track cue writing
- direction</span> of the <span>timed track cue</span> that the
- <code>TimedTrackCue</code> object represents.</p>
+ title="dom-TextTrackCue-direction"><code>direction</code></dfn>
+ attribute must return the <span>text track cue writing
+ direction</span> of the <span>text track cue</span> that the
+ <code>TextTrackCue</code> object represents.</p>
<!--END w3c-html--><!--TTVTT-->
<p>The <dfn
- title="dom-TimedTrackCue-snapToLines"><code>snapToLines</code></dfn>
- attribute must return true if the <span>timed track cue
- snap-to-lines flag</span> of the <span>timed track cue</span> that
- the <code>TimedTrackCue</code> object represents is set; or false
+ title="dom-TextTrackCue-snapToLines"><code>snapToLines</code></dfn>
+ attribute must return true if the <span>text track cue
+ snap-to-lines flag</span> of the <span>text track cue</span> that
+ the <code>TextTrackCue</code> object represents is set; or false
otherwise.</p>
<p>The <dfn
- title="dom-TimedTrackCue-linePosition"><code>linePosition</code></dfn>
- attribute must return the <span>timed track cue line position</span>
- of the <span>timed track cue</span> that the
- <code>TimedTrackCue</code> object represents, if that value is
+ title="dom-TextTrackCue-linePosition"><code>linePosition</code></dfn>
+ attribute must return the <span>text track cue line position</span>
+ of the <span>text track cue</span> that the
+ <code>TextTrackCue</code> object represents, if that value is
numeric. Otherwise, the value is the special value <span
- title="timed track cue automatic line position">auto</span>; if the
- <span>timed track cue snap-to-lines flag</span> of the <span>timed
- track cue</span> that the <code>TimedTrackCue</code> object
+ title="text track cue automatic line position">auto</span>; if the
+ <span>text track cue snap-to-lines flag</span> of the <span>text
+ track cue</span> that the <code>TextTrackCue</code> object
represents is not set, the attribute must return the value 100;
otherwise, it must return the value returned by the following
algorithm:</p>
<ol>
- <li><p>Let <var title="">cue</var> be the <span>timed track
- cue</span> that the <code>TimedTrackCue</code> object
+ <li><p>Let <var title="">cue</var> be the <span>text track
+ cue</span> that the <code>TextTrackCue</code> object
represents.</p></li>
<li><p>If <var title="">cue</var> is not associated with a
- <span>timed track</span>, return −1 and abort these
+ <span>text track</span>, return −1 and abort these
steps.</p></li>
- <li><p>Let <var title="">track</var> be the <span>timed
+ <li><p>Let <var title="">track</var> be the <span>text
track</span> that the <var title="">cue</var> is associated
with.</p></li>
<li><p>Let <var title="">n</var> be the number of <span
- title="timed track">timed tracks</span> whose <span>timed track
- mode</span> is <span title="timed track showing">showing</span> or
- <span title="timed track showing by default">showing by
+ title="text track">text tracks</span> whose <span>text track
+ mode</span> is <span title="text track showing">showing</span> or
+ <span title="text track showing by default">showing by
default</span> and that are in the <span>media element</span>'s
- <span>list of timed tracks</span> before <var
+ <span>list of text tracks</span> before <var
title="">track</var>.</p></li>
<li><p>Return <var title="">n</var>.</p></li>
@@ -31593,30 +31593,30 @@
</ol>
<p>The <dfn
- title="dom-TimedTrackCue-textPosition"><code>textPosition</code></dfn>
- attribute must return the <span>timed track cue text position</span>
- of the <span>timed track cue</span> that the
- <code>TimedTrackCue</code> object represents.</p>
+ title="dom-TextTrackCue-textPosition"><code>textPosition</code></dfn>
+ attribute must return the <span>text track cue text position</span>
+ of the <span>text track cue</span> that the
+ <code>TextTrackCue</code> object represents.</p>
- <p>The <dfn title="dom-TimedTrackCue-size"><code>size</code></dfn>
- attribute must return the <span>timed track cue size</span> of the
- <span>timed track cue</span> that the <code>TimedTrackCue</code>
+ <p>The <dfn title="dom-TextTrackCue-size"><code>size</code></dfn>
+ attribute must return the <span>text track cue size</span> of the
+ <span>text track cue</span> that the <code>TextTrackCue</code>
object represents.</p>
<p>The <dfn
- title="dom-TimedTrackCue-alignment"><code>alignment</code></dfn>
- attribute must return the <span>timed track cue alignment</span> of
- the <span>timed track cue</span> that the <code>TimedTrackCue</code>
+ title="dom-TextTrackCue-alignment"><code>alignment</code></dfn>
+ attribute must return the <span>text track cue alignment</span> of
+ the <span>text track cue</span> that the <code>TextTrackCue</code>
object represents.</p>
<!--START w3c-html--><!--TTVTT-->
<p>The <dfn
- title="dom-TimedTrackCue-getCueAsSource()"><code>getCueAsSource()</code></dfn>
- method must return the raw <span>timed track cue text</span>.</p>
+ title="dom-TextTrackCue-getCueAsSource"><code>getCueAsSource()</code></dfn>
+ method must return the raw <span>text track cue text</span>.</p>
<p>The <dfn
- title="dom-TimedTrackCue-getCueAsHTML()"><code>getCueAsHTML()</code></dfn>
- method must convert the <span>timed track cue text</span> to a
+ title="dom-TextTrackCue-getCueAsHTML"><code>getCueAsHTML()</code></dfn>
+ method must convert the <span>text track cue text</span> to a
<code>DocumentFragment</code> for the <span>media element</span>'s
<code>Document</code>, using the appropriate rules for doing
so.
@@ -31636,27 +31636,27 @@
<p>The following are the <span>event handlers</span> that must be
supported, as IDL attributes, by all objects implementing the
- <code>TimedTrack</code> interface:</p>
+ <code>TextTrack</code> interface:</p>
<table>
<thead>
<tr><th><span title="event handlers">Event handler</span> <th><span>Event handler event type</span>
<tbody>
- <tr><td><dfn title="handler-TimedTrack-onload"><code>onload</code></dfn> <td> <code title="event-load">load</code>
- <tr><td><dfn title="handler-TimedTrack-onerror"><code>onerror</code></dfn> <td> <code title="event-error">error</code>
- <tr><td><dfn title="handler-TimedTrack-oncuechange"><code>oncuechange</code></dfn> <td> <code title="event-cuechange">cuechange</code>
+ <tr><td><dfn title="handler-TextTrack-onload"><code>onload</code></dfn> <td> <code title="event-load">load</code>
+ <tr><td><dfn title="handler-TextTrack-onerror"><code>onerror</code></dfn> <td> <code title="event-error">error</code>
+ <tr><td><dfn title="handler-TextTrack-oncuechange"><code>oncuechange</code></dfn> <td> <code title="event-cuechange">cuechange</code>
</table>
<p>The following are the <span>event handlers</span> that must be
supported, as IDL attributes, by all objects implementing the
- <code>TimedTrackCue</code> interface:</p>
+ <code>TextTrackCue</code> interface:</p>
<table>
<thead>
<tr><th><span title="event handlers">Event handler</span> <th><span>Event handler event type</span>
<tbody>
- <tr><td><dfn title="handler-TimedTrackCue-onenter"><code>onenter</code></dfn> <td> <code title="event-enter">enter</code>
- <tr><td><dfn title="handler-TimedTrackCue-onexit"><code>onexit</code></dfn> <td> <code title="event-exit">exit</code>
+ <tr><td><dfn title="handler-TextTrackCue-onenter"><code>onenter</code></dfn> <td> <code title="event-enter">enter</code>
+ <tr><td><dfn title="handler-TextTrackCue-onexit"><code>onexit</code></dfn> <td> <code title="event-exit">exit</code>
</table>
</div>
@@ -31666,8 +31666,8 @@
<!--START webvtt-->
<h5>WebVTT</h5>
- <p>The <dfn>WebVTT</dfn> format (Web Subtitle Resource Tracks) is a
- format intended for marking up external timed track resources.</p>
+ <p>The <dfn>WebVTT</dfn> format (Web Video Text Tracks) is a
+ format intended for marking up external text track resources.</p>
<h6>Syntax</h6>
@@ -31722,7 +31722,7 @@
to only having <span>WebVTT cue text</span> as their <span>cue
payload</span>; <span>WebVTT metadata text</span> cues are only
useful for scripted applications (using the <code
- title="dom-timedtrack-kind-metadata">metadata</code> <span>timed
+ title="dom-timedtrack-kind-metadata">metadata</code> <span>text
track kind</span>).</p>
<p>A <span>WebVTT file</span> whose cues all have a <span>cue
@@ -32125,12 +32125,12 @@
<h6>Parsing</h6>
<p>A <dfn>WebVTT parser</dfn>, given an input byte stream and a
- <span>timed track list of cues</span> <var title="">output</var>,
+ <span>text track list of cues</span> <var title="">output</var>,
must <span title="decoded as UTF-8, with error handling">decode the
byte stream as UTF-8, with error handling</span>, and then must
parse the resulting string according to the <span>WebVTT parser
- algorithm</span> below. This results in <span title="timed track
- cue">timed track cues</span> being added to <var
+ algorithm</span> below. This results in <span title="text track
+ cue">text track cues</span> being added to <var
title="">output</var>. <a href="#refsRFC3629">[RFC3629]</a></p>
<p>A <span>WebVTT parser</span>, specifically its conversion and
@@ -32249,38 +32249,38 @@
characters</span> that are either U+000D CARRIAGE RETURN (CR) or
U+000A LINE FEED (LF) characters.</p></li>
- <li><p>Let <var title="">cue</var> be a new <span>timed track
- cue</span> associated with <var title="">output</var>'s <span>timed
+ <li><p>Let <var title="">cue</var> be a new <span>text track
+ cue</span> associated with <var title="">output</var>'s <span>text
track</span>.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
identifier</span> be the empty string.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
pause-on-exit flag</span> be false.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
- writing direction</span> be <span title="timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
+ writing direction</span> be <span title="text track cue
horizontal writing direction">horizontal</span>.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
snap-to-lines flag</span> be true.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue line
- position</span> be <span title="timed track cue automatic line
+ <li><p>Let <var title="">cue</var>'s <span>text track cue line
+ position</span> be <span title="text track cue automatic line
position">auto</span>.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
text position</span> be 50.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
size</span> be 100.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
- alignment</span> be <span title="timed track cue middle
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
+ alignment</span> be <span title="text track cue middle
alignment">middle alignment</span>.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
text</span> be the empty string.</p></li>
<li><p><span>Collect a sequence of characters</span> that are
@@ -32297,7 +32297,7 @@
HYPHEN-MINUS, U+003E GREATER-THAN SIGN), then jump to the step
labeled <i>timings</i> below.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
identifier</span> be <var title="">line</var>.<p></li>
<li><p>If <var title="">position</var> is past the end of <var
@@ -32371,14 +32371,14 @@
<li><p>Return to the step labeled <i>cue text loop</i>.</p></li>
- <li><p><i>Cue text processing</i>: Let the <span>timed track cue
+ <li><p><i>Cue text processing</i>: Let the <span>text track cue
text</span> of <var title="">cue</var> be <var title="">cue
text</var>, and let the rules for its interpretation be the
<span>WebVTT cue text parsing rules</span>, the <span>WebVTT cue
text rendering rules</span>, and the <span>WebVTT cue text DOM
construction rules</span>.</p></li>
- <li><p>Add <var title="">cue</var> to the <span>timed track list of
+ <li><p>Add <var title="">cue</var> to the <span>text track list of
cues</span> <var title="">output</var>.</p></li>
<li><p>Jump to the step labeled <i>cue loop</i>.</p></li>
@@ -32423,7 +32423,7 @@
<p>When the algorithm above requires that the user agent
<dfn>collect WebVTT cue timings and settings</dfn> from a string
- <var title="">input</var> for a <span>timed track cue</span> <var
+ <var title="">input</var> for a <span>text track cue</span> <var
title="">cue</var>, the user agent must run the following
algorithm.</p>
@@ -32440,7 +32440,7 @@
<li><p><span>Collect a WebVTT timestamp</span>. If that algorithm
fails, then abort these steps and return failure. Otherwise, let
- <var title="">cue</var>'s <span>timed track cue start time</span>
+ <var title="">cue</var>'s <span>text track cue start time</span>
be the collected time.</p></li>
<li><p><span>Skip whitespace</span>.</p></li>
@@ -32471,7 +32471,7 @@
<li><p><span>Collect a WebVTT timestamp</span>. If that algorithm
fails, then abort these steps and return failure. Otherwise, let
- <var title="">cue</var>'s <span>timed track cue end time</span>
+ <var title="">cue</var>'s <span>text track cue end time</span>
be the collected time.</p></li>
<li><p><span>Skip whitespace</span>.</p></li>
@@ -32482,7 +32482,7 @@
</ol>
<p>When the user agent is to <dfn>parse the WebVTT settings</dfn>
- for a <span>timed track cue</span> <var title="">cue</var>, the
+ for a <span>text track cue</span> <var title="">cue</var>, the
user agent must run the following steps:</p>
<ol>
@@ -32533,15 +32533,15 @@
<li><p>If <var title="">value</var> is a
<span>case-sensitive</span> match for the string "<code
title="">vertical</code>", then let <var title="">cue</var>'s
- <span>timed track cue writing direction</span> be <span
- title="timed track cue vertical growing left writing
+ <span>text track cue writing direction</span> be <span
+ title="text track cue vertical growing left writing
direction">vertical growing left</span>.</p></li>
<li><p>Otherwise, if <var title="">value</var> is a
<span>case-sensitive</span> match for the string "<code
title="">vertical-lr</code>", then let <var
- title="">cue</var>'s <span>timed track cue writing
- direction</span> be <span title="timed track cue vertical
+ title="">cue</var>'s <span>text track cue writing
+ direction</span> be <span title="text track cue vertical
growing right writing direction">vertical growing
right</span>.</p></li>
@@ -32588,7 +32588,7 @@
<li><p>If the last character in <var title="">value</var> is a
U+0025 PERCENT SIGN character (%), then let <var
- title="">cue</var>'s <span>timed track cue snap-to-lines
+ title="">cue</var>'s <span>text track cue snap-to-lines
flag</span> to true.</p></li>
<li><p>Ignoring the trailing percent sign, if any, interpret
@@ -32600,7 +32600,7 @@
title="">number</var> ≤ 100, then jump back to the
step labeled <i>settings</i>.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue line
+ <li><p>Let <var title="">cue</var>'s <span>text track cue line
position</span> be <var title="">number</var>.</p></li>
</ol>
@@ -32645,7 +32645,7 @@
0 ≤ <var title="">number</var> ≤ 100,
then jump back to the step labeled <i>settings</i>.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue text
+ <li><p>Let <var title="">cue</var>'s <span>text track cue text
position</span> be <var title="">number</var>.</p></li>
</ol>
@@ -32690,7 +32690,7 @@
0 ≤ <var title="">number</var> ≤ 100,
then jump back to the step labeled <i>settings</i>.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
size</span> be <var title="">number</var>.</p></li>
</ol>
@@ -32711,19 +32711,19 @@
<li><p>If <var title="">value</var> is a
<span>case-sensitive</span> match for the string "<code
title="">start</code>", then let <var title="">cue</var>'s
- <span>timed track cue alignment</span> be <span title="timed
+ <span>text track cue alignment</span> be <span title="text
track cue start alignment">start alignment</span>.</p></li>
<li><p>If <var title="">value</var> is a
<span>case-sensitive</span> match for the string "<code
title="">middle</code>", then let <var title="">cue</var>'s
- <span>timed track cue alignment</span> be <span title="timed
+ <span>text track cue alignment</span> be <span title="text
track cue middle alignment">middle alignment</span>.</p></li>
<li><p>If <var title="">value</var> is a
<span>case-sensitive</span> match for the string "<code
title="">end</code>", then let <var title="">cue</var>'s
- <span>timed track cue alignment</span> be <span title="timed
+ <span>text track cue alignment</span> be <span title="text
track cue end alignment">end alignment</span>.</p></li>
</ol>
@@ -33682,7 +33682,7 @@
<p>Where possible (specifically, for starting, stopping, pausing,
and unpausing playback, for seeking,
<!--KEEP-END w3c-html--><!--TT-->
- for listing, enabling, and disabling timed tracks,
+ for listing, enabling, and disabling text tracks,
<!--KEEP-START w3c-html--><!--TT-->
and for muting or changing the volume of the audio), user interface
features exposed by the user agent must be implemented in terms of
@@ -33691,16 +33691,16 @@
<!--KEEP-END w3c-html--><!--TT-->
<p>For the purposes of listing chapters in the <span>media
- resource</span>, only <span title="timed track">timed tracks</span>
- in the <span>media element</span>'s <span>list of timed
- tracks</span> <span title="timed track showing">showing</span> or
- <span title="timed track showing by default">showing by
- default</span> and whose <span>timed track kind</span> is <code
+ resource</span>, only <span title="text track">text tracks</span>
+ in the <span>media element</span>'s <span>list of text
+ tracks</span> <span title="text track showing">showing</span> or
+ <span title="text track showing by default">showing by
+ default</span> and whose <span>text track kind</span> is <code
title="dom-timedtrack-kind-chapters">chapters</code> should be used.
- Each <span title="timed track cue">cue</span> in such a <span>timed
+ Each <span title="text track cue">cue</span> in such a <span>text
track</span> represents a chapter starting at the cue's <span
- title="timed track cue start time">start time</span>. The name of
- the chapter is the <span>timed track cue text</span>, interpreted
+ title="text track cue start time">start time</span>. The name of
+ the chapter is the <span>text track cue text</span>, interpreted
literally.</p>
<!--KEEP-START w3c-html--><!--TT-->
@@ -34008,7 +34008,7 @@
<td><code>Event</code>
<td>The user agent has just determined the duration and dimensions of the <span>media resource</span>
<!--KEEP-END w3c-html--><!--TT-->
- and <span>the timed tracks are ready</span>.
+ and <span>the text tracks are ready</span>.
<!--KEEP-START w3c-html--><!--TT-->
<td><code title="dom-media-readyState">readyState</code> is newly equal to <code title="dom-media-HAVE_METADATA">HAVE_METADATA</code> or greater for the first time.
<tr>
@@ -97794,14 +97794,14 @@
<p>When the user agent starts <span title="expose a user interface
to the user">exposing a user interface</span> for a
<code>video</code> element, user agents should run the <span>rules
- for updating the timed track rendering</span> of each of the <span
- title="timed track">timed tracks</span> in the <code>video</code>
- element's <span>list of timed tracks</span> that are <span
- title="timed track showing">showing</span> or <span title="timed
+ for updating the text track rendering</span> of each of the <span
+ title="text track">text tracks</span> in the <code>video</code>
+ element's <span>list of text tracks</span> that are <span
+ title="text track showing">showing</span> or <span title="text
track showing by default">showing by default</span> (e.g., for <span
- title="timed track">timed tracks</span> based on
+ title="text track">text tracks</span> based on
<span>WebVTT</span>, the <span>rules for updating the display of
- WebVTT timed tracks</span>).</p>
+ WebVTT text tracks</span>).</p>
<!--KEEP-START w3c-html--><!--TT-->
<p class="note">Resizing <code>video</code> and <code>canvas</code>
@@ -97822,7 +97822,7 @@
<!--<div data-component="other Hixie drafts (editor: Ian Hickson)">-->
<div class="impl">
- <h4>Timed tracks</h4>
+ <h4>Timed text tracks</h4>
<p class="note">This section is intended to be moved to its own CSS
module once an editor is found to run with it.</p>
@@ -97830,11 +97830,11 @@
<!--START webvtt-->
<h5><dfn>WebVTT cue text rendering rules</dfn></h5>
- <p>The <dfn>rules for updating the display of WebVTT timed
- tracks</dfn> render the <span title="timed track">timed
+ <p>The <dfn>rules for updating the display of WebVTT text
+ tracks</dfn> render the <span title="text track">text
tracks</span> of a <span>media element</span> (specifically, a
<code>video</code> element), or of another playback mechanism, by
- applying the steps below. All the <span title="timed track">timed
+ applying the steps below. All the <span title="text track">text
tracks</span> that use these rules for a given <span>media
element</span>, or other playback mechanism, are rendered together,
to avoid overlapping subtitles from multiple tracks.</p>
@@ -97871,35 +97871,35 @@
title="">reset</var> be false.</p>
<li><p>Let <var title="">tracks</var> be the subset of <var
- title="">video</var>'s <span>list of timed tracks</span> that have
- as their <span>rules for updating the timed track rendering</span>
- these <span>rules for updating the display of WebVTT timed
- tracks</span>, and whose <span>timed track mode</span> is <span
- title="timed track showing">showing</span> or <span title="timed
+ title="">video</var>'s <span>list of text tracks</span> that have
+ as their <span>rules for updating the text track rendering</span>
+ these <span>rules for updating the display of WebVTT text
+ tracks</span>, and whose <span>text track mode</span> is <span
+ title="text track showing">showing</span> or <span title="text
track showing by default">showing by default</span>.</p></li>
<li><p>Let <var title="">cues</var> be an empty list of <span
- title="timed track cue">timed track cues</span>.</p></li>
+ title="text track cue">text track cues</span>.</p></li>
<li><p>For each track <var title="">track</var> in <var
title="">tracks</var>, append to <var title="">cues</var> all the
- <span title="timed track cue">cues</span> from <var
- title="">track</var>'s <span title="timed track list of cues">list
- of cues</span> that have their <span>timed track cue active
+ <span title="text track cue">cues</span> from <var
+ title="">track</var>'s <span title="text track list of cues">list
+ of cues</span> that have their <span>text track cue active
flag</span> set.</p></li>
<li><p>If <var title="">reset</var> is false, then, for each
- <span>timed track cue</span> <var title="">cue</var> in <var
- title="">cues</var>: if <var title="">cue</var>'s <span>timed track
+ <span>text track cue</span> <var title="">cue</var> in <var
+ title="">cues</var>: if <var title="">cue</var>'s <span>text track
cue display state</span> has a set of CSS boxes, then add those
boxes to <var title="">output</var>, and remove <var
title="">cue</var> from <var title="">cues</var>.</p></li>
<li>
- <p>For each <span>timed track cue</span> <var title="">cue</var>
+ <p>For each <span>text track cue</span> <var title="">cue</var>
in <var title="">cues</var> that has not yet had corresponding CSS
- boxes added to <var title="">output</var>, in <span>timed track
+ boxes added to <var title="">output</var>, in <span>text track
cue order</span>, run the following substeps:</p>
<ol>
@@ -97907,7 +97907,7 @@
<li><p>Let <var title="">nodes</var> be the <span>list of WebVTT
Node Objects</span> obtained by applying the <span>WebVTT cue
text parsing rules</span> to the <var title="">cue</var>'s
- <span>timed track cue text</span>.</p>
+ <span>text track cue text</span>.</p>
<li>
@@ -97939,15 +97939,15 @@
</li>
- <li><p>If the <span>timed track cue writing direction</span> is
- <span title="timed track cue horizontal writing
+ <li><p>If the <span>text track cue writing direction</span> is
+ <span title="text track cue horizontal writing
direction">horizontal</span>, then let <var
- title="">block-flow</var> be 'tb'. Otherwise, if the <span>timed
- track cue writing direction</span> is <span title="timed track
+ title="">block-flow</var> be 'tb'. Otherwise, if the <span>text
+ track cue writing direction</span> is <span title="text track
cue vertical growing left writing direction">vertical growing
left</span>, then let <var title="">block-flow</var> be
- 'lr'. Otherwise, the <span>timed track cue writing
- direction</span> is <span title="timed track cue vertical growing
+ 'lr'. Otherwise, the <span>text track cue writing
+ direction</span> is <span title="text track cue vertical growing
right writing direction">vertical growing right</span>; let <var
title="">block-flow</var> be 'rl'.</p></li>
@@ -97959,81 +97959,81 @@
<dl class="switch">
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue start alignment">start</span>,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue start alignment">start</span>,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue end alignment">end</span>,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue end alignment">end</span>,
and <var title="">direction</var> is 'rtl'</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing left writing direction">vertical growing left</span>,
- and the <span>timed track cue alignment</span> is <span title="timed track cue start alignment">start</span></dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing right writing direction">vertical growing right</span>,
- and the <span>timed track cue alignment</span> is <span title="timed track cue start alignment">start</span></dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing left writing direction">vertical growing left</span>,
+ and the <span>text track cue alignment</span> is <span title="text track cue start alignment">start</span></dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing right writing direction">vertical growing right</span>,
+ and the <span>text track cue alignment</span> is <span title="text track cue start alignment">start</span></dt>
<dd>
- <p>Let <var title="">maximum size</var> be the <span>timed track cue text position</span> subtracted from 100.</p>
+ <p>Let <var title="">maximum size</var> be the <span>text track cue text position</span> subtracted from 100.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue end alignment">end</span>,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue end alignment">end</span>,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue start alignment">start</span>,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue start alignment">start</span>,
and <var title="">direction</var> is 'rtl'</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing left writing direction">vertical growing left</span>,
- and the <span>timed track cue alignment</span> is <span title="timed track cue end alignment">end</span></dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing right writing direction">vertical growing right</span>,
- and the <span>timed track cue alignment</span> is <span title="timed track cue end alignment">end</span></dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing left writing direction">vertical growing left</span>,
+ and the <span>text track cue alignment</span> is <span title="text track cue end alignment">end</span></dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing right writing direction">vertical growing right</span>,
+ and the <span>text track cue alignment</span> is <span title="text track cue end alignment">end</span></dt>
<dd>
- <p>Let <var title="">maximum size</var> be the <span>timed track cue text position</span>.</p>
+ <p>Let <var title="">maximum size</var> be the <span>text track cue text position</span>.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue middle alignment">middle</span>,
- the <span>timed track cue text position</span> is less than or equal to 50,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue middle alignment">middle</span>,
+ the <span>text track cue text position</span> is less than or equal to 50,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue middle alignment">middle</span>,
- the <span>timed track cue text position</span> is greater than <!-- or equal to --> 50,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue middle alignment">middle</span>,
+ the <span>text track cue text position</span> is greater than <!-- or equal to --> 50,
and <var title="">direction</var> is 'rtl'</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing left writing direction">vertical growing left</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue middle alignment">middle</span>,
- and the <span>timed track cue text position</span> is less than or equal to 50</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing right writing direction">vertical growing right</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue middle alignment">middle</span>,
- and the <span>timed track cue text position</span> is less than or equal to 50</dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing left writing direction">vertical growing left</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue middle alignment">middle</span>,
+ and the <span>text track cue text position</span> is less than or equal to 50</dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing right writing direction">vertical growing right</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue middle alignment">middle</span>,
+ and the <span>text track cue text position</span> is less than or equal to 50</dt>
<dd>
- <p>Let <var title="">maximum size</var> be the <span>timed track cue text position</span> multiplied by two.</p>
+ <p>Let <var title="">maximum size</var> be the <span>text track cue text position</span> multiplied by two.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue middle alignment">middle</span>,
- the <span>timed track cue text position</span> is greater than <!-- or equal to --> 50,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue middle alignment">middle</span>,
+ the <span>text track cue text position</span> is greater than <!-- or equal to --> 50,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue middle alignment">middle</span>,
- the <span>timed track cue text position</span> is less than or equal to 50,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue middle alignment">middle</span>,
+ the <span>text track cue text position</span> is less than or equal to 50,
and <var title="">direction</var> is 'rtl'</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing left writing direction">vertical growing left</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue middle alignment">middle</span>,
- and the <span>timed track cue text position</span> is greater than <!-- or equal to --> 50</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing right writing direction">vertical growing right</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue middle alignment">middle</span>,
- and the <span>timed track cue text position</span> is greater than <!-- or equal to --> 50</dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing left writing direction">vertical growing left</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue middle alignment">middle</span>,
+ and the <span>text track cue text position</span> is greater than <!-- or equal to --> 50</dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing right writing direction">vertical growing right</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue middle alignment">middle</span>,
+ and the <span>text track cue text position</span> is greater than <!-- or equal to --> 50</dt>
<dd>
- <p>Let <var title="">maximum size</var> be the result of subtracting <span>timed track cue text position</span> from 100 and then multiplying the result by two.</p>
+ <p>Let <var title="">maximum size</var> be the result of subtracting <span>text track cue text position</span> from 100 and then multiplying the result by two.</p>
</dd>
</dl>
</li>
- <li><p>If the <span>timed track cue size</span> is less than <var
+ <li><p>If the <span>text track cue size</span> is less than <var
title="">maximum size</var>, then let <var title="">size</var> be
- <span>timed track cue size</span>. Otherwise, let <var
+ <span>text track cue size</span>. Otherwise, let <var
title="">size</var> be <var title="">maximum size</var>.</p></li>
- <li><p>If the <span>timed track cue writing direction</span> is
- <span title="timed track cue horizontal writing
+ <li><p>If the <span>text track cue writing direction</span> is
+ <span title="text track cue horizontal writing
direction">horizontal</span>, then let <var title="">width</var>
be '<var title="">size</var> vw' and <var
title="">height</var> be 'auto'. Otherwise, let <var
@@ -98051,63 +98051,63 @@
<dl class="switch">
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue start alignment">start</span>,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue start alignment">start</span>,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue end alignment">end</span>,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue end alignment">end</span>,
and <var title="">direction</var> is 'rtl'</dt>
<dd>
- <p>Let <var title="">x-position</var> be the <span>timed track cue text position</span>.</p>
+ <p>Let <var title="">x-position</var> be the <span>text track cue text position</span>.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue end alignment">end</span>,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue end alignment">end</span>,
and <var title="">direction</var> is 'ltr'</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue start alignment">start</span>,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue start alignment">start</span>,
and <var title="">direction</var> is 'rtl'</dt>
<dd>
- <p>Let <var title="">x-position</var> be the <span>timed track cue text position</span> subtracted from 100.</p>
+ <p>Let <var title="">x-position</var> be the <span>text track cue text position</span> subtracted from 100.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing left writing direction">vertical growing left</span>,
- and the <span>timed track cue alignment</span> is <span title="timed track cue start alignment">start</span></dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing right writing direction">vertical growing right</span>,
- and the <span>timed track cue alignment</span> is <span title="timed track cue start alignment">start</span></dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing left writing direction">vertical growing left</span>,
+ and the <span>text track cue alignment</span> is <span title="text track cue start alignment">start</span></dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing right writing direction">vertical growing right</span>,
+ and the <span>text track cue alignment</span> is <span title="text track cue start alignment">start</span></dt>
<dd>
- <p>Let <var title="">y-position</var> be the <span>timed track cue text position</span>.</p>
+ <p>Let <var title="">y-position</var> be the <span>text track cue text position</span>.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing left writing direction">vertical growing left</span>,
- and the <span>timed track cue alignment</span> is <span title="timed track cue end alignment">end</span></dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing right writing direction">vertical growing right</span>,
- and the <span>timed track cue alignment</span> is <span title="timed track cue end alignment">end</span></dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing left writing direction">vertical growing left</span>,
+ and the <span>text track cue alignment</span> is <span title="text track cue end alignment">end</span></dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing right writing direction">vertical growing right</span>,
+ and the <span>text track cue alignment</span> is <span title="text track cue end alignment">end</span></dt>
<dd>
- <p>Let <var title="">y-position</var> be the <span>timed track cue text position</span> subtracted from 100.</p>
+ <p>Let <var title="">y-position</var> be the <span>text track cue text position</span> subtracted from 100.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue middle alignment">middle</span>,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue middle alignment">middle</span>,
and <var title="">direction</var> is 'ltr'</dt>
<dd>
- <p>Let <var title="">x-position</var> be the <span>timed track cue text position</span> minus half of <var title="">size</var>.</p>
+ <p>Let <var title="">x-position</var> be the <span>text track cue text position</span> minus half of <var title="">size</var>.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- the <span>timed track cue alignment</span> is <span title="timed track cue middle alignment">middle</span>,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ the <span>text track cue alignment</span> is <span title="text track cue middle alignment">middle</span>,
and <var title="">direction</var> is 'rtl'</dt>
<dd>
- <p>Let <var title="">x-position-reverse</var> be the <span>timed track cue text position</span> minus half of <var title="">size</var>.</p>
+ <p>Let <var title="">x-position-reverse</var> be the <span>text track cue text position</span> minus half of <var title="">size</var>.</p>
<p>Let <var title="">x-position</var> be <var title="">x-position-reverse</var> subtracted from 100.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing left writing direction">vertical growing left</span>,
- and the <span>timed track cue alignment</span> is <span title="timed track cue middle alignment">middle</span></dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing right writing direction">vertical growing right</span>,
- and the <span>timed track cue alignment</span> is <span title="timed track cue middle alignment">middle</span></dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing left writing direction">vertical growing left</span>,
+ and the <span>text track cue alignment</span> is <span title="text track cue middle alignment">middle</span></dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing right writing direction">vertical growing right</span>,
+ and the <span>text track cue alignment</span> is <span title="text track cue middle alignment">middle</span></dt>
<dd>
- <p>Let <var title="">y-position</var> be the <span>timed track cue text position</span> minus half of <var title="">size</var>.</p>
+ <p>Let <var title="">y-position</var> be the <span>text track cue text position</span> minus half of <var title="">size</var>.</p>
</dd>
</dl>
@@ -98123,32 +98123,32 @@
<dl class="switch">
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- and the <span>timed track cue snap-to-lines flag</span> is set</dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ and the <span>text track cue snap-to-lines flag</span> is set</dt>
<dd>
<p>Let <var title="">y-position</var> be zero.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
- and the <span>timed track cue snap-to-lines flag</span> is not set</dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
+ and the <span>text track cue snap-to-lines flag</span> is not set</dt>
<dd>
- <p>Let <var title="">y-position</var> be the <span>timed track cue line position</span>.</p>
+ <p>Let <var title="">y-position</var> be the <span>text track cue line position</span>.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing left writing direction">vertical growing left</span>,
- and the <span>timed track cue snap-to-lines flag</span> is set</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing right writing direction">vertical growing right</span>,
- and the <span>timed track cue snap-to-lines flag</span> is set</dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing left writing direction">vertical growing left</span>,
+ and the <span>text track cue snap-to-lines flag</span> is set</dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing right writing direction">vertical growing right</span>,
+ and the <span>text track cue snap-to-lines flag</span> is set</dt>
<dd>
<p>Let <var title="">x-position</var> be zero.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing left writing direction">vertical growing left</span>,
- and the <span>timed track cue snap-to-lines flag</span> is not set</dt>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing right writing direction">vertical growing right</span>,
- and the <span>timed track cue snap-to-lines flag</span> is not set</dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing left writing direction">vertical growing left</span>,
+ and the <span>text track cue snap-to-lines flag</span> is not set</dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing right writing direction">vertical growing right</span>,
+ and the <span>text track cue snap-to-lines flag</span> is not set</dt>
<dd>
- <p>Let <var title="">x-position</var> be the <span>timed track cue line position</span>.</p>
+ <p>Let <var title="">x-position</var> be the <span>text track cue line position</span>.</p>
</dd>
</dl>
@@ -98232,28 +98232,28 @@
<dl class="switch">
- <dt>If <var title="">cue</var>'s <span>timed track cue snap-to-lines flag</span> is set</dt>
+ <dt>If <var title="">cue</var>'s <span>text track cue snap-to-lines flag</span> is set</dt>
<dd>
<p>Many of the steps in this algorithm vary according to the
- <span>timed track cue writing direction</span>. Steps labeled
+ <span>text track cue writing direction</span>. Steps labeled
"<strong>Horizontal</strong>" must be followed only when the
- <span>timed track cue writing direction</span> is <span
- title="timed track cue horizontal writing
+ <span>text track cue writing direction</span> is <span
+ title="text track cue horizontal writing
direction">horizontal</span>, steps labeled
"<strong>Vertical</strong>" must be followed when the
- <span>timed track cue writing direction</span> is either <span
- title="timed track cue vertical growing left writing
- direction">vertical growing left</span> or <span title="timed
+ <span>text track cue writing direction</span> is either <span
+ title="text track cue vertical growing left writing
+ direction">vertical growing left</span> or <span title="text
track cue vertical growing right writing direction">vertical
growing right</span>, steps labeled "<strong>Vertical Growing
- Left</strong>" must be followed only when the <span>timed
- track cue writing direction</span> is <span title="timed track
+ Left</strong>" must be followed only when the <span>text
+ track cue writing direction</span> is <span title="text track
cue vertical growing left writing direction">vertical growing
left</span>, and steps labeled "<strong>Vertical Growing
- Right</strong>" must be followed only when the <span>timed
- track cue writing direction</span> is <span title="timed track
+ Right</strong>" must be followed only when the <span>text
+ track cue writing direction</span> is <span title="text track
cue vertical growing right writing direction">vertical growing
right</span>.</p>
@@ -98275,7 +98275,7 @@
step labeled <i>done positioning</i> below.</p></li>
<li><p>Let <var title="">line position</var> be the
- <span>timed track cue line position</span>.</p></li>
+ <span>text track cue line position</span>.</p></li>
<li><p><strong>Vertical Growing Left</strong>: Add one to
<var title="">line position</var> then negate it.</p></li>
@@ -98392,7 +98392,7 @@
</dd>
- <dt>If <var title="">cue</var>'s <span>timed track cue snap-to-lines flag</span> is not set</dt>
+ <dt>If <var title="">cue</var>'s <span>text track cue snap-to-lines flag</span> is not set</dt>
<dd>
<ol>
@@ -98404,37 +98404,37 @@
<dl class="switch">
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
and <var title="">direction</var> is 'ltr'</dt>
<dd>
<p>Let <var title="">x</var> be a percentage given by the
- <span>timed track cue text position</span>, and let <var
- title="">y</var> be a percentage given by the <span>timed
+ <span>text track cue text position</span>, and let <var
+ title="">y</var> be a percentage given by the <span>text
track cue line position</span>.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue horizontal writing direction">horizontal</span>,
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue horizontal writing direction">horizontal</span>,
and <var title="">direction</var> is 'rtl'</dt>
<dd>
<p>Let <var title="">x</var> be a percentage given by the
- <span>timed track cue text position</span> subtracted from
+ <span>text track cue text position</span> subtracted from
100, and let <var title="">y</var> be a percentage given
- by the <span>timed track cue line position</span>.</p>
+ by the <span>text track cue line position</span>.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing left writing direction">vertical growing left</span></dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing left writing direction">vertical growing left</span></dt>
<dd>
<p>Let <var title="">x</var> be a percentage given by the
- <span>timed track cue line position</span> subtracted from
+ <span>text track cue line position</span> subtracted from
100, and let <var title="">y</var> be a percentage given
- by the <span>timed track cue text position</span>.</p>
+ by the <span>text track cue text position</span>.</p>
</dd>
- <dt>If the <span>timed track cue writing direction</span> is <span title="timed track cue vertical growing right writing direction">vertical growing right</span></dt>
+ <dt>If the <span>text track cue writing direction</span> is <span title="text track cue vertical growing right writing direction">vertical growing right</span></dt>
<dd>
<p>Let <var title="">x</var> be a percentage given by the
- <span>timed track cue line position</span>, and let <var
- title="">y</var> be a percentage given by the <span>timed
+ <span>text track cue line position</span>, and let <var
+ title="">y</var> be a percentage given by the <span>text
track cue text position</span>.</p>
</dd>
@@ -98493,7 +98493,7 @@
area, remove those offending line boxes from <var
title="">boxes</var>.</p></li>
- <li><p>Let <var title="">cue</var>'s <span>timed track cue
+ <li><p>Let <var title="">cue</var>'s <span>text track cue
display state</span> have the CSS boxes in <var
title="">boxes</var>.</p></li>
@@ -98512,7 +98512,7 @@
<h5>Applying CSS properties to <span title="WebVTT Node Object">WebVTT Node Objects</span></h5>
<p>When following the <span>rules for updating the display of WebVTT
- timed tracks</span>, user agents must set properties of <span
+ text tracks</span>, user agents must set properties of <span
title="WebVTT Node Object">WebVTT Node Objects</span> as defined in
this section. <a href="#refsCSS">[CSS]</a></p>
@@ -98528,8 +98528,8 @@
title="">top</var>, <var title="">left</var>, <var
title="">width</var>, and <var title="">height</var> are the values
with those names determined by the <span>rules for updating the
- display of WebVTT timed tracks</span> for the <span>timed track
- cue</span> from whose <span title="timed track cue text">text</span>
+ display of WebVTT text tracks</span> for the <span>text track
+ cue</span> from whose <span title="text track cue text">text</span>
the <span>List of WebVTT Node Objects</span> was constructed.</p>
<p>The 'font' shorthand property on the (root) <span>List of WebVTT
@@ -98569,9 +98569,9 @@
<p>All other non-inherited properties must be set to their initial
values; inherited properties on the root <span>List of WebVTT Node
Objects</span> must inherit their values from the <span>media
- element</span> for which the <span>timed track cue</span> is being
+ element</span> for which the <span>text track cue</span> is being
rendered, if any. If there is no <span>media element</span> (i.e. if
- the <span>timed track</span> is being rendered for another media
+ the <span>text track</span> is being rendered for another media
playback mechanism), then inherited properties on the root
<span>List of WebVTT Node Objects</span> must take their initial
values.</p>
@@ -98579,14 +98579,14 @@
<h5>CSS extensions</h5>
- <p>When a user agent is rendering one or more <span title="timed
- track cue">timed track cues</span> according to the <span>WebVTT cue
+ <p>When a user agent is rendering one or more <span title="text
+ track cue">text track cues</span> according to the <span>WebVTT cue
text rendering rules</span>, <span title="WebVTT Node Object">WebVTT
Node Objects</span> in the <span>list of WebVTT Node Objects</span>
used in the rendering can be matched by certain pseudo-selectors as
defined below. These selectors can begin or stop matching individual
<span title="WebVTT Node Object">WebVTT Node Objects</span> while a
- <span title="timed track cue">cue</span> is being rendered, even in
+ <span title="text track cue">cue</span> is being rendered, even in
between applications of the <span>WebVTT cue text rendering
rules</span> (which are only run when the set of active cues
changes). User agents that support the pseudo-element described
@@ -98595,16 +98595,16 @@
<p>Pseudo-elements apply to elements that are matched by
selectors. For the purpose of this section, that element is the
<i>matched element</i>. The pseudo-elements defined in the following
- sections affect the styling of parts of <span title="timed track
- cue">timed track cues</span> that are being rendered for the
+ sections affect the styling of parts of <span title="text track
+ cue">text track cues</span> that are being rendered for the
<i>matched element</i>.</p>
<p class="note">If the <i>matched element</i> is not a
<code>video</code> element, the pseudo-elements defined below won't
have any effect according to this specification.</p>
- <p>A CSS user agent that implements the <span title="timed
- track">timed tracks</span> model must implement the '::cue' and
+ <p>A CSS user agent that implements the <span title="text
+ track">text tracks</span> model must implement the '::cue' and
'::cue(<var title="">selector</var>)' pseudo-elements, and the
':past' and ':future' pseudo-classes.</p>
@@ -98786,7 +98786,7 @@
<p>A <span>WebVTT Node Object</span> <var title="">c</var> is
<dfn>in the past</dfn> if, in a pre-order, depth-first traversal of
- the <span>timed track cue</span>'s <span>List of WebVTT Node
+ the <span>text track cue</span>'s <span>List of WebVTT Node
Objects</span>, there exists a <span>WebVTT Timestamp Object</span>
whose value is less than the <span>current playback position</span>
of the <span>media element</span> that is the <i>matched
@@ -98798,7 +98798,7 @@
<p>A <span>WebVTT Node Object</span> <var title="">c</var> is
<dfn>in the future</dfn> if, in a pre-order, depth-first traversal
- of the <span>timed track cue</span>'s <span>List of WebVTT Node
+ of the <span>text track cue</span>'s <span>List of WebVTT Node
Objects</span>, there exists a <span>WebVTT Timestamp Object</span>
whose value is greater than the <span>current playback
position</span> of the <span>media element</span> that is the
@@ -102704,10 +102704,10 @@
<dd>Must always be UTF-8.</dd>
<dt>Security considerations:</dt>
<dd>
- <p>Timed track files themselves pose no immediate risk unless
+ <p>Text track files themselves pose no immediate risk unless
sensitive information is included within the
data. Implementations, however, are required to follow specific
- rules when processing timed tracks, to ensure that certain
+ rules when processing text tracks, to ensure that certain
origin-based restrictions are honored. Failure to correctly
implement these rules can result in information leakage,
cross-site scripting attacks, and the like.</p>
@@ -104293,7 +104293,7 @@
<!--KEEP-END w3c-html--><!--TT-->
<tr>
<th><code>track</code></th>
- <td>Timed track</td>
+ <td>Timed text track</td>
<td>none</td>
<td><code>audio</code>;
<code>video</code></td>
@@ -104872,7 +104872,7 @@
<tr>
<th> <code title="">default</code>
<td> <code title="attr-track-default">track</code>
- <td> Enable the track if no other <span>timed track</span> is more suitable.
+ <td> Enable the track if no other <span>text track</span> is more suitable.
<td> <span>Boolean attribute</span>
<tr>
<th> <code title="">defer</code>
@@ -105079,7 +105079,7 @@
<tr>
<th> <code title="">kind</code>
<td> <code title="attr-track-kind">track</code>
- <td> The type of timed track
+ <td> The type of text track
<td> "<code title="attr-track-kind-subtitles">subtitles</code>";
"<code title="attr-track-kind-captions">captions</code>";
"<code title="attr-track-kind-descriptions">descriptions</code>";
@@ -105385,7 +105385,7 @@
<tr>
<th> <code title="">srclang</code>
<td> <code title="attr-track-srclang">track</code>
- <td> Language of the timed track
+ <td> Language of the text track
<td> Valid BCP 47 language tag
<!--KEEP-START w3c-html--><!--TT-->
<tr>
@@ -108093,7 +108093,7 @@
<!--END w3c-html--><!--TT-->
<p>Thanks to the SubRip community, including in particular Zuggy and
ai4spam, for their work on the SubRip software program whose SRT
- file format was used as the basis for the WebVTT timed track file
+ file format was used as the basis for the WebVTT text track file
format.</p>
<!--START w3c-html--><!--TT-->
More information about the Commit-Watchers
mailing list