- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Thu, 05 Jun 2014 00:56:25 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt In directory roscoe:/tmp/cvs-serv10911 Modified Files: Overview.html Log Message: Sync WebVTT with Git commit 855420da20360326a3e3aba1879b3b19320b5d75 --- /sources/public/html5/webvtt/Overview.html 2014/06/04 22:22:10 1.139 +++ /sources/public/html5/webvtt/Overview.html 2014/06/05 00:56:25 1.140 @@ -271,7 +271,7 @@ </p> <h1 class="title p-name" id="title">WebVTT: The Web Video Text Tracks Format</h1> - <h2 id="draft-community-group-report-04-june-2014">Draft Community Group Report <time class="dt-published" datetime="2014-06-04">04 June 2014</time></h2> + <h2 id="draft-community-group-report-05-june-2014">Draft Community Group Report <time class="dt-published" datetime="2014-06-05">05 June 2014</time></h2> <dl> @@ -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 <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> +</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 <span class="formerLink"><code>VTTRegion</code></span> interface</a></li></ul></li><li class="tocline"><a ref="#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> @@ -672,6 +672,8 @@ <li><a href="http://www.w3.org/html/wg/drafts/html/master/#split-a-string-on-spaces"><dfn id="dfn-split-a-string-on-spaces">Split a string on spaces</dfn></a></li> <li><a href="http://www.w3.org/html/wg/drafts/html/master/#html-namespace"><dfn id="dfn-html-namespace">HTML namespace</dfn></a></li> <li><a href="http://www.w3.org/html/wg/drafts/html/master/#media-element"><dfn id="dfn-media-element">Media element</dfn></a></li> + <li><a href="http://www.w3.org/html/wg/drafts/html/master/#audio"><dfn id="dfn-audio"><code>audio</code></dfn> element</a></li> + <li><a href="http://www.w3.org/html/wg/drafts/html/master/#video"><dfn id="dfn-video"><code>video</code></dfn> element</a></li> <li><a href="http://www.w3.org/html/wg/drafts/html/master/#current-playback-position"><dfn id="dfn-current-playback-position">Current playback position</dfn></a></li> <li><a href="http://www.w3.org/html/wg/drafts/html/master/#expose-a-user-interface-to-the-user"><dfn id="dfn-expose-a-user-interface-to-the-user">Expose a user interface to the user</dfn></a></li> <li><a href="http://www.w3.org/html/wg/drafts/html/master/#list-of-text-tracks"><dfn id="dfn-list-of-text-tracks">List of text tracks</dfn></a></li> @@ -3924,7 +3926,7 @@ <p>The <dfn id="dfn-rules-for-updating-the-display-of-webvtt-text-tracks">rules for updating the display of WebVTT text tracks</dfn> render the <a title="text track" href="#dfn-text-track" class="internalDFN">text tracks</a> of a <a href="#dfn-media-element" class="internalDFN">media element</a> (specifically, a - <code>video</code> element), or of another playback mechanism, by + <a href="#dfn-video" class="internalDFN"><code>video</code></a> element), or of another playback mechanism, by applying the steps below. All the <a title="text track" href="#dfn-text-track" class="internalDFN">text tracks</a> that use these rules for a given <a href="#dfn-media-element" class="internalDFN">media element</a>, or other playback mechanism, are rendered together, @@ -3939,7 +3941,7 @@ <ol> - <li><p>If the <a href="#dfn-media-element" class="internalDFN">media element</a> is an <code>audio</code> + <li><p>If the <a href="#dfn-media-element" class="internalDFN">media element</a> is an <a href="#dfn-audio" class="internalDFN"><code>audio</code></a> element, or is another playback mechanism with no rendering area, abort these steps. There is nothing to render.</p></li> @@ -4103,7 +4105,7 @@ <p>User agents may allow the user to override the above algorithm's positioning of cues, e.g. by dragging them to another location on - the <code>video</code>, or even off the <code>video</code> + the <a href="#dfn-video" class="internalDFN"><code>video</code></a>, or even off the <a href="#dfn-video" class="internalDFN"><code>video</code></a> entirely.</p> <p>When the algorithm above requires that the user agent <dfn id="dfn-apply-webvtt-cue-settings">Apply WebVTT cue settings</dfn> @@ -4889,7 +4891,7 @@ <i>matched element</i>.</p> <div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_32"><span>Note</span></div><p class="">If the <i>matched element</i> is not a - <code>video</code> element, the pseudo-elements defined below won't + <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> <p>A CSS user agent that implements the <a title="text @@ -5153,24 +5155,24 @@ <pre class="idl_whatwg">enum <dfn id="dfn-autokeyword">AutoKeyword</dfn> { "auto" }; enum <dfn id="dfn-directionsetting">DirectionSetting</dfn> { "" /* horizontal */, "rl", "lr" }; enum <dfn id="dfn-alignsetting">AlignSetting</dfn> { "start", "middle", "end", "left", "right" }; -[<a title="dom-VTTCue" href="#dfn-dom-vttcue" class="internalDFN">Constructor</a>(double startTime, double endTime, DOMString text)] +[<a title="VTTCue-constructor" href="#dfn-vttcue-constructor" 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 <a href="#dfn-vttregion" class="internalDFN">VTTRegion</a>? <a title="dom-VTTCue-region" href="#dfn-dom-vttcue-region" class="internalDFN">region</a>; - attribute <a href="#dfn-directionsetting" class="internalDFN">DirectionSetting</a> <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 (double or <a href="#dfn-autokeyword" class="internalDFN">AutoKeyword</a>) <a title="dom-VTTCue-line" href="#dfn-dom-vttcue-line" class="internalDFN">line</a>; - attribute <a href="#dfn-alignsetting" class="internalDFN">AlignSetting</a> <a title="dom-VTTCue-lineAlign" href="#dfn-dom-vttcue-linealign" class="internalDFN">lineAlign</a>; - attribute double <a title="dom-VTTCue-position" href="#dfn-dom-vttcue-position" class="internalDFN">position</a>; - attribute <a href="#dfn-alignsetting" class="internalDFN">AlignSetting</a> <a title="dom-VTTCue-positionAlign" href="#dfn-dom-vttcue-positionalign" class="internalDFN">positionAlign</a>; - 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>; - <a href="#dfn-documentfragment" class="internalDFN">DocumentFragment</a> <a title="dom-VTTCue-getCueAsHTML" href="#dfn-dom-vttcue-getcueashtml" class="internalDFN">getCueAsHTML</a>(); + attribute <a href="#dfn-vttregion" class="internalDFN">VTTRegion</a>? <a title="VTTCue-region" href="#dfn-vttcue-region" class="internalDFN">region</a>; + attribute <a href="#dfn-directionsetting" class="internalDFN">DirectionSetting</a> <a title="VTTCue-vertical" href="#dfn-vttcue-vertical" class="internalDFN">vertical</a>; + attribute boolean <a title="VTTCue-snapToLines" href="#dfn-vttcue-snaptolines" class="internalDFN">snapToLines</a>; + attribute (double or <a href="#dfn-autokeyword" class="internalDFN">AutoKeyword</a>) <a title="VTTCue-line" href="#dfn-vttcue-line" class="internalDFN">line</a>; + attribute <a href="#dfn-alignsetting" class="internalDFN">AlignSetting</a> <a title="VTTCue-lineAlign" href="#dfn-vttcue-linealign" class="internalDFN">lineAlign</a>; + attribute double <a title="VTTCue-position" href="#dfn-vttcue-position" class="internalDFN">position</a>; + attribute <a href="#dfn-alignsetting" class="internalDFN">AlignSetting</a> <a title="VTTCue-positionAlign" href="#dfn-vttcue-positionalign" class="internalDFN">positionAlign</a>; + attribute double <a title="VTTCue-size" href="#dfn-vttcue-size" class="internalDFN">size</a>; + attribute <a href="#dfn-alignsetting" class="internalDFN">AlignSetting</a> <a title="VTTCue-align" href="#dfn-vttcue-align" class="internalDFN">align</a>; + attribute DOMString <a title="VTTCue-text" href="#dfn-vttcue-text" class="internalDFN">text</a>; + <a href="#dfn-documentfragment" class="internalDFN">DocumentFragment</a> <a title="VTTCue-getCueAsHTML" href="#dfn-vttcue-getcueashtml" class="internalDFN">getCueAsHTML</a>(); };</pre> <dl class="domintro"> - <dt><var>cue</var> = new <code title="dom-VTTCue">VTTCue</code>( <var>startTime</var>, <var>endTime</var>, <var>text</var> )</dt> + <dt><var>cue</var> = new <a title="VTTCue-constructor" href="#dfn-vttcue-constructor" class="internalDFN"><code>VTTCue</code></a>( <var>startTime</var>, <var>endTime</var>, <var>text</var> )</dt> <dd> <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>startTime</var> argument sets the <a href="#dfn-text-track-cue-start-time" class="internalDFN">text track cue start time</a>.</p> @@ -5178,13 +5180,13 @@ <p>The <var>text</var> argument sets the <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a>.</p> </dd> - <dt><var>cue</var> . <a title="dom-VTTCue-region" href="#dfn-dom-vttcue-region" class="internalDFN">region</a></dt> + <dt><var>cue</var> . <a title="VTTCue-region" href="#dfn-vttcue-region" class="internalDFN">region</a></dt> <dd> <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> - <dt><var>cue</var> . <a title="dom-VTTCue-vertical" href="#dfn-dom-vttcue-vertical" class="internalDFN">vertical</a> [ = <var>value</var> ]</dt> + <dt><var>cue</var> . <a title="VTTCue-vertical" href="#dfn-vttcue-vertical" class="internalDFN">vertical</a> [ = <var>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"> @@ -5198,13 +5200,13 @@ <p>Can be set.</p> </dd> - <dt><var>cue</var> . <a title="dom-VTTCue-snapToLines" href="#dfn-dom-vttcue-snaptolines" class="internalDFN">snapToLines</a> [ = <var>value</var> ]</dt> + <dt><var>cue</var> . <a title="VTTCue-snapToLines" href="#dfn-vttcue-snaptolines" class="internalDFN">snapToLines</a> [ = <var>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>cue</var> . <a title="dom-VTTCue-line" href="#dfn-dom-vttcue-line" class="internalDFN">line</a> [ = <var>value</var> ]</dt> + <dt><var>cue</var> . <a title="VTTCue-line" href="#dfn-vttcue-line" class="internalDFN">line</a> [ = <var>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 @@ -5213,7 +5215,7 @@ <p>Can be set.</p> </dd> - <dt><var>cue</var> . <a title="dom-VTTCue-lineAlign" href="#dfn-dom-vttcue-linealign" class="internalDFN">lineAlign</a> [ = <var>value</var> ]</dt> + <dt><var>cue</var> . <a title="VTTCue-lineAlign" href="#dfn-vttcue-linealign" class="internalDFN">lineAlign</a> [ = <var>value</var> ]</dt> <dd> <p>Returns a string representing the <a href="#dfn-text-track-cue-line-alignment" class="internalDFN">text track cue line alignment</a>, as follows:</p> <dl class="switch"> @@ -5227,13 +5229,13 @@ <p>Can be set.</p> </dd> - <dt><var>cue</var> . <a title="dom-VTTCue-position" href="#dfn-dom-vttcue-position" class="internalDFN">position</a> [ = <var>value</var> ]</dt> + <dt><var>cue</var> . <a title="VTTCue-position" href="#dfn-vttcue-position" class="internalDFN">position</a> [ = <var>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>cue</var> . <a title="dom-VTTCue-positionAlign" href="#dfn-dom-vttcue-positionalign" class="internalDFN">positionAlign</a> [ = <var>value</var> ]</dt> + <dt><var>cue</var> . <a title="VTTCue-positionAlign" href="#dfn-vttcue-positionalign" class="internalDFN">positionAlign</a> [ = <var>value</var> ]</dt> <dd> <p>Returns a string representing the <a href="#dfn-text-track-cue-text-position-alignment" class="internalDFN">text track cue text position alignment</a>, as follows:</p> <dl class="switch"> @@ -5247,13 +5249,13 @@ <p>Can be set.</p> </dd> - <dt><var>cue</var> . <a title="dom-VTTCue-size" href="#dfn-dom-vttcue-size" class="internalDFN">size</a> [ = <var>value</var> ]</dt> + <dt><var>cue</var> . <a title="VTTCue-size" href="#dfn-vttcue-size" class="internalDFN">size</a> [ = <var>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>cue</var> . <a title="dom-VTTCue-align" href="#dfn-dom-vttcue-align" class="internalDFN">align</a> [ = <var>value</var> ]</dt> + <dt><var>cue</var> . <a title="VTTCue-align" href="#dfn-vttcue-align" class="internalDFN">align</a> [ = <var>value</var> ]</dt> <dd> <p>Returns a string representing the <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text alignment</a>, as follows:</p> <dl class="switch"> @@ -5271,20 +5273,20 @@ <p>Can be set.</p> </dd> - <dt><var>cue</var> . <a title="dom-VTTCue-text" href="#dfn-dom-vttcue-text" class="internalDFN">text</a> [ = <var>value</var> ]</dt> + <dt><var>cue</var> . <a title="VTTCue-text" href="#dfn-vttcue-text" class="internalDFN">text</a> [ = <var>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>fragment</var> = <var>cue</var> . <a title="dom-VTTCue-getCueAsHTML" href="#dfn-dom-vttcue-getcueashtml" class="internalDFN">getCueAsHTML</a>()</dt> + <dt><var>fragment</var> = <var>cue</var> . <a title="VTTCue-getCueAsHTML" href="#dfn-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 <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> - <p>The <dfn title="dom-VTTCue" id="dfn-dom-vttcue"><code>VTTCue(<var>startTime</var>, <var>endTime</var>, + <p>The <dfn title="VTTCue-constructor" id="dfn-vttcue-constructor"><code>VTTCue(<var>startTime</var>, <var>endTime</var>, <var>text</var>)</code></dfn> constructor, when invoked, must run the following steps:</p> <ol> @@ -5337,12 +5339,12 @@ </ol> - <p>The <dfn title="dom-VTTCue-region" id="dfn-dom-vttcue-region"><code>region</code></dfn> attribute, on getting, must return + <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 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> + <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 @@ -5352,7 +5354,7 @@ <thead> <tr> <th><a href="#dfn-text-track-cue-writing-direction" class="internalDFN">Text track cue writing direction</a></th> - <th><code title="dom-VTTCue-direction">direction</code> value</th> + <th><a title="VTTCue-vertical" href="#dfn-vttcue-vertical" class="internalDFN"><code>vertical</code></a> value</th> </tr> </thead> <tbody> @@ -5375,13 +5377,13 @@ the first cell of the row in the table above whose second cell is a <a href="#dfn-case-sensitive" class="internalDFN">case-sensitive</a> match for the new value.</p> - <p>The <dfn title="dom-VTTCue-snapToLines" id="dfn-dom-vttcue-snaptolines"><code>snapToLines</code></dfn> attribute, on + <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> - <p>The <dfn title="dom-VTTCue-line" id="dfn-dom-vttcue-line"><code>line</code></dfn> attribute, on getting, must + <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 @@ -5390,7 +5392,7 @@ 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-VTTCue-lineAlign" id="dfn-dom-vttcue-linealign"><code>lineAlign</code></dfn> attribute, on getting, must + <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-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents:</p> @@ -5399,7 +5401,7 @@ <thead> <tr> <th><a href="#dfn-text-track-cue-line-alignment" class="internalDFN">Text track cue line alignment</a></th> - <th><code title="dom-VTTCue-lineAlign">lineAlign</code> value</th> + <th><a title="VTTCue-lineAlign" href="#dfn-vttcue-linealign" class="internalDFN"><code>lineAlign</code></a> value</th> </tr> </thead> <tbody> @@ -5422,13 +5424,13 @@ first cell of the row in the table above whose second cell is a <a href="#dfn-case-sensitive" class="internalDFN">case-sensitive</a> match for the new value.</p> - <p>The <dfn title="dom-VTTCue-position" id="dfn-dom-vttcue-position"><code>position</code></dfn> attribute, on getting, + <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 <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 + <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 <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a> object represents:</p> @@ -5437,7 +5439,7 @@ <thead> <tr> <th><a href="#dfn-text-track-cue-text-position-alignment" class="internalDFN">Text track cue text position alignment</a></th> - <th><code title="dom-VTTCue-positionAlign">positionAlign</code> value</th> + <th><a title="VTTCue-positionAlign" href="#dfn-vttcue-positionalign" class="internalDFN"><code>positionAlign</code></a> value</th> </tr> </thead> <tbody> @@ -5460,13 +5462,13 @@ first cell of the row in the table above whose second cell is a <a href="#dfn-case-sensitive" class="internalDFN">case-sensitive</a> match for the new value.</p> - <p>The <dfn title="dom-VTTCue-size" id="dfn-dom-vttcue-size"><code>size</code></dfn> attribute, on getting, must + <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-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 + <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 represents:</p> @@ -5475,7 +5477,7 @@ <thead> <tr> <th><a href="#dfn-text-track-cue-text-alignment" class="internalDFN">Text track cue text alignment</a></th> - <th><code title="dom-VTTCue-align">align</code> value</th> + <th><a title="VTTCue-align" href="#dfn-vttcue-align" class="internalDFN"><code>align</code></a> value</th> </tr> </thead> <tbody> @@ -5506,12 +5508,12 @@ first cell of the row in the table above whose second cell is a <a href="#dfn-case-sensitive" class="internalDFN">case-sensitive</a> match for the new value.</p> - <p>The <dfn title="dom-VTTCue-text" id="dfn-dom-vttcue-text"><code>text</code></dfn> attribute, on getting, must + <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> 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 + <p>The <dfn title="VTTCue-getCueAsHTML" id="dfn-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 <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 @@ -5520,60 +5522,60 @@ </section> <section id="the-vttregion-interface"> - <h3 aria-level="2" role="heading" id="h3_the-vttregion-interface"><span class="secno">7.2 </span>The <code>VTTRegion</code> interface</h3> + <h3 aria-level="2" role="heading" id="h3_the-vttregion-interface"><span class="secno">7.2 </span>The <a href="#dfn-vttregion" class="internalDFN"><code>VTTRegion</code></a> interface</h3> <p>The following interface is used to expose WebVTT regions in the DOM API:</p> <pre class="idl_whatwg">enum <dfn id="dfn-scrollsetting">ScrollSetting</dfn> { "" /* none */, "up" }; -[Constructor] +[<a title="VTTRegion-constructor" href="#dfn-vttregion-constructor" class="internalDFN">Constructor</a>] interface <dfn id="dfn-vttregion">VTTRegion</dfn> { - attribute double <a title="dom-VTTRegion-width" href="#dfn-dom-vttregion-width" class="internalDFN">width</a>; - attribute long <a title="dom-VTTRegion-lines" href="#dfn-dom-vttregion-lines" class="internalDFN">lines</a>; - attribute double <a title="dom-VTTRegion-regionAnchorX" href="#dfn-dom-vttregion-regionanchorx" class="internalDFN">regionAnchorX</a>; - attribute double <a title="dom-VTTRegion-regionAnchorY" href="#dfn-dom-vttregion-regionanchory" class="internalDFN">regionAnchorY</a>; - attribute double <a title="dom-VTTRegion-viewportAnchorX" href="#dfn-dom-vttregion-viewportanchorx" class="internalDFN">viewportAnchorX</a>; - attribute double <a title="dom-VTTRegion-viewportAnchorY" href="#dfn-dom-vttregion-viewportanchory" class="internalDFN">viewportAnchorY</a>; - attribute <a href="#dfn-scrollsetting" class="internalDFN">ScrollSetting</a> <a title="dom-VTTRegion-scroll" href="#dfn-dom-vttregion-scroll" class="internalDFN">scroll</a>; + attribute double <a title="VTTRegion-width" href="#dfn-vttregion-width" class="internalDFN">width</a>; + attribute long <a title="VTTRegion-lines" href="#dfn-vttregion-lines" class="internalDFN">lines</a>; + attribute double <a title="VTTRegion-regionAnchorX" href="#dfn-vttregion-regionanchorx" class="internalDFN">regionAnchorX</a>; + attribute double <a title="VTTRegion-regionAnchorY" href="#dfn-vttregion-regionanchory" class="internalDFN">regionAnchorY</a>; + attribute double <a title="VTTRegion-viewportAnchorX" href="#dfn-vttregion-viewportanchorx" class="internalDFN">viewportAnchorX</a>; + attribute double <a title="VTTRegion-viewportAnchorY" href="#dfn-vttregion-viewportanchory" class="internalDFN">viewportAnchorY</a>; + attribute <a href="#dfn-scrollsetting" class="internalDFN">ScrollSetting</a> <a title="VTTRegion-scroll" href="#dfn-vttregion-scroll" class="internalDFN">scroll</a>; };</pre> <dl class="domintro"> - <dt><var>region</var> = new <code title="dom-VTTRegion">VTTRegion</code>()</dt> + <dt><var>region</var> = new <a title="VTTRegion-constructor" href="#dfn-vttregion-constructor" class="internalDFN"><code>VTTRegion</code></a>()</dt> <dd> - <p>Returns a new <code>VTTRegion</code> object.</p> + <p>Returns a new <a href="#dfn-vttregion" class="internalDFN"><code>VTTRegion</code></a> object.</p> </dd> - <dt><var>region</var> . <a title="dom-VTTRegion-width" href="#dfn-dom-vttregion-width" class="internalDFN">width</a></dt> + <dt><var>region</var> . <a title="VTTRegion-width" href="#dfn-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 <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>region</var> . <a title="dom-VTTRegion-lines" href="#dfn-dom-vttregion-lines" class="internalDFN">lines</a></dt> + <dt><var>region</var> . <a title="VTTRegion-lines" href="#dfn-vttregion-lines" class="internalDFN">lines</a></dt> <dd> <p>Returns the text track region height as a number of lines. Can be set.</p> </dd> - <dt><var>region</var> . <a title="dom-VTTRegion-regionAnchorX" href="#dfn-dom-vttregion-regionanchorx" class="internalDFN">regionAnchorX</a></dt> + <dt><var>region</var> . <a title="VTTRegion-regionAnchorX" href="#dfn-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 <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>region</var> . <a title="dom-VTTRegion-regionAnchorX" href="#dfn-dom-vttregion-regionanchorx" class="internalDFN">regionAnchorX</a></dt> + <dt><var>region</var> . <a title="VTTRegion-regionAnchorX" href="#dfn-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 <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>region</var> . <a title="dom-VTTRegion-viewportAnchorX" href="#dfn-dom-vttregion-viewportanchorx" class="internalDFN">viewportAnchorX</a></dt> + <dt><var>region</var> . <a title="VTTRegion-viewportAnchorX" href="#dfn-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 <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>region</var> . <a title="dom-VTTRegion-viewportAnchorY" href="#dfn-dom-vttregion-viewportanchory" class="internalDFN">viewportAnchorY</a></dt> + <dt><var>region</var> . <a title="VTTRegion-viewportAnchorY" href="#dfn-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 <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>region</var> . <a title="dom-VTTRegion-scroll" href="#dfn-dom-vttregion-scroll" class="internalDFN">scroll</a></dt> + <dt><var>region</var> . <a title="VTTRegion-scroll" href="#dfn-vttregion-scroll" class="internalDFN">scroll</a></dt> <dd> [48 lines skipped]
Received on Thursday, 5 June 2014 00:56:29 UTC