- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Mon, 12 May 2014 19:04:28 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory roscoe:/tmp/cvs-serv11573
Modified Files:
Overview.html
Log Message:
Sync WebVTT with Git commit ce4b4907bf827de34cf1ddc3542ccfd0a65bad0e
--- /sources/public/html5/webvtt/Overview.html 2014/05/12 08:47:08 1.129
+++ /sources/public/html5/webvtt/Overview.html 2014/05/12 19:04:28 1.130
@@ -327,7 +327,7 @@
<p>This specification is being developed as a Living Specification. There is a plan to take a snapshot and publish it as a W3C Recommendation through the <a href="http://www.w3.org/AudioVideo/TT/">W3C Timed Text Working Group</a>.</p>
-</section><section id="toc"><h2 class="introductory" aria-level="1" role="heading" id="h2_toc">Table of Contents</h2><ul class="toc" role="directory" id="respecContents"><li class="tocline"><a href="#introduction" class="tocxref"><span class="secno">1. </span>Introduction</a><ul class="toc"><li class="tocline"><a href="#cues-with-multiple-lines" class="tocxref"><span class="secno">1.1 </span>Cues with multiple lines</a></li><li class="tocline"><a href="#comments" class="tocxref"><span class="secno">1.2 </span>Comments</a></li><li class="tocline"><a href="#other-features" class="tocxref"><span class="secno">1.3 </span>Other features</a></li></ul></li><li class="tocline"><a href="#conformance" class="tocxref"><span class="secno">2. </span>Conformance</a><ul class="toc"><li class="tocline"><a href="#dependencies" class="tocxref"><span class="secno">2.1 </span>Dependencies</a></li></ul></li><li class="tocline"><a href="#data-model" class="tocxref"><span class="secno">3. </span>Data model</a><ul class="toc"><liclass="tocline"><a href="#text-track-cues" class="tocxref"><span class="secno">3.1 </span>Text track cues</a></li><li class="tocline"><a href="#text-track-regions" class="tocxref"><span class="secno">3.2 </span>Text track regions</a></li></ul></li><li class="tocline"><a href="#syntax" class="tocxref"><span class="secno">4. </span>Syntax</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-structure" class="tocxref"><span class="secno">4.1 </span>WebVTT file structure</a></li><li class="tocline"><a href="#webvtt-comments" class="tocxref"><span class="secno">4.2 </span>WebVTT comments</a></li><li class="tocline"><a href="#types-of-webvtt-cue-payload" class="tocxref"><span class="secno">4.3 </span>Types of WebVTT cue payload</a><ul class="toc"><li class="tocline"><a href="#webvtt-metadata-text" class="tocxref"><span class="secno">4.3.1 </span>WebVTT metadata text</a></li><li class="tocline"><a href="#webvtt-cue-text" class="tocxref"><span class="secno">4.3.2 </span>WebVTT cue text</a></li></ul></li><liclass="tocline"><a href="#webvtt-cue-settings" class="tocxref"><span class="secno">4.4 </span>WebVTT cue settings</a><ul class="toc"><li class="tocline"><a href="#webvtt-region-definition" class="tocxref"><span class="secno">4.4.1 </span>WebVTT region definition</a></li><li class="tocline"><a href="#webvtt-cue-settings-1" class="tocxref"><span class="secno">4.4.2 </span>WebVTT cue settings</a></li></ul></li><li class="tocline"><a href="#properties-of-cue-sequences" class="tocxref"><span class="secno">4.5 </span>Properties of cue sequences</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-using-only-nested-cues" class="tocxref"><span class="secno">4.5.1 </span>WebVTT file using only nested cues</a></li></ul></li><li class="tocline"><a href="#types-of-webvtt-files" class="tocxref"><span class="secno">4.6 </span>Types of WebVTT files</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-using-metadata-content" class="tocxref"><span class="secno">4.6.1 </span>WebVTT file using metadata content/a></li><li class="tocline"><a href="#webvtt-file-using-chapter-title-text" class="tocxref"><span class="secno">4.6.2 </span>WebVTT file using chapter title text</a></li><li class="tocline"><a href="#webvtt-file-using-cue-text" class="tocxref"><span class="secno">4.6.3 </span>WebVTT file using cue text</a></li></ul></li></ul></li><li class="tocline"><a href="#parsing" class="tocxref"><span class="secno">5. </span>Parsing</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-parsing" class="tocxref"><span class="secno">5.1 </span>WebVTT file parsing</a></li><li class="tocline"><a href="#webvtt-region-settings-parsing" class="tocxref"><span class="secno">5.2 </span>WebVTT region settings parsing</a></li><li class="tocline"><a href="#webvtt-cue-timings-and-settings-parsing" class="tocxref"><span class="secno">5.3 </span>WebVTT cue timings and settings parsing</a></li><li class="tocline"><a href="#webvtt-cue-text-parsing-rules" class="tocxref"><span class="secno">5.4 </span><span>WebVTT cue text parsing ules</span></a></li><li class="tocline"><a href="#webvtt-cue-text-dom-construction-rules" class="tocxref"><span class="secno">5.5 </span><span>WebVTT cue text DOM construction rules</span></a></li></ul></li><li class="tocline"><a href="#rendering" class="tocxref"><span class="secno">6. </span>Rendering</a><ul class="toc"><li class="tocline"><a href="#cues-in-isolation" class="tocxref"><span class="secno">6.1 </span>Cues in isolation</a></li><li class="tocline"><a href="#cues-with-video" class="tocxref"><span class="secno">6.2 </span>Cues with video</a><ul class="toc"><li class="tocline"><a href="#processing-model" class="tocxref"><span class="secno">6.2.1 </span>Processing model</a></li><li class="tocline"><a href="#applying-css-properties-to-webvtt-node-objects" class="tocxref"><span class="secno">6.2.2 </span>Applying CSS properties to <span title="WebVTT Node Object" class="formerLink">WebVTT Node Objects</span></a></li><li class="tocline"><a href="#css-extensions" class="tocxref"><span class="secno">6.23 </span>CSS extensions</a><ul class="toc"><li class="tocline"><a href="#the-cue-pseudo-element" class="tocxref"><span class="secno">6.2.3.1 </span>The '::cue' pseudo-element</a></li><li class="tocline"><a href="#the-past-and-future-pseudo-classes" class="tocxref"><span class="secno">6.2.3.2 </span>The ':past' and ':future' pseudo-classes</a></li><li class="tocline"><a href="#the-cue-region-pseudo-element" class="tocxref"><span class="secno">6.2.3.3 </span>The '::cue-region' pseudo-element</a></li></ul></li></ul></li></ul></li><li class="tocline"><a href="#api" class="tocxref"><span class="secno">7. </span>API</a><ul class="toc"><li class="tocline"><a href="#the-vttcue-interface" class="tocxref"><span class="secno">7.1 </span>The <code>VTTCue</code> interface</a></li><li class="tocline"><a href="#the-vttregion-interface" class="tocxref"><span class="secno">7.2 </span>The <code>VTTRegion</code> interface</a></li></ul></li><li class="tocline"><a href="#iana-considerations" class="tocxref"><span class="secno">. </span>IANA considerations</a><ul class="toc"><li class="tocline"><a href="#text-vtt" class="tocxref"><span class="secno">8.1 </span><span><code>text/vtt</code></span></a></li></ul></li><li class="tocline"><a href="#references-1" class="tocxref"><span class="secno">9. </span>References</a></li><li class="tocline"><a href="#acknowledgements" class="tocxref"><span class="secno">10. </span>Acknowledgements</a></li></ul></section>
+</section><section id="toc"><h2 class="introductory" aria-level="1" role="heading" id="h2_toc">Table of Contents</h2><ul class="toc" role="directory" id="respecContents"><li class="tocline"><a href="#introduction" class="tocxref"><span class="secno">1. </span>Introduction</a><ul class="toc"><li class="tocline"><a href="#cues-with-multiple-lines" class="tocxref"><span class="secno">1.1 </span>Cues with multiple lines</a></li><li class="tocline"><a href="#comments" class="tocxref"><span class="secno">1.2 </span>Comments</a></li><li class="tocline"><a href="#other-features" class="tocxref"><span class="secno">1.3 </span>Other features</a></li></ul></li><li class="tocline"><a href="#conformance" class="tocxref"><span class="secno">2. </span>Conformance</a><ul class="toc"><li class="tocline"><a href="#dependencies" class="tocxref"><span class="secno">2.1 </span>Dependencies</a></li></ul></li><li class="tocline"><a href="#data-model" class="tocxref"><span class="secno">3. </span>Data model</a><ul class="toc"><liclass="tocline"><a href="#text-track-cues" class="tocxref"><span class="secno">3.1 </span>Text track cues</a></li><li class="tocline"><a href="#text-track-regions" class="tocxref"><span class="secno">3.2 </span>Text track regions</a></li></ul></li><li class="tocline"><a href="#syntax" class="tocxref"><span class="secno">4. </span>Syntax</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-structure" class="tocxref"><span class="secno">4.1 </span>WebVTT file structure</a></li><li class="tocline"><a href="#webvtt-comments" class="tocxref"><span class="secno">4.2 </span>WebVTT comments</a></li><li class="tocline"><a href="#types-of-webvtt-cue-payload" class="tocxref"><span class="secno">4.3 </span>Types of WebVTT cue payload</a><ul class="toc"><li class="tocline"><a href="#webvtt-metadata-text" class="tocxref"><span class="secno">4.3.1 </span>WebVTT metadata text</a></li><li class="tocline"><a href="#webvtt-cue-text" class="tocxref"><span class="secno">4.3.2 </span>WebVTT cue text</a></li></ul></li><liclass="tocline"><a href="#webvtt-cue-settings" class="tocxref"><span class="secno">4.4 </span>WebVTT cue settings</a><ul class="toc"><li class="tocline"><a href="#webvtt-region-definition" class="tocxref"><span class="secno">4.4.1 </span>WebVTT region definition</a></li><li class="tocline"><a href="#webvtt-cue-settings-1" class="tocxref"><span class="secno">4.4.2 </span>WebVTT cue settings</a></li></ul></li><li class="tocline"><a href="#properties-of-cue-sequences" class="tocxref"><span class="secno">4.5 </span>Properties of cue sequences</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-using-only-nested-cues" class="tocxref"><span class="secno">4.5.1 </span>WebVTT file using only nested cues</a></li></ul></li><li class="tocline"><a href="#types-of-webvtt-files" class="tocxref"><span class="secno">4.6 </span>Types of WebVTT files</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-using-metadata-content" class="tocxref"><span class="secno">4.6.1 </span>WebVTT file using metadata content/a></li><li class="tocline"><a href="#webvtt-file-using-chapter-title-text" class="tocxref"><span class="secno">4.6.2 </span>WebVTT file using chapter title text</a></li><li class="tocline"><a href="#webvtt-file-using-cue-text" class="tocxref"><span class="secno">4.6.3 </span>WebVTT file using cue text</a></li></ul></li></ul></li><li class="tocline"><a href="#parsing" class="tocxref"><span class="secno">5. </span>Parsing</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-parsing" class="tocxref"><span class="secno">5.1 </span>WebVTT file parsing</a></li><li class="tocline"><a href="#webvtt-region-settings-parsing" class="tocxref"><span class="secno">5.2 </span>WebVTT region settings parsing</a></li><li class="tocline"><a href="#webvtt-cue-timings-and-settings-parsing" class="tocxref"><span class="secno">5.3 </span>WebVTT cue timings and settings parsing</a></li><li class="tocline"><a href="#webvtt-cue-text-parsing-rules" class="tocxref"><span class="secno">5.4 </span><span>WebVTT cue text parsing ules</span></a></li><li class="tocline"><a href="#webvtt-cue-text-dom-construction-rules" class="tocxref"><span class="secno">5.5 </span><span>WebVTT cue text DOM construction rules</span></a></li></ul></li><li class="tocline"><a href="#rendering" class="tocxref"><span class="secno">6. </span>Rendering</a><ul class="toc"><li class="tocline"><a href="#cues-in-isolation" class="tocxref"><span class="secno">6.1 </span>Cues in isolation</a></li><li class="tocline"><a href="#cues-with-video" class="tocxref"><span class="secno">6.2 </span>Cues with video</a><ul class="toc"><li class="tocline"><a href="#processing-model" class="tocxref"><span class="secno">6.2.1 </span>Processing model</a></li><li class="tocline"><a href="#applying-css-properties-to-webvtt-node-objects" class="tocxref"><span class="secno">6.2.2 </span>Applying CSS properties to <span title="WebVTT Node Object" class="formerLink">WebVTT Node Objects</span></a></li><li class="tocline"><a href="#css-extensions" class="tocxref"><span class="secno">6.23 </span>CSS extensions</a><ul class="toc"><li class="tocline"><a href="#the-cue-pseudo-element" class="tocxref"><span class="secno">6.2.3.1 </span>The '::cue' pseudo-element</a></li><li class="tocline"><a href="#the-past-and-future-pseudo-classes" class="tocxref"><span class="secno">6.2.3.2 </span>The ':past' and ':future' pseudo-classes</a></li><li class="tocline"><a href="#the-cue-region-pseudo-element" class="tocxref"><span class="secno">6.2.3.3 </span>The '::cue-region' pseudo-element</a></li></ul></li></ul></li></ul></li><li class="tocline"><a href="#api" class="tocxref"><span class="secno">7. </span>API</a><ul class="toc"><li class="tocline"><a href="#the-vttcue-interface" class="tocxref"><span class="secno">7.1 </span>The <span class="formerLink"><code>VTTCue</code></span> interface</a></li><li class="tocline"><a href="#the-vttregion-interface" class="tocxref"><span class="secno">7.2 </span>The <code>VTTRegion</code> interface</a></li></ul></li><li class="tocline"><a href="#iana-considerations" clas="tocxref"><span class="secno">8. </span>IANA considerations</a><ul class="toc"><li class="tocline"><a href="#text-vtt" class="tocxref"><span class="secno">8.1 </span><span><code>text/vtt</code></span></a></li></ul></li><li class="tocline"><a href="#references-1" class="tocxref"><span class="secno">9. </span>References</a></li><li class="tocline"><a href="#acknowledgements" class="tocxref"><span class="secno">10. </span>Acknowledgements</a></li></ul></section>
@@ -637,10 +637,22 @@
<li><a href="http://encoding.spec.whatwg.org/#utf-8-decode"><dfn id="dfn-utf-8-decode">UTF-8 decode</dfn></a></li>
</ul>
+ <p>The following terms are defined in the DOM specification: <a href="#refsDOM">[DOM]</a></p>
+
+ <ul class="brief">
+ <li><a href="http://dom.spec.whatwg.org/#document"><dfn id="dfn-document"><code>Document</code></dfn></a> interface</li>
+ <li><a href="http://dom.spec.whatwg.org/#interface-documentfragment"><dfn id="dfn-documentfragment"><code>DocumentFragment</code></dfn></a> interface</li>
+ <li><a href="http://dom.spec.whatwg.org/#dom-node-ownerdocument"><dfn id="dfn-ownerdocument"><code>ownerDocument</code></dfn></a> interface</li>
+ <li><a href="http://dom.spec.whatwg.org/#processinginstruction"><dfn id="dfn-processinginstruction"><code>ProcessingInstruction</code></dfn></a> interface</li>
+ <li><a href="http://dom.spec.whatwg.org/#text"><dfn id="dfn-text"><code>Text</code></dfn></a> interface</li>
+ <li><a href="http://dom.spec.whatwg.org/#indexsizeerror"><dfn id="dfn-indexsizeerror"><code>IndexSizeError</code></dfn></a></li>
+ </ul>
+
<p>The following terms are defined in the HTML standard: <a href="#refsHTML5">[HTML5]</a></p>
<ul class="brief">
<li><a href="http://www.w3.org/html/wg/drafts/html/master/#html-elements"><dfn id="dfn-html-elements">HTML elements</dfn></a></li>
+ <li><a href="http://www.w3.org/html/wg/drafts/html/master/#htmlelement"><dfn id="dfn-htmlelement"><code>HTMLElement</code></dfn></a> interface</li>
<li><a href="http://www.w3.org/html/wg/drafts/html/master/#script's-document"><dfn id="dfn-script-s-document">Script's document</dfn></a></li>
<li><a href="http://www.w3.org/html/wg/drafts/html/master/#entry-script"><dfn id="dfn-entry-script">Entry script</dfn></a></li>
<li><a href="http://www.w3.org/html/wg/drafts/html/master/#mime-type"><dfn id="dfn-mime-type">MIME type</dfn></a></li>
@@ -673,6 +685,7 @@
<li><a href="http://www.w3.org/html/wg/drafts/html/master/#rules-for-updating-the-text-track-rendering"><dfn id="dfn-rules-for-updating-the-text-track-rendering">Rules for updating the text track rendering</dfn></a></li>
<li><a href="http://www.w3.org/html/wg/drafts/html/master/#rules-for-rendering-the-cue-in-isolation"><dfn id="dfn-rules-for-rendering-the-cue-in-isolation">Rules for rendering the cue in isolation</dfn></a></li>
<li><a href="http://www.w3.org/html/wg/drafts/html/master/#texttrackcue"><dfn id="dfn-texttrackcue"><code>TextTrackCue</code></dfn></a> interface</li>
+ <li><a href="http://www.w3.org/html/wg/drafts/html/master/#dom-texttrack-addcue"><dfn id="dfn-addcue"><code>addCue()</code></dfn></a></li>
</ul>
</section>
</section>
@@ -1332,8 +1345,7 @@
terminator</a>.)</p>
<p><a href="#dfn-webvtt-metadata-text" class="internalDFN">WebVTT metadata text</a> cues are only
- useful for scripted applications (using the <code title="dom-TextTrack-kind-metadata">metadata</code> <a href="#dfn-text-track-kind" class="internalDFN">text
- track kind</a>).</p>
+ useful for scripted applications (using the <code>metadata</code> <a href="#dfn-text-track-kind" class="internalDFN">text track kind</a>).</p>
</section>
@@ -3656,7 +3668,7 @@
<h3 aria-level="2" role="heading" id="h3_webvtt-cue-text-dom-construction-rules"><span class="secno">5.5 </span><dfn id="dfn-webvtt-cue-text-dom-construction-rules">WebVTT cue text DOM construction rules</dfn></h3>
<p>To convert a <a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">list of WebVTT Node Objects</a> to a DOM
- tree for <code>Document</code> <var title="">owner</var>, user
+ tree for <a href="#dfn-document" class="internalDFN"><code>Document</code></a> <var title="">owner</var>, user
agents must create a tree of DOM nodes that is isomorphous to the
tree of <a title="WebVTT Node Object" href="#dfn-webvtt-node-object" class="internalDFN">WebVTT Node Objects</a>,
with the following mapping of <a title="WebVTT Node
@@ -3672,62 +3684,62 @@
<tbody>
<tr>
<td><a href="#dfn-list-of-webvtt-node-objects" class="internalDFN">List of WebVTT Node Objects</a></td>
- <td><code>DocumentFragment</code> node</td>
+ <td><a href="#dfn-documentfragment" class="internalDFN"><code>DocumentFragment</code></a> node</td>
</tr>
<tr>
<td><a href="#dfn-webvtt-region-object" class="internalDFN">WebVTT Region Object</a></td>
- <td><code>DocumentFragment</code> node</td>
+ <td><a href="#dfn-documentfragment" class="internalDFN"><code>DocumentFragment</code></a> node</td>
</tr>
<tr>
<td><a href="#dfn-webvtt-class-object" class="internalDFN">WebVTT Class Object</a></td>
- <td><code>HTMLElement</code> element node with <code title="dom-Node-localName">localName</code> "<code>span</code>".</td>
+ <td><a href="#dfn-htmlelement" class="internalDFN"><code>HTMLElement</code></a> element node with <code title="dom-Node-localName">localName</code> "<code>span</code>".</td>
</tr>
<tr>
<td><a href="#dfn-webvtt-italic-object" class="internalDFN">WebVTT Italic Object</a></td>
- <td><code>HTMLElement</code> element node with <code title="dom-Node-localName">localName</code> "<code>i</code>".</td>
+ <td><a href="#dfn-htmlelement" class="internalDFN"><code>HTMLElement</code></a> element node with <code title="dom-Node-localName">localName</code> "<code>i</code>".</td>
</tr>
<tr>
<td><a href="#dfn-webvtt-bold-object" class="internalDFN">WebVTT Bold Object</a></td>
- <td><code>HTMLElement</code> element node with <code title="dom-Node-localName">localName</code> "<code>b</code>".</td>
+ <td><a href="#dfn-htmlelement" class="internalDFN"><code>HTMLElement</code></a> element node with <code title="dom-Node-localName">localName</code> "<code>b</code>".</td>
</tr>
<tr>
<td><a href="#dfn-webvtt-underline-object" class="internalDFN">WebVTT Underline Object</a></td>
- <td><code>HTMLElement</code> element node with <code title="dom-Node-localName">localName</code> "<code>u</code>".</td>
+ <td><a href="#dfn-htmlelement" class="internalDFN"><code>HTMLElement</code></a> element node with <code title="dom-Node-localName">localName</code> "<code>u</code>".</td>
</tr>
<tr>
<td><a href="#dfn-webvtt-ruby-object" class="internalDFN">WebVTT Ruby Object</a></td>
- <td><code>HTMLElement</code> element node with <code title="dom-Node-localName">localName</code> "<code>ruby</code>".</td>
+ <td><a href="#dfn-htmlelement" class="internalDFN"><code>HTMLElement</code></a> element node with <code title="dom-Node-localName">localName</code> "<code>ruby</code>".</td>
</tr>
<tr>
<td><a href="#dfn-webvtt-ruby-text-object" class="internalDFN">WebVTT Ruby Text Object</a></td>
- <td><code>HTMLElement</code> element node with <code title="dom-Node-localName">localName</code> "<code>rt</code>".</td>
+ <td><a href="#dfn-htmlelement" class="internalDFN"><code>HTMLElement</code></a> element node with <code title="dom-Node-localName">localName</code> "<code>rt</code>".</td>
</tr>
<tr>
<td><a href="#dfn-webvtt-voice-object" class="internalDFN">WebVTT Voice Object</a></td>
- <td><code>HTMLElement</code> element node with <code title="dom-Node-localName">localName</code> "<code>span</code>", and a <code title="attr-title">title</code> attribute set to the <a href="#dfn-webvtt-voice-object" class="internalDFN">WebVTT Voice Object</a>'s value.</td>
+ <td><a href="#dfn-htmlelement" class="internalDFN"><code>HTMLElement</code></a> element node with <code title="dom-Node-localName">localName</code> "<code>span</code>", and a <code title="attr-title">title</code> attribute set to the <a href="#dfn-webvtt-voice-object" class="internalDFN">WebVTT Voice Object</a>'s value.</td>
</tr>
<tr>
<td><a href="#dfn-webvtt-language-object" class="internalDFN">WebVTT Language Object</a></td>
- <td><code>HTMLElement</code> element node with <code title="dom-Node-localName">localName</code> "<code>span</code>", and a <code title="attr-lang">lang</code> attribute set to the <a href="#dfn-webvtt-language-object" class="internalDFN">WebVTT Language Object</a>'s <a title="WebVTT Node Object's applicable language" href="#dfn-webvtt-node-object-s-applicable-language" class="internalDFN">applicable language</a>.</td>
+ <td><a href="#dfn-htmlelement" class="internalDFN"><code>HTMLElement</code></a> element node with <code title="dom-Node-localName">localName</code> "<code>span</code>", and a <code title="attr-lang">lang</code> attribute set to the <a href="#dfn-webvtt-language-object" class="internalDFN">WebVTT Language Object</a>'s <a title="WebVTT Node Object's applicable language" href="#dfn-webvtt-node-object-s-applicable-language" class="internalDFN">applicable language</a>.</td>
</tr>
<tr>
<td><a href="#dfn-webvtt-text-object" class="internalDFN">WebVTT Text Object</a></td>
- <td><code>Text</code> node whose character data is the value of the <a href="#dfn-webvtt-text-object" class="internalDFN">WebVTT Text Object</a>.</td>
+ <td><a href="#dfn-text" class="internalDFN"><code>Text</code></a> node whose character data is the value of the <a href="#dfn-webvtt-text-object" class="internalDFN">WebVTT Text Object</a>.</td>
</tr>
<tr>
<td><a href="#dfn-webvtt-timestamp-object" class="internalDFN">WebVTT Timestamp Object</a></td>
- <td><code>ProcessingInstruction</code> node whose <code title="dom-ProcessingInstruction-target">target</code> is "<code title="">timestamp</code>" and whose <code title="dom-ProcessingInstruction-data">data</code> is a <a href="#dfn-webvtt-timestamp" class="internalDFN">WebVTT timestamp</a> representing the value of the <a href="#dfn-webvtt-timestamp-object" class="internalDFN">WebVTT Timestamp Object</a>, with all optional components included, with one leading zero if the <var title="">hours</var> component is less than ten, and with no leading zeros otherwise.</td>
+ <td><a href="#dfn-processinginstruction" class="internalDFN"><code>ProcessingInstruction</code></a> node whose <code title="dom-ProcessingInstruction-target">target</code> is "<code title="">timestamp</code>" and whose <code title="dom-ProcessingInstruction-data">data</code> is a <a href="#dfn-webvtt-timestamp" class="internalDFN">WebVTT timestamp</a> representing the value of the <a href="#dfn-webvtt-timestamp-object" class="internalDFN">WebVTT Timestamp Object</a>, with all optional components included, with one leading zero if the <var title="">hours</var> component is less than ten, and with no leading zeros otherwise.</td>
</tr>
</tbody>
</table>
- <p><code>HTMLElement</code> nodes created as part of the mapping described above must have their
+ <p><a href="#dfn-htmlelement" class="internalDFN"><code>HTMLElement</code></a> nodes created as part of the mapping described above must have their
<code title="dom-Node-namespaceURI">namespaceURI</code> set to the <a href="#dfn-html-namespace" class="internalDFN">HTML namespace</a>,
and, if the corresponding <a href="#dfn-webvtt-internal-node-object" class="internalDFN">WebVTT Internal Node Object</a> has any <a title="WebVTT
Node Object's applicable classes" href="#dfn-webvtt-node-object-s-applicable-classes" class="internalDFN">applicable classes</a>, must have a <code title="attr-class">class</code> attribute set to the string obtained by concatenating all those
classes, each separated from the next by a single U+0020 SPACE character.</p>
- <p>The <code title="dom-Node-ownerDocument">ownerDocument</code>
+ <p>The <a href="#dfn-ownerdocument" class="internalDFN"><code>ownerDocument</code></a>
attribute of all nodes in the DOM tree must be set to the given
document <var title="">owner</var>.</p>
@@ -4160,7 +4172,7 @@
<li>For the purposes of processing by the CSS
specification, <a title="WebVTT Text Object" href="#dfn-webvtt-text-object" class="internalDFN">WebVTT Text
- Objects</a> are equivalent to <code>Text</code> nodes.</li>
+ Objects</a> are equivalent to <a href="#dfn-text" class="internalDFN"><code>Text</code></a> nodes.</li>
<li>No style sheets are associated with <var title="">nodes</var>. (The nodes are subsequently restyled
using style sheets after their boxes are generated, as
@@ -4934,7 +4946,7 @@
<!--OddPage--><h2 aria-level="1" role="heading" id="h2_api"><span class="secno">7. </span>API</h2>
<section id="the-vttcue-interface">
- <h3 aria-level="2" role="heading" id="h3_the-vttcue-interface"><span class="secno">7.1 </span>The <code>VTTCue</code> interface</h3>
+ <h3 aria-level="2" role="heading" id="h3_the-vttcue-interface"><span class="secno">7.1 </span>The <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> interface</h3>
<p>The following interface is used to expose WebVTT cues in the DOM API:</p>
@@ -4953,14 +4965,14 @@
attribute double <a title="dom-VTTCue-size" href="#dfn-dom-vttcue-size" class="internalDFN">size</a>;
attribute <a href="#dfn-alignsetting" class="internalDFN">AlignSetting</a> <a title="dom-VTTCue-align" href="#dfn-dom-vttcue-align" class="internalDFN">align</a>;
attribute DOMString <a title="dom-VTTCue-text" href="#dfn-dom-vttcue-text" class="internalDFN">text</a>;
- DocumentFragment <a title="dom-VTTCue-getCueAsHTML" href="#dfn-dom-vttcue-getcueashtml" class="internalDFN">getCueAsHTML</a>();
+ <a href="#dfn-documentfragment" class="internalDFN">DocumentFragment</a> <a title="dom-VTTCue-getCueAsHTML" href="#dfn-dom-vttcue-getcueashtml" class="internalDFN">getCueAsHTML</a>();
};</pre>
<dl class="domintro">
<dt><var title="">cue</var> = new <code title="dom-VTTCue">VTTCue</code>( <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var> )</dt>
<dd>
- <p>Returns a new <code>VTTCue</code> object, for use with the <code title="dom-TextTrack-addCue">addCue()</code> method.</p>
+ <p>Returns a new <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object, for use with the <a href="#dfn-addcue" class="internalDFN"><code>addCue()</code></a> method.</p>
<p>The <var title="">startTime</var> argument sets the <a href="#dfn-text-track-cue-start-time" class="internalDFN">text track cue start time</a>.</p>
<p>The <var title="">endTime</var> argument sets the <a href="#dfn-text-track-cue-end-time" class="internalDFN">text track cue end time</a>.</p>
<p>The <var title="">text</var> argument sets the <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a>.</p>
@@ -4968,7 +4980,7 @@
<dt><var title="">cue</var> . <a title="dom-VTTCue-region" href="#dfn-dom-vttcue-region" class="internalDFN">region</a></dt>
<dd>
- <p>Returns the <code>VTTRegion</code> object to which this cue belongs, if any, or null otherwise.</p>
+ <p>Returns the <a href="#dfn-vttregion" class="internalDFN"><code>VTTRegion</code></a> object to which this cue belongs, if any, or null otherwise.</p>
<p>Can be set.</p>
</dd>
@@ -5067,7 +5079,7 @@
<dt><var title="">fragment</var> = <var title="">cue</var> . <a title="dom-VTTCue-getCueAsHTML" href="#dfn-dom-vttcue-getcueashtml" class="internalDFN">getCueAsHTML</a>()</dt>
<dd>
- <p>Returns the <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a> as a <code>DocumentFragment</code> of <a href="#dfn-html-elements" class="internalDFN">HTML elements</a> and other DOM nodes.</p>
+ <p>Returns the <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a> as a <a href="#dfn-documentfragment" class="internalDFN"><code>DocumentFragment</code></a> of <a href="#dfn-html-elements" class="internalDFN">HTML elements</a> and other DOM nodes.</p>
</dd>
</dl>
@@ -5119,20 +5131,20 @@
<li><p>Let <var title="">cue</var>'s <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text alignment</a> be
<a title="text track cue middle alignment" href="#dfn-text-track-cue-middle-alignment" class="internalDFN">middle alignment</a>.</p></li>
- <li><p>Return the <code>VTTCue</code> object representing <var title="">cue</var>.</p></li>
+ <li><p>Return the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object representing <var title="">cue</var>.</p></li>
</ol>
<p>The <dfn title="dom-VTTCue-region" id="dfn-dom-vttcue-region"><code>region</code></dfn> attribute, on getting, must return
- the <code>VTTRegion</code> 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 <code>VTTCue</code> object represents, if any; or null otherwise. On
+ 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 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="dom-VTTCue-vertical" id="dfn-dom-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 <code>VTTCue</code> object represents:</p>
+ cue</a> that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents:</p>
<table>
<thead>
@@ -5163,13 +5175,13 @@
<p>The <dfn title="dom-VTTCue-snapToLines" id="dfn-dom-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 <code>VTTCue</code> object represents is set; or false otherwise.
+ 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>
<p>The <dfn title="dom-VTTCue-line" id="dfn-dom-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
- <code>VTTCue</code> object represents. The special value <a title="text track cue
+ <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 title="">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 title="">auto</code>", then it must be
interpreted as the special value <a title="text track cue automatic line
@@ -5178,7 +5190,7 @@
<p>The <dfn title="dom-VTTCue-lineAlign" id="dfn-dom-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
- <code>VTTCue</code> object represents:</p>
+ <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents:</p>
<table>
<thead>
@@ -5209,14 +5221,14 @@
<p>The <dfn title="dom-VTTCue-position" id="dfn-dom-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 <code>VTTCue</code> object represents. On setting, if the new value is negative or
- greater than 100, then an <code>IndexSizeError</code> exception must be thrown. Otherwise, the
+ 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-text-position" class="internalDFN">text track cue text position</a> must be set to the new value.</p>
<p>The <dfn title="dom-VTTCue-positionAlign" id="dfn-dom-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
- <code>VTTCue</code> object represents:</p>
+ <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents:</p>
<table>
<thead>
@@ -5247,14 +5259,14 @@
<p>The <dfn title="dom-VTTCue-size" id="dfn-dom-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
- <code>VTTCue</code> object represents. On setting, if the new value is negative or greater
- than 100, then an <code>IndexSizeError</code> exception must be thrown. Otherwise, the <a href="#dfn-text-track-cue-size" class="internalDFN">text
+ <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="dom-VTTCue-align" id="dfn-dom-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
- <code>VTTCue</code> object represents:</p>
+ <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents:</p>
<table>
<thead>
@@ -5293,11 +5305,11 @@
<p>The <dfn title="dom-VTTCue-text" id="dfn-dom-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
- <code>VTTCue</code> object represents. On setting, the <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a> must
+ <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents. On setting, the <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a> must
be set to the new value.</p>
<p>The <dfn title="dom-VTTCue-getCueAsHTML" id="dfn-dom-vttcue-getcueashtml"><code>getCueAsHTML()</code></dfn> method must
- convert the <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a> to a <code>DocumentFragment</code> for the
+ convert the <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a> to a <a href="#dfn-documentfragment" class="internalDFN"><code>DocumentFragment</code></a> for the
<a href="#dfn-script-s-document" class="internalDFN">script's document</a> of the <a href="#dfn-entry-script" class="internalDFN">entry script</a> by applying the <a href="#dfn-webvtt-cue-text-dom-construction-rules" class="internalDFN">WebVTT cue
text DOM construction rules</a> to the result of applying the <a href="#dfn-webvtt-cue-text-parsing-rules" class="internalDFN">WebVTT cue text parsing
rules</a> to the <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a>.</p>
@@ -5330,7 +5342,7 @@
<dt><var title="">region</var> . <a title="dom-VTTRegion-width" href="#dfn-dom-vttregion-width" class="internalDFN">width</a></dt>
<dd>
- <p>Returns the text track region width as a percentage of the video width. Can be set. Throws an IndexSizeError if the new value is not in the range 0..100.</p>
+ <p>Returns the text track region width as a percentage of the video width. Can be set. Throws an <a href="#dfn-indexsizeerror" class="internalDFN"><code>IndexSizeError</code></a> if the new value is not in the range 0..100.</p>
</dd>
<dt><var title="">region</var> . <a title="dom-VTTRegion-lines" href="#dfn-dom-vttregion-lines" class="internalDFN">lines</a></dt>
@@ -5340,22 +5352,22 @@
<dt><var title="">region</var> . <a title="dom-VTTRegion-regionAnchorX" href="#dfn-dom-vttregion-regionanchorx" class="internalDFN">regionAnchorX</a></dt>
<dd>
- <p>Returns the text track region anchor X offset as a percentage of the region width. Can be set. Throws an IndexSizeError if the new value is not in the range 0..100.</p>
+ <p>Returns the text track region anchor X offset as a percentage of the region width. Can be set. Throws an <a href="#dfn-indexsizeerror" class="internalDFN"><code>IndexSizeError</code></a> if the new value is not in the range 0..100.</p>
</dd>
<dt><var title="">region</var> . <a title="dom-VTTRegion-regionAnchorX" href="#dfn-dom-vttregion-regionanchorx" class="internalDFN">regionAnchorX</a></dt>
<dd>
- <p>Returns the text track region anchor Y offset as a percentage of the region height. Can be set. Throws an IndexSizeError if the new value is not in the range 0..100.</p>
+ <p>Returns the text track region anchor Y offset as a percentage of the region height. Can be set. Throws an <a href="#dfn-indexsizeerror" class="internalDFN"><code>IndexSizeError</code></a> if the new value is not in the range 0..100.</p>
</dd>
<dt><var title="">region</var> . <a title="dom-VTTRegion-viewportAnchorX" href="#dfn-dom-vttregion-viewportanchorx" class="internalDFN">viewportAnchorX</a></dt>
<dd>
- <p>Returns the text track region viewport anchor X offset as a percentage of the video width. Can be set. Throws an IndexSizeError if the new value is not in the range 0..100.</p>
+ <p>Returns the text track region viewport anchor X offset as a percentage of the video width. Can be set. Throws an <a href="#dfn-indexsizeerror" class="internalDFN"><code>IndexSizeError</code></a> if the new value is not in the range 0..100.</p>
</dd>
<dt><var title="">region</var> . <a title="dom-VTTRegion-viewportAnchorY" href="#dfn-dom-vttregion-viewportanchory" class="internalDFN">viewportAnchorY</a></dt>
<dd>
- <p>Returns the text track region viewport anchor Y offset as a percentage of the video height. Can be set. Throws an IndexSizeError if the new value is not in the range 0..100.</p>
+ <p>Returns the text track region viewport anchor Y offset as a percentage of the video height. Can be set. Throws an <a href="#dfn-indexsizeerror" class="internalDFN"><code>IndexSizeError</code></a> if the new value is not in the range 0..100.</p>
</dd>
<dt><var title="">region</var> . <a title="dom-VTTRegion-scroll" href="#dfn-dom-vttregion-scroll" class="internalDFN">scroll</a></dt>
@@ -5555,6 +5567,9 @@
<dt id="refsCSSVALUES">[CSSVALUES]</dt>
<dd><cite><a href="http://dev.w3.org/csswg/css3-values/">CSS3 Values and Units</a></cite>, H. Lie, T. Atkins, E. Etemad. W3C.</dd>
+ <dt id="refsDOM">[DOM]</dt>
+ <dd><cite><a href="http://dom.spec.whatwg.org/">W3C DOM 4</a>, A. van Kesteren, A. Gregor, Ms2ger. WHATWG.</cite></dd>
+
<dt id="refsENCODING">[ENCODING]</dt>
<dd><cite><a href="http://encoding.spec.whatwg.org/">Encoding</a></cite>, A. van Kesteren, J. Bell. WHATWG.</dd>
Received on Monday, 12 May 2014 19:04:32 UTC