- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Mon, 09 Mar 2015 04:42:59 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory roscoe:/tmp/cvs-serv12248
Modified Files:
Overview.html
Log Message:
Sync WebVTT with Git commit a179f1879da205d5b4bc0a94afb29e31975c613f
--- /sources/public/html5/webvtt/Overview.html 2015/03/09 04:07:25 1.212
+++ /sources/public/html5/webvtt/Overview.html 2015/03/09 04:42:59 1.213
@@ -3,7 +3,7 @@
<head>
<title>WebVTT: The Web Video Text Tracks Format</title>
<meta charset="utf-8">
- <meta name="revision" content="d29149f597c8b9e7a92c1f332ac1b5a4bcdf4b13">
+ <meta name="revision" content="a179f1879da205d5b4bc0a94afb29e31975c613f">
@@ -858,15 +858,15 @@
<section id="webvtt-cues">
<h3 role="heading" id="h3_webvtt-cues"><span class="secno">3.1 </span>WebVTT cues</h3>
- <p>WebVTT cues are HTML <a title="text track cue" href="#dfn-text-track-cue" class="internalDFN">text track cues</a> that additionally consist
- of the following: [<cite><a class="bibref" href="#bib-HTML">HTML</a></cite>]</p>
+ <p>A <dfn id="dfn-webvtt-cue">WebVTT cue</dfn> is a HTML <a title="" href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that additionally consist of
+ the following: [<cite><a class="bibref" href="#bib-HTML">HTML</a></cite>]</p>
<dl>
<dt><dfn title="text track cue box" id="dfn-text-track-cue-box">A cue box</dfn></dt>
<dd>
- <p>The cue box of a <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> is a box within which the text of all lines of the
- cue is to be rendered.</p>
+ <p>The cue box of a <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> is a box within which the text of all lines of the cue
+ is to be rendered.</p>
<div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_1"><span>Note</span></div><p class="">The position of the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a> within the video
frame's dimensions depends on the value of the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> and the
@@ -928,16 +928,15 @@
cue, or the special value <dfn title="text track cue automatic line position" id="dfn-text-track-cue-automatic-line-position">auto</dfn>,
which means the position is to depend on the other showing tracks.</p>
- <p>A <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> has a <dfn id="dfn-text-track-cue-computed-line-position">text track cue computed line position</dfn> whose value
- is that returned by the following algorithm, which is defined in terms of the other aspects of
+ <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a <dfn id="dfn-text-track-cue-computed-line-position">text track cue computed line position</dfn> whose value is
+ that returned by the following algorithm, which is defined in terms of the other aspects of
the cue:</p>
<ol>
<li><p>If the <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a> is numeric, the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue
- snap-to-lines flag</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> is not set, and the <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue
- line position</a> is negative or greater than 100, then return 100 and abort these
- steps.</p></li>
+ snap-to-lines flag</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> is not set, and the <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line
+ position</a> is negative or greater than 100, then return 100 and abort these steps.</p></li>
<li><p>If the <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a> is numeric, return the value of the <a href="#dfn-text-track-cue-line-position" class="internalDFN">text
track cue line position</a> and abort these steps. (Either the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue
@@ -945,11 +944,11 @@
the value is in the range 0..100 and is thus valid regardless of the value of that
flag.)</p></li>
- <li><p>If the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue snap-to-lines flag</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> is not
- set, return the value 100 and abort these steps. (The <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a> is
- the special value <a title="text track cue automatic line position" href="#dfn-text-track-cue-automatic-line-position" class="internalDFN">auto</a>.)</p></li>
+ <li><p>If the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue snap-to-lines flag</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> is not set,
+ return the value 100 and abort these steps. (The <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a> is the
+ special value <a title="text track cue automatic line position" href="#dfn-text-track-cue-automatic-line-position" class="internalDFN">auto</a>.)</p></li>
- <li><p>Let <var>cue</var> be the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a>.</p></li>
+ <li><p>Let <var>cue</var> be the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a>.</p></li>
<li><p>If <var>cue</var> is not in a <a title="text track list of cues" href="#dfn-text-track-list-of-cues" class="internalDFN">list of cues</a> of a
<a href="#dfn-text-track" class="internalDFN">text track</a>, or if that <a href="#dfn-text-track" class="internalDFN">text track</a> is not in the <a href="#dfn-list-of-text-tracks" class="internalDFN">list of text tracks</a> of a
@@ -997,7 +996,8 @@
</dl>
- <p>A <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> has a default <a href="#dfn-text-track-cue-line-alignment" class="internalDFN">text track cue line alignment</a> of <a title="text track cue line start alignment" href="#dfn-text-track-cue-line-start-alignment" class="internalDFN">start</a>.</p>
+ <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a default <a href="#dfn-text-track-cue-line-alignment" class="internalDFN">text track cue line alignment</a> of <a title="text
+ track cue line start alignment" href="#dfn-text-track-cue-line-start-alignment" class="internalDFN">start</a>.</p>
</dd>
@@ -1015,8 +1015,8 @@
to be interpreted as a percentage of the video dimensions, otherwise as a percentage of the
region dimensions.</p>
- <p>A <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> has a <dfn id="dfn-text-track-cue-computed-text-position">text track cue computed text position</dfn> whose value
- is that returned by the following algorithm, which is defined in terms of the other aspects of
+ <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a <dfn id="dfn-text-track-cue-computed-text-position">text track cue computed text position</dfn> whose value is
+ that returned by the following algorithm, which is defined in terms of the other aspects of
the cue:</p>
<ol>
@@ -1081,9 +1081,9 @@
</dl>
- <p>A <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> has a <dfn id="dfn-text-track-cue-computed-text-position-alignment">text track cue computed text position alignment</dfn>
- whose value is that returned by the following algorithm, which is defined in terms of other
- aspects of the cue:</p>
+ <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a <dfn id="dfn-text-track-cue-computed-text-position-alignment">text track cue computed text position alignment</dfn> whose
+ value is that returned by the following algorithm, which is defined in terms of other aspects
+ of the cue:</p>
<ol>
@@ -1162,19 +1162,19 @@
</dl>
- <p>The associated <a href="#dfn-rules-for-updating-the-text-track-rendering" class="internalDFN">rules for updating the text track rendering</a> of WebVTT <a title="text
- track cue" href="#dfn-text-track-cue" class="internalDFN">text track cues</a> are the <a href="#dfn-rules-for-updating-the-display-of-webvtt-text-tracks" class="internalDFN">rules for updating the display of WebVTT text
- tracks</a>.</p>
+ <p>The associated <a href="#dfn-rules-for-updating-the-text-track-rendering" class="internalDFN">rules for updating the text track rendering</a> of <a title="WebVTT
+ cue" href="#dfn-webvtt-cue" class="internalDFN">WebVTT cues</a> are the <a href="#dfn-rules-for-updating-the-display-of-webvtt-text-tracks" class="internalDFN">rules for updating the display of WebVTT text tracks</a>.</p>
<div class="impl">
- <p>When a WebVTT <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> whose <a title="text track cue active flag" href="#dfn-text-track-cue-active-flag" class="internalDFN">active
- flag</a> is set has its <a title="text track cue writing direction" href="#dfn-text-track-cue-writing-direction" class="internalDFN">writing direction</a>, <a title="text track cue snap-to-lines flag" href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">snap-to-lines flag</a>, <a title="text track cue line
- position" href="#dfn-text-track-cue-line-position" class="internalDFN">line position</a>, <a title="text track cue text position" href="#dfn-text-track-cue-text-position" class="internalDFN">text position</a>, <a title="text track cue size" href="#dfn-text-track-cue-size" class="internalDFN">size</a>, <a title="text track cue text alignment" href="#dfn-text-track-cue-text-alignment" class="internalDFN">text
- alignment</a>, <a title="text track cue region" href="#dfn-text-track-cue-region" class="internalDFN">region</a>, or <a title="text track cue
- text" href="#dfn-text-track-cue-text" class="internalDFN">text</a> change value, then the user agent must empty the <a href="#dfn-text-track-cue-display-state" class="internalDFN">text track cue display
- state</a>, and then immediately run the <a href="#dfn-text-track" class="internalDFN">text track</a>'s <a href="#dfn-rules-for-updating-the-display-of-webvtt-text-tracks" class="internalDFN">rules for updating the display
- of WebVTT text tracks</a>.</p>
+ <p>When a <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> whose <a title="text track cue active flag" href="#dfn-text-track-cue-active-flag" class="internalDFN">active flag</a> is set
+ has its <a title="text track cue writing direction" href="#dfn-text-track-cue-writing-direction" class="internalDFN">writing direction</a>, <a title="text track
+ cue snap-to-lines flag" href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">snap-to-lines flag</a>, <a title="text track cue line position" href="#dfn-text-track-cue-line-position" class="internalDFN">line
+ position</a>, <a title="text track cue text position" href="#dfn-text-track-cue-text-position" class="internalDFN">text position</a>, <a title="text track
+ cue size" href="#dfn-text-track-cue-size" class="internalDFN">size</a>, <a title="text track cue text alignment" href="#dfn-text-track-cue-text-alignment" class="internalDFN">text alignment</a>, <a title="text
+ track cue region" href="#dfn-text-track-cue-region" class="internalDFN">region</a>, or <a title="text track cue text" href="#dfn-text-track-cue-text" class="internalDFN">text</a> change value, then the
+ user agent must empty the <a href="#dfn-text-track-cue-display-state" class="internalDFN">text track cue display state</a>, and then immediately run the
+ <a href="#dfn-text-track" class="internalDFN">text track</a>'s <a href="#dfn-rules-for-updating-the-display-of-webvtt-text-tracks" class="internalDFN">rules for updating the display of WebVTT text tracks</a>.</p>
</div>
@@ -1184,7 +1184,7 @@
<h3 role="heading" id="h3_text-track-regions"><span class="secno">3.2 </span>Text track regions</h3>
<p>A <dfn title="text track region" id="dfn-text-track-region">text track region</dfn> represents a subpart of the video
- viewport and provides a rendering area for <a title="text track cue" href="#dfn-text-track-cue" class="internalDFN">text track cues</a>.</p>
+ viewport and provides a rendering area for <a title="WebVTT cue" href="#dfn-webvtt-cue" class="internalDFN">WebVTT cues</a>.</p>
<p>Each <a title="text track region" href="#dfn-text-track-region" class="internalDFN">text track region</a> consists of:</p>
@@ -1341,7 +1341,7 @@
characters.</p>
<p>A <a href="#dfn-webvtt-cue-identifier" class="internalDFN">WebVTT cue identifier</a> must be unique amongst all the <a title="WebVTT cue
- identifier" href="#dfn-webvtt-cue-identifier" class="internalDFN">WebVTT cue identifiers</a> of all WebVTT cues of a
+ identifier" href="#dfn-webvtt-cue-identifier" class="internalDFN">WebVTT cue identifiers</a> of all <a title="WebVTT cue" href="#dfn-webvtt-cue" class="internalDFN">WebVTT cues</a> of a
<a href="#dfn-webvtt-file" class="internalDFN">WebVTT file</a>.</p>
<div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_7"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-cue-identifier" class="internalDFN">WebVTT cue identifier</a> can be used to reference a specific cue, for
@@ -2173,8 +2173,8 @@
<p>A <dfn id="dfn-webvtt-parser">WebVTT parser</dfn>, given an input byte stream and a <a href="#dfn-text-track-list-of-cues" class="internalDFN">text track list of cues</a>
<var>output</var>, must decode the byte stream using the <a title="UTF-8 decode" href="#dfn-utf-8-decode" class="internalDFN">UTF-8
decode</a> algorithm, and then must parse the resulting string according to the <a href="#dfn-webvtt-parser-algorithm" class="internalDFN">WebVTT parser
- algorithm</a> below. This results in <a title="text track cue" href="#dfn-text-track-cue" class="internalDFN">text track cues</a> being added
- to <var>output</var>. [<cite><a class="bibref" href="#bib-RFC3629">RFC3629</a></cite>]</p>
+ algorithm</a> below. This results in <a title="WebVTT cue" href="#dfn-webvtt-cue" class="internalDFN">WebVTT cues</a> being added to
+ <var>output</var>. [<cite><a class="bibref" href="#bib-RFC3629">RFC3629</a></cite>]</p>
<p>A <a href="#dfn-webvtt-parser" class="internalDFN">WebVTT parser</a>, specifically its conversion and parsing steps, is typically run
asynchronously, with the input byte stream being updated incrementally as the resource is
@@ -2237,8 +2237,8 @@
processed.</p></li>
<li><p>If <var>position</var> is past the end of <var>input</var>, then abort these steps. The
- file was successfully processed, but it contains no useful data and so no <a title="text track
- cue" href="#dfn-text-track-cue" class="internalDFN">text track cues</a> were added to <var>output</var>.</p></li>
+ file was successfully processed, but it contains no useful data and so no <a title="WebVTT
+ cue" href="#dfn-webvtt-cue" class="internalDFN">WebVTT cues</a> were added to <var>output</var>.</p></li>
<li><p>The character indicated by <var>position</var> is a U+000A LINE FEED (LF) character.
Advance <var>position</var> to the next character in <var>input</var>.</p></li>
@@ -2324,7 +2324,7 @@
that's not a newline, so we have none of that either, meaning we have nothing. -->.)</p></li>
<li>
- <p><i>Cue creation</i>: Let <var>cue</var> be a new <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> and initialize it as
+ <p><i>Cue creation</i>: Let <var>cue</var> be a new <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> and initialize it as
follows:</p>
<ol>
@@ -2608,8 +2608,8 @@
<p>When the algorithm above requires that the user agent <dfn id="dfn-collect-webvtt-cue-timings-and-settings">collect WebVTT cue timings and
settings</dfn> from a string <var>input</var> using a <a href="#dfn-text-track-list-of-regions" class="internalDFN">text track list of regions</a>
- <var>regions</var> for a <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> <var>cue</var>, the user agent must run the
- following algorithm.</p>
+ <var>regions</var> for a <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> <var>cue</var>, the user agent must run the following
+ algorithm.</p>
<ol>
@@ -3935,7 +3935,7 @@
</li>
<li>
- <p>If <var>reset</var> is false, then, for each <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> <var>cue</var> in
+ <p>If <var>reset</var> is false, then, for each <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> <var>cue</var> in
<var>cues</var>: if <var>cue</var>'s <a href="#dfn-text-track-cue-display-state" class="internalDFN">text track cue display state</a> has a set of CSS
boxes, then:</p>
@@ -3950,7 +3950,7 @@
<li>
- <p>For each <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> <var>cue</var> in <var>cues</var> that has not yet had
+ <p>For each <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> <var>cue</var> in <var>cues</var> that has not yet had
corresponding CSS boxes added to <var>output</var>, in <a href="#dfn-text-track-cue-order" class="internalDFN">text track cue order</a>, run the
following substeps:</p>
@@ -4670,8 +4670,8 @@
<p>The variables <var>direction</var>, <var>writing-mode</var>, <var>top</var>, <var>left</var>,
<var>width</var>, and <var>height</var> are the values with those names determined by the
- <a href="#dfn-rules-for-updating-the-display-of-webvtt-text-tracks" class="internalDFN">rules for updating the display of WebVTT text tracks</a> for the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> from
- whose <a title="text track cue text" href="#dfn-text-track-cue-text" class="internalDFN">text</a> the <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">list of WebVTT Node Objects</a> was
+ <a href="#dfn-rules-for-updating-the-display-of-webvtt-text-tracks" class="internalDFN">rules for updating the display of WebVTT text tracks</a> for the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> from whose
+ <a title="text track cue text" href="#dfn-text-track-cue-text" class="internalDFN">text</a> the <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">list of WebVTT Node Objects</a> was
constructed.</p>
<p>The 'text-align' property on the (root) <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">list of WebVTT Node Objects</a> must be set to the
@@ -4775,8 +4775,8 @@
<p>All other non-inherited properties must be set to their initial values; inherited properties
on the root <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">list of WebVTT Node Objects</a> must inherit their values from the <a href="#dfn-media-element" class="internalDFN">media
- element</a> for which the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> is being rendered, if any. If there is no
- <a href="#dfn-media-element" class="internalDFN">media element</a> (i.e. if the <a href="#dfn-text-track" class="internalDFN">text track</a> is being rendered for another media playback
+ element</a> for which the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> is being rendered, if any. If there is no <a href="#dfn-media-element" class="internalDFN">media
+ element</a> (i.e. if the <a href="#dfn-text-track" class="internalDFN">text track</a> is being rendered for another media playback
mechanism), then inherited properties on the root <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">list of WebVTT Node Objects</a> and the <a title="WebVTT region object" href="#dfn-webvtt-region-object" class="internalDFN">WebVTT region objects</a> must take their initial values.</p>
<p>If there are style sheets that apply to the <a href="#dfn-media-element" class="internalDFN">media element</a> or other playback mechanism,
@@ -4787,22 +4787,23 @@
<section id="css-extensions">
<h3 role="heading" id="h3_css-extensions"><span class="secno">6.3 </span>CSS extensions</h3>
- <p>When a user agent is rendering one or more <a title="text track cue" href="#dfn-text-track-cue" class="internalDFN">text track cues</a>
- according to the <a href="#dfn-rules-for-updating-the-display-of-webvtt-text-tracks" class="internalDFN">rules for updating the display of WebVTT text tracks</a>, <a title="WebVTT
- Node Object" href="#dfn-webvtt-node-object" class="internalDFN">WebVTT Node Objects</a> in the <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">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 title="WebVTT Node Object" href="#dfn-webvtt-node-object" class="internalDFN">WebVTT Node Objects</a> while a <a title="text track cue" href="#dfn-text-track-cue" class="internalDFN">cue</a> is being rendered, even in between applications of the <a href="#dfn-rules-for-updating-the-display-of-webvtt-text-tracks" class="internalDFN">rules
- for updating the display of WebVTT text tracks</a> (which are only run when the set of active
- cues changes). User agents that support the pseudo-element described below must dynamically
- update renderings accordingly. When either 'white-space' or one of the properties corresponding
- to the 'font' shorthand (including 'line-height') changes value, then the <a href="#dfn-text-track-cue" class="internalDFN">text track
- cue</a>'s <a href="#dfn-text-track-cue-display-state" class="internalDFN">text track cue display state</a> must be emptied and the <a href="#dfn-text-track" class="internalDFN">text track</a>'s
- <a href="#dfn-rules-for-updating-the-text-track-rendering" class="internalDFN">rules for updating the text track rendering</a> must be immediately rerun.</p>
+ <p>When a user agent is rendering one or more <a title="WebVTT cue" href="#dfn-webvtt-cue" class="internalDFN">WebVTT cues</a> according to
+ the <a href="#dfn-rules-for-updating-the-display-of-webvtt-text-tracks" class="internalDFN">rules for updating the display of WebVTT text tracks</a>, <a title="WebVTT Node
+ Object" href="#dfn-webvtt-node-object" class="internalDFN">WebVTT Node Objects</a> in the <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">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 title="WebVTT Node Object" href="#dfn-webvtt-node-object" class="internalDFN">WebVTT Node Objects</a> while a <a title="text
+ track cue" href="#dfn-text-track-cue" class="internalDFN">cue</a> is being rendered, even in between applications of the <a href="#dfn-rules-for-updating-the-display-of-webvtt-text-tracks" class="internalDFN">rules for updating
+ the display of WebVTT text tracks</a> (which are only run when the set of active cues changes).
+ User agents that support the pseudo-element described below must dynamically update renderings
+ accordingly. When either 'white-space' or one of the properties corresponding to the 'font'
+ shorthand (including 'line-height') changes value, then the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a>'s <a href="#dfn-text-track-cue-display-state" class="internalDFN">text track
+ cue display state</a> must be emptied and the <a href="#dfn-text-track" class="internalDFN">text track</a>'s <a href="#dfn-rules-for-updating-the-text-track-rendering" class="internalDFN">rules for updating the text
+ track rendering</a> must be immediately rerun.</p>
<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 title="text track cue" href="#dfn-text-track-cue" class="internalDFN">text track cues</a>
- that are being rendered for the <i>matched element</i>.</p>
+ following sections affect the styling of parts of <a title="WebVTT cue" href="#dfn-webvtt-cue" class="internalDFN">WebVTT cues</a> that are
+ being rendered for the <i>matched element</i>.</p>
<div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_32"><span>Note</span></div><p class="">If the <i>matched element</i> is not a <a href="#dfn-video" class="internalDFN"><code>video</code></a> element, the
pseudo-elements defined below won't have any effect according to this specification.</p></div>
@@ -4989,7 +4990,7 @@
Node Object" href="#dfn-webvtt-node-object" class="internalDFN">WebVTT Node Objects</a> that are <i>in the past</i>.</p>
<p>A <a href="#dfn-webvtt-node-object" class="internalDFN">WebVTT Node Object</a> <var>c</var> is <dfn id="dfn-in-the-past">in the past</dfn> if, in a pre-order,
- depth-first traversal of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a>'s <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">list of WebVTT Node Objects</a>, there
+ depth-first traversal of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a>'s <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">list of WebVTT Node Objects</a>, there
exists a <a href="#dfn-webvtt-timestamp-object" class="internalDFN">WebVTT Timestamp Object</a> whose value is less than the <a href="#dfn-current-playback-position" class="internalDFN">current playback
position</a> of the <a href="#dfn-media-element" class="internalDFN">media element</a> that is the <i>matched element</i>, entirely after the
<a href="#dfn-webvtt-node-object" class="internalDFN">WebVTT Node Object</a> <var>c</var>.</p>
@@ -4997,7 +4998,7 @@
<p>The <dfn title="future-pseudo-class" id="dfn-future-pseudo-class">':future'</dfn> pseudo-class only matches <a title="WebVTT Node Object" href="#dfn-webvtt-node-object" class="internalDFN">WebVTT Node Objects</a> that are <i>in the future</i>.</p>
<p>A <a href="#dfn-webvtt-node-object" class="internalDFN">WebVTT Node Object</a> <var>c</var> is <dfn id="dfn-in-the-future">in the future</dfn> if, in a pre-order,
- depth-first traversal of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a>'s <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">list of WebVTT Node Objects</a>, there
+ depth-first traversal of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a>'s <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">list of WebVTT Node Objects</a>, there
exists a <a href="#dfn-webvtt-timestamp-object" class="internalDFN">WebVTT Timestamp Object</a> whose value is greater than the <a href="#dfn-current-playback-position" class="internalDFN">current playback
position</a> of the <a href="#dfn-media-element" class="internalDFN">media element</a> that is the <i>matched element</i>, entirely before
the <a href="#dfn-webvtt-node-object" class="internalDFN">WebVTT Node Object</a> <var>c</var>.</p>
@@ -5026,9 +5027,9 @@
objects</a> used in the rendering can be matched by the above pseudo-element. User agents that
support the pseudo-element must dynamically update renderings accordingly. When either
'white-space' or one of the properties corresponding to the 'font' shorthand (including
- 'line-height') changes value, then the text track cue display state of all the text track cues
- in the region must be emptied and the text track's rules for updating the text track rendering
- must be immediately rerun.</p>
+ 'line-height') changes value, then the text track cue display state of all the <a title="WebVTT
+ cue" href="#dfn-webvtt-cue" class="internalDFN">WebVTT cues</a> in the region must be emptied and the text track's rules for updating the
+ text track rendering must be immediately rerun.</p>
<p>A CSS user agent that implements the text tracks model must implement the '::cue-region'
pseudo-element.</p>
@@ -5199,8 +5200,7 @@
<ol>
- <li><p>Create a new <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a>. Let <var>cue</var> be that <a href="#dfn-text-track-cue" class="internalDFN">text track
- cue</a>.</p></li>
+ <li><p>Create a new <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a>. Let <var>cue</var> be that <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a>.</p></li>
<li><p>Let <var>cue</var>'s <a href="#dfn-text-track-cue-start-time" class="internalDFN">text track cue start time</a> be the value of the
<var>startTime</var> argument, interpreted as a time in seconds.</p></li>
@@ -5248,12 +5248,12 @@
<p>The <dfn title="VTTCue-region" id="dfn-vttcue-region"><code>region</code></dfn> attribute, on getting, must return
the <a href="#dfn-vttregion" class="internalDFN"><code>VTTRegion</code></a> object representing the <a href="#dfn-text-track-cue-region" class="internalDFN">text track cue region</a> of the
- <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents, if any; or null
+ <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents, if any; or null
otherwise. On setting, the <a href="#dfn-text-track-cue-region" class="internalDFN">text track cue region</a> must be set to the new value.</p>
<p>The <dfn title="VTTCue-vertical" id="dfn-vttcue-vertical"><code>vertical</code></dfn> attribute, on getting, must
return the string from the second cell of the row in the table below whose first cell is the
- <a href="#dfn-text-track-cue-writing-direction" class="internalDFN">text track cue writing direction</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that the
+ <a href="#dfn-text-track-cue-writing-direction" class="internalDFN">text track cue writing direction</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> that the
<a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents:</p>
<table>
@@ -5286,21 +5286,22 @@
the new value.</p>
<p>The <dfn title="VTTCue-snapToLines" id="dfn-vttcue-snaptolines"><code>snapToLines</code></dfn> attribute, on getting,
- must return true if the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue snap-to-lines flag</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a>
- that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents is set; or false otherwise. On setting,
- the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue snap-to-lines flag</a> must be set if the new value is true, and must be
- unset otherwise.</p>
+ must return true if the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue snap-to-lines flag</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> that
+ the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents is set; or false otherwise. On setting, the
+ <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue snap-to-lines flag</a> must be set if the new value is true, and must be unset
+ otherwise.</p>
<p>The <dfn title="VTTCue-line" id="dfn-vttcue-line"><code>line</code></dfn> attribute, on getting, must return the
- <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that the
- <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents. The special value <a title="text track cue
- automatic line position" href="#dfn-text-track-cue-automatic-line-position" class="internalDFN">auto</a> must be represented as the string "<code>auto</code>". On
- setting, the <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a> must be set to the new value; if the new value
- is the string "<code>auto</code>", then it must be interpreted as the special value <a title="text track cue automatic line position" href="#dfn-text-track-cue-automatic-line-position" class="internalDFN">auto</a>.</p>
+ <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a>
+ object represents. The special value <a title="text track cue automatic line position" href="#dfn-text-track-cue-automatic-line-position" class="internalDFN">auto</a>
+ must be represented as the string "<code>auto</code>". On setting, the <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line
+ position</a> must be set to the new value; if the new value is the string "<code>auto</code>",
+ then it must be interpreted as the special value <a title="text track cue automatic line
+ position" href="#dfn-text-track-cue-automatic-line-position" class="internalDFN">auto</a>.</p>
<p>The <dfn title="VTTCue-lineAlign" id="dfn-vttcue-linealign"><code>lineAlign</code></dfn> attribute, on getting, must
return the string from the second cell of the row in the table below whose first cell is the
- <a href="#dfn-text-track-cue-line-alignment" class="internalDFN">text track cue line alignment</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that the
+ <a href="#dfn-text-track-cue-line-alignment" class="internalDFN">text track cue line alignment</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> that the
<a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents:</p>
<table>
@@ -5331,7 +5332,7 @@
the new value.</p>
<p>The <dfn title="VTTCue-position" id="dfn-vttcue-position"><code>position</code></dfn> attribute, on getting, must
- return the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that the
+ return the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> that the
<a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents. The special value <a title="text track cue
automatic text position" href="#dfn-text-track-cue-automatic-text-position" class="internalDFN">auto</a> must be represented as the string "<code>auto</code>". On
setting, if the new value is negative or greater than 100, then an
@@ -5342,7 +5343,7 @@
<p>The <dfn title="VTTCue-positionAlign" id="dfn-vttcue-positionalign"><code>positionAlign</code></dfn> attribute, on getting,
must return the string from the second cell of the row in the table below whose first cell is
- the <a href="#dfn-text-track-cue-text-position-alignment" class="internalDFN">text track cue text position alignment</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that the
+ the <a href="#dfn-text-track-cue-text-position-alignment" class="internalDFN">text track cue text position alignment</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> that the
<a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents:</p>
<table>
@@ -5377,14 +5378,14 @@
match for the new value.</p>
<p>The <dfn title="VTTCue-size" id="dfn-vttcue-size"><code>size</code></dfn> attribute, on getting, must return the
- <a href="#dfn-text-track-cue-size" class="internalDFN">text track cue size</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a>
- object represents. On setting, if the new value is negative or greater than 100, then an
+ <a href="#dfn-text-track-cue-size" class="internalDFN">text track cue size</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object
+ represents. On setting, if the new value is negative or greater than 100, then an
<a href="#dfn-indexsizeerror" class="internalDFN"><code>IndexSizeError</code></a> exception must be thrown. Otherwise, the <a href="#dfn-text-track-cue-size" class="internalDFN">text track cue
size</a> must be set to the new value.</p>
<p>The <dfn title="VTTCue-align" id="dfn-vttcue-align"><code>align</code></dfn> attribute, on getting, must return the
string from the second cell of the row in the table below whose first cell is the <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track
- cue text alignment</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object
+ cue text alignment</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object
represents:</p>
<table>
@@ -5423,7 +5424,7 @@
the new value.</p>
<p>The <dfn title="VTTCue-text" id="dfn-vttcue-text"><code>text</code></dfn> attribute, on getting, must return the
- raw <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a>
+ raw <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a>
[3 lines skipped]
Received on Monday, 9 March 2015 04:43:02 UTC