- From: CVS User spfeiffe <cvsmail@w3.org>
- Date: Mon, 08 Jul 2013 02:26:21 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory roscoe:/tmp/cvs-serv6078
Modified Files:
Overview.html
Log Message:
Rename WebVTTCue to VTTCue. Add acknowledgements.
--- /sources/public/html5/webvtt/Overview.html 2013/07/06 02:23:06 1.66
+++ /sources/public/html5/webvtt/Overview.html 2013/07/08 02:26:21 1.67
@@ -11,7 +11,7 @@
<!-- script to register bugs -->
- <script src="http://dvcs.w3.org/hg/webcomponents/raw-file/tip/assets/scripts/bug-assist.js"></script>
+ <script src="https://dvcs.w3.org/hg/webcomponents/raw-file/tip/assets/scripts/bug-assist.js"></script>
<meta name="bug.short_desc" content="[WebVTT] ">
<meta name="bug.product" content="TextTracks CG">
<meta name="bug.component" content="WebVTT"> <style>
@@ -276,7 +276,7 @@
</p>
<h1 class="title" id="title">WebVTT: The Web Video Text Tracks Format</h1>
- <h2 id="draft-community-group-specification-06-july-2013">Draft Community Group Specification <time class="dt-published" datetime="2013-07-06">06 July 2013</time></h2>
+ <h2 id="draft-community-group-specification-08-july-2013">Draft Community Group Specification <time class="dt-published" datetime="2013-07-08">08 July 2013</time></h2>
<dl>
@@ -334,7 +334,7 @@
<p>This specification was originally created by the WHATWG as a Living Standard and last published at <a href="http://dev.w3.org/html5/webvtt/">http://dev.w3.org/html5/webvtt/</a>.
</p>
-</section><section id="toc"><h2 class="introductory">Table of Contents</h2><ul class="toc"><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"><li class="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-region" class="tocxref"><span class="secno">3.2 </span>Text Track Region</a></li></ul></li><li class="tocline"><a href="#the-webvtt-file-format-syntax" class="tocxref"><span class="secno">4. </span>The WebVTT file format: 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><li class="tocline"><a href="#webvtt-ue-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 hrf="#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="#webvtt-file-format-parsing" class="tocxref"><span class="secno">5. </span>WebVTT file format: 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 paring rules</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.2.3 </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="#webvtt-api-for-browsers" class="tocxref"><span class="secno">7. </span>WebVTT API for Browsers</a><ul class="toc"><li class="tocline"><a href="#webvttcue-interface" class="tocxref"><span class="secno">7.1 </span>WebVTTCue interface</a></li><li class="tocline"><a href="#extension-of-the-texttrack-interface-for-region-support" class="tocxref"><span class="secno">7.2 </span>Extension of the TextTrack interface for region support</a></li><li class="toclie"><a href="#extension-of-the-texttrackcue-interface-for-region-support" class="tocxref"><span class="secno">7.3 </span>Extension of the TextTrackCue interface for region support</a></li><li class="tocline"><a href="#texttrackregion-interface" class="tocxref"><span class="secno">7.4 </span>TextTrackRegion interface</a></li><li class="tocline"><a href="#texttrackregionlist-interface" class="tocxref"><span class="secno">7.5 </span>TextTrackRegionList interface</a></li></ul></li><li class="tocline"><a href="#iana-considerations" class="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>
+</section><section id="toc"><h2 class="introductory">Table of Contents</h2><ul class="toc"><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"><li class="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-region" class="tocxref"><span class="secno">3.2 </span>Text Track Region</a></li></ul></li><li class="tocline"><a href="#the-webvtt-file-format-syntax" class="tocxref"><span class="secno">4. </span>The WebVTT file format: 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><li class="tocline"><a href="#webvtt-ue-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 hrf="#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="#webvtt-file-format-parsing" class="tocxref"><span class="secno">5. </span>WebVTT file format: 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 paring rules</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.2.3 </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="#webvtt-api-for-browsers" class="tocxref"><span class="secno">7. </span>WebVTT API for Browsers</a><ul class="toc"><li class="tocline"><a href="#vttcue-interface" class="tocxref"><span class="secno">7.1 </span>VTTCue interface</a></li><li class="tocline"><a href="#extension-of-the-texttrack-interface-for-region-support" class="tocxref"><span class="secno">7.2 </span>Extension of the TextTrack interface for region support</a></li><li class="tocline"><ahref="#texttrackregion-interface" class="tocxref"><span class="secno">7.3 </span>TextTrackRegion interface</a></li><li class="tocline"><a href="#texttrackregionlist-interface" class="tocxref"><span class="secno">7.4 </span>TextTrackRegionList interface</a></li></ul></li><li class="tocline"><a href="#iana-considerations" class="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>
<section id="introduction">
<!--OddPage--><h2><span class="secno">1. </span>Introduction</h2>
@@ -915,7 +915,7 @@
characters that are not U+000A LINE FEED (LF) or U+000D CARRIAGE
RETURN (CR) characters.</li> <!-- allows for Emacs line -->
- <li>One or more <a title="WebVTT line terminator" href="#dfn-webvtt-line-terminator" class="internalDFN">WebVTT line terminators</a> to
+ <li>Exactly one <a title="WebVTT line terminator" href="#dfn-webvtt-line-terminator" class="internalDFN">WebVTT line terminators</a> to
terminate the line with the file magic and separate it from the rest of the body.</li>
<li>Zero or more <a title="WebVTT metadata header" href="#dfn-webvtt-metadata-header" class="internalDFN">WebVTT metadata headers</a>.</li>
@@ -1938,7 +1938,6 @@
<li>Add <var>region</var> to the <a href="#dfn-text-track-list-of-regions" class="internalDFN">text track list of regions</a> <var>regions</var>.</li>
</ol>
</li>
- <li><p>Jump back to the step labeled header.</p></li>
</ol>
</li>
@@ -1955,8 +1954,6 @@
HYPHEN-MINUS, U+003E GREATER-THAN SIGN), then set the <var title="">already collected line</var> flag and jump to the step
labeled <i>cue loop</i>.</p></li>
- <!-- In v2, this is where we can put header metadata processing -->
-
<li><p>If <var title="">line</var> is not the empty string, then
jump back to the step labeled <i title="">header</i>.</p></li>
@@ -4769,27 +4766,28 @@
<section id="webvtt-api-for-browsers">
<!--OddPage--><h2><span class="secno">7. </span>WebVTT API for Browsers</h2>
- <section id="webvttcue-interface">
- <h3><span class="secno">7.1 </span>WebVTTCue interface</h3>
+ <section id="vttcue-interface">
+ <h3><span class="secno">7.1 </span>VTTCue interface</h3>
<p>The following interface is used to expose WebVTT cues in the DOM API:</p>
<pre class="idl_whatwg">enum <dfn id="dfn-autokeyword">AutoKeyword</dfn> { "auto" };
-[<a title="dom-TextTrackCue" href="#dfn-dom-texttrackcue" class="internalDFN">Constructor</a>(double startTime, double endTime, DOMString text)]
-interface <dfn id="dfn-webvttcue">WebVTTCue</dfn> : <a href="#dfn-texttrackcue" class="internalDFN">TextTrackCue</a> {
- attribute DOMString <a title="dom-TextTrackCue-vertical" href="#dfn-dom-texttrackcue-vertical" class="internalDFN">vertical</a>;
- attribute boolean <a title="dom-TextTrackCue-snapToLines" href="#dfn-dom-texttrackcue-snaptolines" class="internalDFN">snapToLines</a>;
- attribute (long or <a href="#dfn-autokeyword" class="internalDFN">AutoKeyword</a>) <a title="dom-TextTrackCue-line" href="#dfn-dom-texttrackcue-line" class="internalDFN">line</a>;
- attribute long <a title="dom-TextTrackCue-position" href="#dfn-dom-texttrackcue-position" class="internalDFN">position</a>;
- attribute long <a title="dom-TextTrackCue-size" href="#dfn-dom-texttrackcue-size" class="internalDFN">size</a>;
- attribute DOMString <a title="dom-TextTrackCue-align" href="#dfn-dom-texttrackcue-align" class="internalDFN">align</a>;
- attribute DOMString <a title="dom-TextTrackCue-text" href="#dfn-dom-texttrackcue-text" class="internalDFN">text</a>;
- DocumentFragment <a title="dom-TextTrackCue-getCueAsHTML" href="#dfn-dom-texttrackcue-getcueashtml" class="internalDFN">getCueAsHTML</a>();
+[<a title="dom-VTTCue" href="#dfn-dom-vttcue" class="internalDFN">Constructor</a>(double startTime, double endTime, DOMString text)]
+interface <dfn id="dfn-vttcue">VTTCue</dfn> : <a href="#dfn-texttrackcue" class="internalDFN">TextTrackCue</a> {
+ attribute DOMString <a title="dom-VTTCue-regionId">regionId</a>;
+ attribute DOMString <a title="dom-VTTCue-vertical" href="#dfn-dom-vttcue-vertical" class="internalDFN">vertical</a>;
+ attribute boolean <a title="dom-VTTCue-snapToLines" href="#dfn-dom-vttcue-snaptolines" class="internalDFN">snapToLines</a>;
+ attribute (long or <a href="#dfn-autokeyword" class="internalDFN">AutoKeyword</a>) <a title="dom-VTTCue-line" href="#dfn-dom-vttcue-line" class="internalDFN">line</a>;
+ attribute long <a title="dom-VTTCue-position" href="#dfn-dom-vttcue-position" class="internalDFN">position</a>;
+ attribute long <a title="dom-VTTCue-size" href="#dfn-dom-vttcue-size" class="internalDFN">size</a>;
+ attribute DOMString <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>();
};</pre>
<dl class="domintro">
- <dt><var title="">cue</var> = new <code title="dom-TextTrackCue">WebVTTCue</code>( <var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var> )</dt>
+ <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>TextTrackCue</code> object, for use with the <code title="dom-TextTrack-addCue">addCue()</code> 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>
@@ -4797,7 +4795,13 @@
<p>The <var title="">text</var> argument sets the <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a>.</p>
</dd>
- <dt><var title="">cue</var> . <a title="dom-TextTrackCue-vertical" href="#dfn-dom-texttrackcue-vertical" class="internalDFN">vertical</a> [ = <var title="">value</var> ]</dt>
+ <dt><var title="">cue</var> . <a title="dom-VTTCue-regionId">regionId</a></dt>
+ <dd>
+ <p>Returns a string representing the <a href="#dfn-text-track-cue-region-identifier" class="internalDFN">text track cue region identifier</a> of the text track region that the <a href="#dfn-texttrackcue" class="internalDFN">TextTrackCue</a> object belongs to. If the <a href="#dfn-texttrackcue" class="internalDFN">TextTrackCue</a> doesn't belong to a text track region, returns the empty string.</p>
+ <p>Can be set.</p>
+ </dd>
+
+ <dt><var title="">cue</var> . <a title="dom-VTTCue-vertical" href="#dfn-dom-vttcue-vertical" class="internalDFN">vertical</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns a string representing the <a href="#dfn-text-track-cue-writing-direction" class="internalDFN">text track cue writing direction</a>, as follows:</p>
<dl class="switch">
@@ -4811,13 +4815,13 @@
<p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a title="dom-TextTrackCue-snapToLines" href="#dfn-dom-texttrackcue-snaptolines" class="internalDFN">snapToLines</a> [ = <var title="">value</var> ]</dt>
+ <dt><var title="">cue</var> . <a title="dom-VTTCue-snapToLines" href="#dfn-dom-vttcue-snaptolines" class="internalDFN">snapToLines</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns true if the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue snap-to-lines flag</a> is set, false otherwise.</p>
<p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a title="dom-TextTrackCue-line" href="#dfn-dom-texttrackcue-line" class="internalDFN">line</a> [ = <var title="">value</var> ]</dt>
+ <dt><var title="">cue</var> . <a title="dom-VTTCue-line" href="#dfn-dom-vttcue-line" class="internalDFN">line</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a>. In the
case of the value being <a title="text track cue automatic line
@@ -4826,19 +4830,19 @@
<p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a title="dom-TextTrackCue-position" href="#dfn-dom-texttrackcue-position" class="internalDFN">position</a> [ = <var title="">value</var> ]</dt>
+ <dt><var title="">cue</var> . <a title="dom-VTTCue-position" href="#dfn-dom-vttcue-position" class="internalDFN">position</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a>.</p>
<p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a title="dom-TextTrackCue-size" href="#dfn-dom-texttrackcue-size" class="internalDFN">size</a> [ = <var title="">value</var> ]</dt>
+ <dt><var title="">cue</var> . <a title="dom-VTTCue-size" href="#dfn-dom-vttcue-size" class="internalDFN">size</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href="#dfn-text-track-cue-size" class="internalDFN">text track cue size</a>.</p>
<p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a title="dom-TextTrackCue-align" href="#dfn-dom-texttrackcue-align" class="internalDFN">align</a> [ = <var title="">value</var> ]</dt>
+ <dt><var title="">cue</var> . <a title="dom-VTTCue-align" href="#dfn-dom-vttcue-align" class="internalDFN">align</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns a string representing the <a href="#dfn-text-track-cue-alignment" class="internalDFN">text track cue alignment</a>, as follows:</p>
<dl class="switch">
@@ -4856,20 +4860,20 @@
<p>Can be set.</p>
</dd>
- <dt><var title="">cue</var> . <a title="dom-TextTrackCue-text" href="#dfn-dom-texttrackcue-text" class="internalDFN">text</a> [ = <var title="">value</var> ]</dt>
+ <dt><var title="">cue</var> . <a title="dom-VTTCue-text" href="#dfn-dom-vttcue-text" class="internalDFN">text</a> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a> in raw unparsed form.</p>
<p>Can be set.</p>
</dd>
- <dt><var title="">fragment</var> = <var title="">cue</var> . <a title="dom-TextTrackCue-getCueAsHTML" href="#dfn-dom-texttrackcue-getcueashtml" class="internalDFN">getCueAsHTML</a>()</dt>
+ <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>
</dd>
</dl>
- <p>The <dfn title="dom-TextTrackCue" id="dfn-dom-texttrackcue"><code>WebVTTCue(<var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var>)</code></dfn> constructor, when invoked, must
+ <p>The <dfn title="dom-VTTCue" id="dfn-dom-vttcue"><code>VTTCue(<var title="">startTime</var>, <var title="">endTime</var>, <var title="">text</var>)</code></dfn> constructor, when invoked, must
run the following steps:</p>
<ol>
@@ -4924,7 +4928,7 @@
</ol>
- <p>The <dfn title="dom-TextTrackCue-vertical" id="dfn-dom-texttrackcue-vertical"><code>vertical</code></dfn>
+ <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
@@ -4933,7 +4937,7 @@
<table>
<thead>
<tr> <th> <a href="#dfn-text-track-cue-writing-direction" class="internalDFN">text track cue writing direction</a>
- </th><th> <code title="dom-TextTrackCue-direction">direction</code> value
+ </th><th> <code title="dom-VTTCue-direction">direction</code> value
</th></tr></thead><tbody>
<tr> <td> <a title="text track cue horizontal writing direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">Horizontal</a>
</td><td> "<code title=""></code>" (the empty string)
@@ -4948,13 +4952,13 @@
match for the new value, if any. If none of the values match, then the user agent must instead
throw a <code>SyntaxError</code> exception.</p>
- <p>The <dfn title="dom-TextTrackCue-snapToLines" id="dfn-dom-texttrackcue-snaptolines"><code>snapToLines</code></dfn> attribute, on
+ <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>TextTrackCue</code> 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-TextTrackCue-line" id="dfn-dom-texttrackcue-line"><code>line</code></dfn> attribute, on getting, must
+ <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>TextTrackCue</code> 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
@@ -4962,26 +4966,26 @@
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="dom-TextTrackCue-position" id="dfn-dom-texttrackcue-position"><code>position</code></dfn> attribute, on getting,
+ <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>TextTrackCue</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-text-position" class="internalDFN">text track cue text position</a> must be set to the new value.</p>
- <p>The <dfn title="dom-TextTrackCue-size" id="dfn-dom-texttrackcue-size"><code>size</code></dfn> attribute, on getting, must
+ <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>TextTrackCue</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
track cue size</a> must be set to the new value.</p>
- <p>The <dfn title="dom-TextTrackCue-align" id="dfn-dom-texttrackcue-align"><code>align</code></dfn> attribute, on getting, must
+ <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-alignment" class="internalDFN">text track cue alignment</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that the
<code>TextTrackCue</code> object represents:</p>
<table>
<thead>
- <tr> <th><a href="#dfn-text-track-cue-alignment" class="internalDFN">Text track cue alignment</a> </th><th> <code title="dom-TextTrackCue-align">align</code> value
+ <tr> <th><a href="#dfn-text-track-cue-alignment" class="internalDFN">Text track cue alignment</a> </th><th> <code title="dom-VTTCue-align">align</code> value
</th></tr></thead><tbody>
<tr> <td><a title="text track cue start alignment" href="#dfn-text-track-cue-start-alignment" class="internalDFN">Start alignment</a> </td><td> "<code title="">start</code>"
</td></tr><tr> <td><a title="text track cue middle alignment" href="#dfn-text-track-cue-middle-alignment" class="internalDFN">Middle alignment</a> </td><td> "<code title="">middle</code>"
@@ -4995,12 +4999,12 @@
for the new value, if any. If none of the values match, then the user agent must instead throw a
<code>SyntaxError</code> exception.</p>
- <p>The <dfn title="dom-TextTrackCue-text" id="dfn-dom-texttrackcue-text"><code>text</code></dfn> attribute, on getting, must
+ <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>TextTrackCue</code> 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-TextTrackCue-getCueAsHTML" id="dfn-dom-texttrackcue-getcueashtml"><code>getCueAsHTML()</code></dfn> method must
+ <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
<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
@@ -5060,31 +5064,8 @@
</section><!-- TextTrack interface -->
- <section id="extension-of-the-texttrackcue-interface-for-region-support">
- <h3><span class="secno">7.3 </span>Extension of the TextTrackCue interface for region support</h3>
-
- <p>The following attribute is introduced into the <a href="#dfn-texttrackcue" class="internalDFN">TextTrackCue</a> object:</p>
-
- <pre class="idl_whatwg">interface <a href="#dfn-texttrackcue" class="internalDFN">TextTrackCue</a> : EventTarget {
- attribute DOMString <a title="dom-TextTrackCue-regionId" href="#dfn-dom-texttrackcue-regionid" class="internalDFN">regionId</a>;
-};</pre>
-
- <dl class="domintro">
-
- <dt><var title="">cue</var> . <a title="dom-TextTrackCue-regionId" href="#dfn-dom-texttrackcue-regionid" class="internalDFN">regionId</a></dt>
- <dd>
- <p>Returns the <a href="#dfn-text-track-cue-region-identifier" class="internalDFN">text track cue region identifier</a>.</p>
- </dd>
- </dl>
-
- <p>Initialise <a title="dom-TextTrackCue-regionId" href="#dfn-dom-texttrackcue-regionid" class="internalDFN">regionId</a> in the <var>TextTrackCue</var> constructor with the empty string.</p>
-
- <p>The <dfn title="dom-TextTrackCue-regionId" id="dfn-dom-texttrackcue-regionid">regionId</dfn> attribute, on getting, must return the <a href="#dfn-text-track-cue-region-identifier" class="internalDFN">text track cue region identifier</a> of the text track cue that the <a href="#dfn-texttrackcue" class="internalDFN">TextTrackCue</a> object represents. On setting, the text track region identifier must be set to the new value.</p>
-
- </section><!-- end TextTrackCue object extension -->
-
<section id="texttrackregion-interface">
- <h3><span class="secno">7.4 </span>TextTrackRegion interface</h3>
+ <h3><span class="secno">7.3 </span>TextTrackRegion interface</h3>
<p>The following interface is used to expose WebVTT regions in the DOM API:</p>
@@ -5218,7 +5199,7 @@
</section><!-- end TextTrackRegion object -->
<section id="texttrackregionlist-interface">
- <h3><span class="secno">7.5 </span>TextTrackRegionList interface</h3>
+ <h3><span class="secno">7.4 </span>TextTrackRegionList interface</h3>
<pre class="idl_whatwg">interface <dfn id="dfn-texttrackregionlist">TextTrackRegionList</dfn> : EventTarget {
readonly attribute unsigned long <a title="dom-TextTrackRegionList-length" href="#dfn-dom-texttrackregionlist-length" class="internalDFN">length</a>;
@@ -5406,6 +5387,25 @@
<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 text track file format.</p>
<p>Thanks to the many contributors to the HTML standard, where WebVTT was originally specified. <a href="#refsHTML">[HTML]</a>, <a href="#refsHTML5">[HTML5]</a></p>
+
+ <p>Thanks to the following active contributors to this spec:
+ Victor Carbune,
+ Eric Carlson,
+ Anna Cavender,
+ Cyril Concolato,
+ John Foliot,
+ Lawrence Forooghian,
+ Ralph Giles,
+ Loretta Guarino Reid,
+ Philip Jägenstedt,
+ Anne van Kesteren,
+ Glenn Maynard,
+ Ronny Mennerich,
+ Frank Olivier,
+ Giuseppe Pascale,
+ Simon Pieters,
+ David Singer.
+ </p>
</section>
Received on Monday, 8 July 2013 02:26:23 UTC