- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Wed, 15 Oct 2014 08:56:23 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory roscoe:/tmp/cvs-serv14851
Modified Files:
Overview.html
Log Message:
Sync WebVTT with Git commit e2e2d1e114ad2b4fdc28520acd9b8b04c65993b0
--- /sources/public/html5/webvtt/Overview.html 2014/10/15 08:53:31 1.177
+++ /sources/public/html5/webvtt/Overview.html 2014/10/15 08:56:23 1.178
@@ -284,6 +284,13 @@
<dd><a href="http://dev.w3.org/html5/webvtt/">http://dev.w3.org/html5/webvtt/</a></dd>
+ <dt>Test suite:</dt>
+ <dd><a href="https://github.com/w3c/web-platform-tests/tree/master/webvtt">https://github.com/w3c/web-platform-tests/tree/master/webvtt</a></dd>
+
+
+
+ <dt>Bug tracker:</dt>
+ <dd><a href="http://www.w3.org/Bugs/Public/enter_bug.cgi?product=TextTracks%20CG&component=WebVTT&short_desc=%5BWebVTT%5D%20">file a bug</a> (<a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=TextTracks%20CG&component=WebVTT&resolution=---">open bugs</a>)</dd>
@@ -295,6 +302,22 @@
<dd class="p-author h-card vcard"><a class="u-url url p-name fn" href="mailto:ian@hixie.ch">Ian Hickson</a>, <a class="p-org org h-org h-card" href="http://google.com/">Google</a> (previous editor)</dd>
+
+
+
+ <dt>Version history:</dt>
+
+
+
+ <dd>
+ <a href="https://github.com/w3c/webvtt/commits">https://github.com/w3c/webvtt/commits</a>
+ </dd>
+
+
+
+
+
+
</dl>
<p class="copyright">
@@ -309,13 +332,9 @@
</p>
<hr>
</div>
- <section id="abstract" class="introductory" property="dcterms:abstract" datatype=""><h2 aria-level="1" role="heading" id="h2_abstract">Abstract</h2>
+ <section id="abstract" class="introductory" property="dcterms:abstract" datatype=""><h2 role="heading" id="h2_abstract">Abstract</h2>
<p>This is the specification of WebVTT, the Web Video Text Tracks format.</p>
- <p>If you wish to make comments or file bugs regarding this document in a manner that is tracked
- by the W3C, please submit them via <a href="http://www.w3.org/Bugs/Public/enter_bug.cgi?product=TextTracks%20CG&component=WebVTT&short_desc=%5BWebVTT%5D%20">our
- public bug database</a>.</p>
-
<p>This specification is being developed as a Living Standard in the <a href="http://www.w3.org/community/texttracks/">Web Media Text Tracks Community Group</a>. A
snapshot version 1.0 of this specification is also being progressed through the <a href="http://www.w3.org/AudioVideo/TT/">W3C Timed Text Working Group</a> to be published as a W3C
Recommendation for reference purposes.</p>
@@ -323,7 +342,7 @@
<p>To email the Timed Text Working Group, add [webvtt] at the start of your email's subject.
Implementors that target the Living Standard should provide feedback to the Community Group.</p>
- </section><section id="sotd" class="introductory"><h2 aria-level="1" role="heading" id="h2_sotd">Status of This Document</h2>
+ </section><section id="sotd" class="introductory"><h2 role="heading" id="h2_sotd">Status of This Document</h2>
<p>
This specification was published by the <a href="http://www.w3.org/community/texttracks/">Text Tracks Community Group</a>.
It is not a W3C Standard nor is it on the W3C Standards Track.
@@ -336,12 +355,18 @@
<a href="http://www.w3.org/community/">W3C Community and Business Groups</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="#conformance-for-authors" class="tocxref"><span class="secno">2.1 </span>Conformance for authors</a></li><li class="tocline"><a href="#document-conformance" class="tocxref"><span class="secno">2.2 </span>Document cnformance</a></li><li class="tocline"><a href="#dependencies" class="tocxref"><span class="secno">2.3 </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-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"><i 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-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-tmings-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 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-ode-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="#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="formerLnk"><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 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>
+
+ <p>If you wish to make comments regarding this document, please send them to
+ <a href="mailto:public-texttracks@w3.org">public-texttracks@w3.org</a>
+ (<a href="mailto:public-texttracks-request@w3.org?subject=subscribe">subscribe</a>,
+ <a href="http://lists.w3.org/Archives/Public/public-texttracks/">archives</a>).</p>
+
+</section><section id="toc"><h2 class="introductory" 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="#conformance-for-authors" class="tocxref"><span class="secno">2.1 </span>Conformance for authors</a></li><li class="tocline"><a href="#document-conformance" class="tocxref"><span class="secno">2.2 </span>Document conformance</a><li><li class="tocline"><a href="#dependencies" class="tocxref"><span class="secno">2.3 </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-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="toclie"><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-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-webvt-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-settngs-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 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" cass="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="#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>VTTCe</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 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 aria-level="1" role="heading" id="h2_introduction"><span class="secno">1. </span>Introduction</h2>
+ <!--OddPage--><h2 role="heading" id="h2_introduction"><span class="secno">1. </span>Introduction</h2>
<p><i>This section is non-normative.</i></p>
@@ -393,7 +418,7 @@
<v Roger Bingham>You know I'm so excited my glasses are falling off here.</pre>
<section id="cues-with-multiple-lines">
- <h3 aria-level="2" role="heading" id="h3_cues-with-multiple-lines"><span class="secno">1.1 </span>Cues with multiple lines</h3>
+ <h3 role="heading" id="h3_cues-with-multiple-lines"><span class="secno">1.1 </span>Cues with multiple lines</h3>
<p><i>This section is non-normative.</i></p>
@@ -462,7 +487,7 @@
</section>
<section id="comments">
- <h3 aria-level="2" role="heading" id="h3_comments"><span class="secno">1.2 </span>Comments</h3>
+ <h3 role="heading" id="h3_comments"><span class="secno">1.2 </span>Comments</h3>
<p><i>This section is non-normative.</i></p>
@@ -518,7 +543,7 @@
</section>
<section id="other-features">
- <h3 aria-level="2" role="heading" id="h3_other-features"><span class="secno">1.3 </span>Other features</h3>
+ <h3 role="heading" id="h3_other-features"><span class="secno">1.3 </span>Other features</h3>
<p><i>This section is non-normative.</i></p>
@@ -640,10 +665,10 @@
</section>
<section id="conformance">
- <!--OddPage--><h2 aria-level="1" role="heading" id="h2_conformance"><span class="secno">2. </span>Conformance</h2>
+ <!--OddPage--><h2 role="heading" id="h2_conformance"><span class="secno">2. </span>Conformance</h2>
<section id="conformance-for-authors">
- <h3 aria-level="2" role="heading" id="h3_conformance-for-authors"><span class="secno">2.1 </span>Conformance for authors</h3>
+ <h3 role="heading" id="h3_conformance-for-authors"><span class="secno">2.1 </span>Conformance for authors</h3>
<p>The <a href="#h2_syntax">Syntax</a> section of this specification defines what consists a
valid WebVTT document. Authors need to follow the <a href="#h2_syntax">Syntax</a> specification
@@ -656,7 +681,7 @@
</section>
<section id="document-conformance">
- <h3 aria-level="2" role="heading" id="h3_document-conformance"><span class="secno">2.2 </span>Document conformance</h3>
+ <h3 role="heading" id="h3_document-conformance"><span class="secno">2.2 </span>Document conformance</h3>
<p>All diagrams, examples, and notes in this specification are non-normative, as are all
sections explicitly marked non-normative. Everything else in this specification is
@@ -678,7 +703,7 @@
</section>
<section id="dependencies">
- <h3 aria-level="2" role="heading" id="h3_dependencies"><span class="secno">2.3 </span>Dependencies</h3>
+ <h3 role="heading" id="h3_dependencies"><span class="secno">2.3 </span>Dependencies</h3>
<p>This specification relies on several other underlying specifications.</p>
@@ -798,12 +823,12 @@
</section>
<section id="data-model">
- <!--OddPage--><h2 aria-level="1" role="heading" id="h2_data-model"><span class="secno">3. </span>Data model</h2>
+ <!--OddPage--><h2 role="heading" id="h2_data-model"><span class="secno">3. </span>Data model</h2>
<!-- Add some content here about cues and serialisation format in general -->
<!-- Describe metadata, caption/subtitle, chapter & description cues -->
<section id="text-track-cues">
- <h3 aria-level="2" role="heading" id="h3_text-track-cues"><span class="secno">3.1 </span>Text track cues</h3>
+ <h3 role="heading" id="h3_text-track-cues"><span class="secno">3.1 </span>Text track cues</h3>
<p>WebVTT cues are HTML <a title="text track cue" href="#dfn-text-track-cue" class="internalDFN">text track cues</a> that additionally consist
of the following: <a href="#refsHTML5">[HTML5]</a></p>
@@ -815,11 +840,11 @@
<p>The cue box of a <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> is a box within which the text of all lines of the
cue is to be rendered.</p>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_1"><span>Note</span></div><p class="">The position of the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a> within the video
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_1"><span>Note</span></div><p class="">The position of the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a> within the video
frame's dimensions depends on the value of the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> and the
<a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a>.</p></div>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_2"><span>Note</span></div><p class="">Lines are wrapped within the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a>'s <a title="text track cue size" href="#dfn-text-track-cue-size" class="internalDFN">size</a> if lines' lengths make this necessary.</p></div>
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_2"><span>Note</span></div><p class="">Lines are wrapped within the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a>'s <a title="text track cue size" href="#dfn-text-track-cue-size" class="internalDFN">size</a> if lines' lengths make this necessary.</p></div>
</dd>
@@ -988,10 +1013,10 @@
</ol>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_3"><span>Note</span></div><p class="">Since the default value of the <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text alignment</a> is <a title="text track cue middle alignment" href="#dfn-text-track-cue-middle-alignment" class="internalDFN">middle</a>, if there is no <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_3"><span>Note</span></div><p class="">Since the default value of the <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text alignment</a> is <a title="text track cue middle alignment" href="#dfn-text-track-cue-middle-alignment" class="internalDFN">middle</a>, if there is no <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text
alignment</a> setting for a cue, the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> defaults to 50%.</p></div>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_4"><span>Note</span></div><p class="">Even for <a title="text track cue horizontal writing direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a>
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_4"><span>Note</span></div><p class="">Even for <a title="text track cue horizontal writing direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a>
cues with right-to-left <i>paragraph direction</i> text, the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue
box</a> is positioned from the left edge of the video frame. This allows defining a rendering
space template which can be filled with either left-to-right or right-to-left <i>paragraph
@@ -1053,7 +1078,7 @@
</ol>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_5"><span>Note</span></div><p class="">Since the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> always measures from the left of
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_5"><span>Note</span></div><p class="">Since the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> always measures from the left of
the video (for <a title="text track cue horizontal writing direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a> cues) or
the top (otherwise), the <a href="#dfn-text-track-cue-text-position-alignment" class="internalDFN">text track cue text position alignment</a> <a title="text track
cue text position start alignment" href="#dfn-text-track-cue-text-position-start-alignment" class="internalDFN">start value</a> varies between left and top for horizontal
@@ -1130,7 +1155,7 @@
</section>
<section id="text-track-regions">
- <h3 aria-level="2" role="heading" id="h3_text-track-regions"><span class="secno">3.2 </span>Text track regions</h3>
+ <h3 role="heading" id="h3_text-track-regions"><span class="secno">3.2 </span>Text track regions</h3>
<p>A <dfn title="text track region" id="dfn-text-track-region">text track region</dfn> represents a subpart of the video
viewport and provides a rendering area for <a title="text track cue" href="#dfn-text-track-cue" class="internalDFN">text track cues</a>.</p>
@@ -1204,10 +1229,10 @@
</section>
<section id="syntax">
- <!--OddPage--><h2 aria-level="1" role="heading" id="h2_syntax"><span class="secno">4. </span>Syntax</h2>
+ <!--OddPage--><h2 role="heading" id="h2_syntax"><span class="secno">4. </span>Syntax</h2>
<section id="webvtt-file-structure">
- <h3 aria-level="2" role="heading" id="h3_webvtt-file-structure"><span class="secno">4.1 </span>WebVTT file structure</h3>
+ <h3 role="heading" id="h3_webvtt-file-structure"><span class="secno">4.1 </span>WebVTT file structure</h3>
<p>A <dfn id="dfn-webvtt-file">WebVTT file</dfn> must consist of a <a href="#dfn-webvtt-file-body" class="internalDFN">WebVTT file body</a> encoded as UTF-8 and
labeled with the <a href="#dfn-mime-type" class="internalDFN">MIME type</a> <code>text/vtt</code>. <a href="#refsRFC3629">[RFC3629]</a></p>
@@ -1280,7 +1305,7 @@
<li>A <a href="#dfn-webvtt-line-terminator" class="internalDFN">WebVTT line terminator</a>.</li>
</ol>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_6"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> corresponds to one piece of time-aligned text or data in the
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_6"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> corresponds to one piece of time-aligned text or data in the
<a href="#dfn-webvtt-file" class="internalDFN">WebVTT file</a>, for example one subtitle. The <a href="#dfn-cue-payload" class="internalDFN">cue payload</a> is the text or data
associated with the cue.</p></div>
@@ -1293,7 +1318,7 @@
identifier" href="#dfn-webvtt-cue-identifier" class="internalDFN">WebVTT cue identifiers</a> of all <a title="WebVTT cue" href="#dfn-webvtt-cue" class="internalDFN">WebVTT cues</a> of a
<a href="#dfn-webvtt-file" class="internalDFN">WebVTT file</a>.</p>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_7"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-cue-identifier" class="internalDFN">WebVTT cue identifier</a> can be used to reference a specific cue, for
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_7"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-cue-identifier" class="internalDFN">WebVTT cue identifier</a> can be used to reference a specific cue, for
example from script or CSS.</p></div>
<p>The <dfn id="dfn-webvtt-cue-timings">WebVTT cue timings</dfn> part of a <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> consists of the following
@@ -1320,14 +1345,14 @@
</ol>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_8"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-cue-timings" class="internalDFN">WebVTT cue timings</a> give the start and end offsets of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_8"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-cue-timings" class="internalDFN">WebVTT cue timings</a> give the start and end offsets of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT
cue</a>. Different cues can overlap. Cues are always listed ordered by their start time.</p></div>
<p>A <dfn id="dfn-webvtt-timestamp">WebVTT timestamp</dfn> can be either a <a title="complete WebVTT timestamp" href="#dfn-complete-webvtt-timestamp" class="internalDFN">WebVTT
timestamp representing hours, minutes, seconds and thousandths of a second</a> or a <a title="partial WebVTT timestamp" href="#dfn-partial-webvtt-timestamp" class="internalDFN">WebVTT timestamp representing a time in seconds and fractions
of a second</a>.</p>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_9"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-timestamp" class="internalDFN">WebVTT timestamp</a> is always interpreted relative to the <a href="#dfn-current-playback-position" class="internalDFN">current
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_9"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-timestamp" class="internalDFN">WebVTT timestamp</a> is always interpreted relative to the <a href="#dfn-current-playback-position" class="internalDFN">current
playback position</a> of the media data that the WebVTT file is to be synchronized with, which
always starts at 0.</p></div>
@@ -1424,7 +1449,7 @@
</section><!-- end file structure -->
<section id="webvtt-comments">
- <h3 aria-level="2" role="heading" id="h3_webvtt-comments"><span class="secno">4.2 </span>WebVTT comments</h3>
+ <h3 role="heading" id="h3_webvtt-comments"><span class="secno">4.2 </span>WebVTT comments</h3>
<p>A <dfn id="dfn-webvtt-comment">WebVTT comment</dfn> consists of the following components, in the given order:</p>
@@ -1450,15 +1475,15 @@
<li>A <a href="#dfn-webvtt-line-terminator" class="internalDFN">WebVTT line terminator</a>.</li>
</ol>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_10"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-comment" class="internalDFN">WebVTT comment</a> is ignored by the parser.</p></div>
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_10"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-comment" class="internalDFN">WebVTT comment</a> is ignored by the parser.</p></div>
</section><!-- end comments -->
<section id="types-of-webvtt-cue-payload">
- <h3 aria-level="2" role="heading" id="h3_types-of-webvtt-cue-payload"><span class="secno">4.3 </span>Types of WebVTT cue payload</h3>
+ <h3 role="heading" id="h3_types-of-webvtt-cue-payload"><span class="secno">4.3 </span>Types of WebVTT cue payload</h3>
<section id="webvtt-metadata-text">
- <h4 aria-level="3" role="heading" id="h4_webvtt-metadata-text"><span class="secno">4.3.1 </span>WebVTT metadata text</h4>
+ <h4 role="heading" id="h4_webvtt-metadata-text"><span class="secno">4.3.1 </span>WebVTT metadata text</h4>
<p><dfn id="dfn-webvtt-metadata-text">WebVTT metadata text</dfn> consists of any sequence of zero or more characters other
than U+000A LINE FEED (LF) characters and U+000D CARRIAGE RETURN (CR) characters, each
@@ -1472,7 +1497,7 @@
</section>
<section id="webvtt-cue-text">
- <h4 aria-level="3" role="heading" id="h4_webvtt-cue-text"><span class="secno">4.3.2 </span>WebVTT cue text</h4>
+ <h4 role="heading" id="h4_webvtt-cue-text"><span class="secno">4.3.2 </span>WebVTT cue text</h4>
<p><dfn id="dfn-webvtt-cue-text">WebVTT cue text</dfn> is <a href="#dfn-cue-payload" class="internalDFN">cue payload</a> that consists of zero or more <a href="#dfn-webvtt-cue-components" class="internalDFN">WebVTT cue
components</a>, in any order, each optionally separated from the next by a <a href="#dfn-webvtt-line-terminator" class="internalDFN">WebVTT line
@@ -1678,10 +1703,10 @@
</section><!-- end cue payload types -->
<section id="webvtt-cue-settings">
- <h3 aria-level="2" role="heading" id="h3_webvtt-cue-settings"><span class="secno">4.4 </span>WebVTT cue settings</h3>
+ <h3 role="heading" id="h3_webvtt-cue-settings"><span class="secno">4.4 </span>WebVTT cue settings</h3>
<section id="webvtt-region-definition">
- <h4 aria-level="3" role="heading" id="h4_webvtt-region-definition"><span class="secno">4.4.1 </span>WebVTT region definition</h4>
+ <h4 role="heading" id="h4_webvtt-region-definition"><span class="secno">4.4.1 </span>WebVTT region definition</h4>
<p>A <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a> may contain a reference to a <a title="text track
region" href="#dfn-text-track-region" class="internalDFN">text track region</a>. To define a region, a <a href="#dfn-webvtt-region-metadata-header" class="internalDFN">WebVTT region metadata header</a> is
@@ -1712,7 +1737,7 @@
<li>A <a href="#dfn-webvtt-region-scroll-setting" class="internalDFN">WebVTT region scroll setting</a>.</li>
</ul>
- <div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_11"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-setting-list" class="internalDFN">WebVTT region setting list</a> gives configuration options regarding the
+ <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_11"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-setting-list" class="internalDFN">WebVTT region setting list</a> gives configuration options regarding the
dimensions, positioning and anchoring of the region. For example, it allows a group of cues
within a region to be anchored in the center of the region and the center of the video
viewport. In this example, when the font size grows, the region grows uniformly in all
@@ -1733,7 +1758,7 @@
identifier" href="#dfn-webvtt-region-identifier" class="internalDFN">WebVTT region identifiers</a> of all <a title="WebVTT region" href="#dfn-webvtt-region" class="internalDFN">WebVTT regions</a> of
a <a href="#dfn-webvtt-file" class="internalDFN">WebVTT file</a>.</p>
- <div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_12"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-identifier" class="internalDFN">WebVTT region identifier</a> gives a name to the region so it can be
+ <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_12"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-identifier" class="internalDFN">WebVTT region identifier</a> gives a name to the region so it can be
referenced by the cues that belong to the region.</p></div>
<p>A <dfn id="dfn-webvtt-region-width-setting">WebVTT region width setting</dfn> consists of the following components, in the order
@@ -1743,7 +1768,7 @@
<li><p>A U+003D EQUALS SIGN character (=).</p></li>
<li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li>
</ol>
- <div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_13"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-width-setting" class="internalDFN">WebVTT region width setting</a> provides a fixed width as a percentage
+ <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_13"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-width-setting" class="internalDFN">WebVTT region width setting</a> provides a fixed width as a percentage
of the video width for the region into which cues are rendered and based on which alignment is
calculated.</p></div>
@@ -1754,7 +1779,7 @@
<li><p>A U+003D EQUALS SIGN character (=).</p></li>
<li><p>One or more <a href="#dfn-ascii-digits" class="internalDFN">ASCII digits</a>.</p></li>
</ol>
- <div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_14"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-lines-setting" class="internalDFN">WebVTT region lines setting</a> provides a fixed height as a number of
+ <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_14"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-lines-setting" class="internalDFN">WebVTT region lines setting</a> provides a fixed height as a number of
lines for the region into which cues are rendered. As such, it defines the height of the
roll-up region if it is a scroll region.</p></div>
@@ -1767,7 +1792,7 @@
<li><p>A U+002C COMMA character (,).</p></li>
<li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li>
</ol>
- <div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_15"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-anchor-setting" class="internalDFN">WebVTT region anchor setting</a> provides a tuple of two percentages
+ <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_15"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-anchor-setting" class="internalDFN">WebVTT region anchor setting</a> provides a tuple of two percentages
that specify the point within the region box that is fixed in location. The first percentage
measures the x-dimension and the second percentage y-dimension from the top left corner of the
region box. If no <a href="#dfn-webvtt-region-anchor-setting" class="internalDFN">WebVTT region anchor setting</a> is given, the anchor defaults to 0%, 100%
@@ -1782,13 +1807,13 @@
<li><p>A U+002C COMMA character (,).</p></li>
<li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li>
</ol>
- <div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_16"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-viewport-anchor-setting" class="internalDFN">WebVTT region viewport anchor setting</a> provides a tuple of two
+ <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_16"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-viewport-anchor-setting" class="internalDFN">WebVTT region viewport anchor setting</a> provides a tuple of two
percentages that specify the point within the video viewport that the region anchor point is
anchored to. The first percentage measures the x-dimension and the second percentage measures
the y-dimension from the top left corner of the video viewport box. If no viewport anchor is
given, it defaults to 0%, 100% (i.e. the bottom left corner).</p></div>
- <div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_17"><span>Note</span></div><p class="">For browsers, the region maps to an absolute positioned CSS box relative to
+ <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_17"><span>Note</span></div><p class="">For browsers, the region maps to an absolute positioned CSS box relative to
the video viewport, i.e. there is a relative positioned box that represents the video viewport
relative to which the regions are absolutely positioned. Overflow is hidden.</p></div>
@@ -1799,26 +1824,26 @@
<li><p>A U+003D EQUALS SIGN character (=).</p></li>
<li><p>The string "<code>up</code>".</p></li>
</ol>
- <div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_18"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-scroll-setting" class="internalDFN">WebVTT region scroll setting</a> specifies whether cues rendered into
+ <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_18"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-scroll-setting" class="internalDFN">WebVTT region scroll setting</a> specifies whether cues rendered into
the region are allowed to move out of their initial rendering place and roll up, i.e. move
towards the top of the video viewport. If the scroll setting is omitted, cues do not move from
their rendered position.</p></div>
- <div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_19"><span>Note</span></div><p class="">Cues are added to a region one line at a time below existing cue lines. When an
+ <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_19"><span>Note</span></div><p class="">Cues are added to a region one line at a time below existing cue lines. When an
existing rendered cue line is removed, and it was above another already rendered cue line, that
cue line moves into its space, thus scrolling in the given direction. If there is not enough
space for a new cue line to be added to a region, the top-most cue line is pushed off the
visible region (thus slowly becoming invisible as it moves into overflow:hidden). This
eventually makes space for the new cue line and allows it to be added.</p></div>
- <div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_20"><span>Note</span></div><p class="">When there is no scroll direction, cue lines are added in the empty line
+ <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_20"><span>Note</span></div><p class="">When there is no scroll direction, cue lines are added in the empty line
closest to the line in the bottom of the region. If no empty line is available, the oldest line
is replaced.</p></div>
</section>
<section id="webvtt-cue-settings-1">
- <h4 aria-level="3" role="heading" id="h4_webvtt-cue-settings-1"><span class="secno">4.4.2 </span>WebVTT cue settings</h4>
+ <h4 role="heading" id="h4_webvtt-cue-settings-1"><span class="secno">4.4.2 </span>WebVTT cue settings</h4>
<p>A <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a> consists of zero or more of the following settings. Each
setting must not be included more than once per <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a>.</p>
@@ -1832,7 +1857,7 @@
<li>A <a href="#dfn-webvtt-region-cue-setting" class="internalDFN">WebVTT region cue setting</a>.</li>
</ul>
- <div class="note"><div class="note-title" aria-level="4" role="heading" id="h_note_21"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a> gives configuration options regarding the
+ <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_21"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a> gives configuration options regarding the
position and alignment of the cue box and the cue text within. For example, it allows a cue box
to be aligned to the left or positioned at the top right with the cue text within middle
[339 lines skipped]
Received on Wednesday, 15 October 2014 08:56:25 UTC