- From: CVS User spfeiffe <cvsmail@w3.org>
- Date: Mon, 08 Jul 2013 06:40:27 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt In directory roscoe:/tmp/cvs-serv4346 Modified Files: Overview.html Log Message: Fix definition of WebVTT file using only nested cues. Clarify comments spec. Missed some replacements of TextTrackCue with VTTCue. Update the DOM model to provide enums for VTTCue.vertical and VTTCue.align. --- /sources/public/html5/webvtt/Overview.html 2013/07/08 02:26:21 1.67 +++ /sources/public/html5/webvtt/Overview.html 2013/07/08 06:40:27 1.68 @@ -14,7 +14,11 @@ <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> + <meta name="bug.component" content="WebVTT"> + <style> + body { + line-height: 1.35; + } pre { white-space: pre-wrap; } @@ -465,8 +469,9 @@ <p>Comments can be included in WebVTT files.</p> - <p>Comments are just blocks that start with the word "<code title="">NOTE</code>" (followed by a - space or newline). A comment ends at the first blank line.</p> + <p>Comments are just blocks that are preceded by a blank line, + start with the word "<code title="">NOTE</code>" (followed by a + space or newline), and end at the first blank line.</p> <div class="example"> @@ -619,44 +624,44 @@ HTML standard. <a href="#refsHTML5">[HTML5]</a></p> <ul class="brief"> - <li><dfn id="dfn-html-elements">HTML elements</dfn> - </li><li><dfn id="dfn-script-s-document">Script's document</dfn> - </li><li><dfn id="dfn-entry-script">Entry script</dfn> - </li><li><dfn id="dfn-mime-type">MIME type</dfn> - </li><li><dfn id="dfn-utf-8-decode">UTF-8 decode</dfn> - </li><li><dfn id="dfn-case-sensitive">Case-sensitive</dfn> - </li><li><dfn id="dfn-collect-a-sequence-of-characters">Collect a sequence of characters</dfn> - </li><li><dfn id="dfn-ascii-digits">ASCII digits</dfn> - </li><li><dfn id="dfn-alphanumeric-ascii-characters">Alphanumeric ASCII characters</dfn> - </li><li><dfn id="dfn-space-character">Space character</dfn> - </li><li><dfn id="dfn-skip-whitespace">Skip whitespace</dfn> - </li><li><dfn id="dfn-supported-property-indices">Supported property indices</dfn> - </li><li><dfn id="dfn-determine-the-value-of-an-indexed-property">Determine the value of an indexed property</dfn> - </li><li><dfn id="dfn-split-a-string-on-spaces">Split a string on spaces</dfn> - </li><li><dfn id="dfn-html-namespace">HTML namespace</dfn> - </li><li><dfn id="dfn-media-element">Media element</dfn> - </li><li><dfn id="dfn-current-playback-position">Current playback position</dfn> - </li><li><dfn id="dfn-expose-a-user-interface-to-the-user">Expose a user interface to the user</dfn> - </li><li><dfn id="dfn-list-of-text-tracks">List of text tracks</dfn> - </li><li><dfn id="dfn-text-track">Text track</dfn> - </li><li><dfn id="dfn-text-track-kind">Text track kind</dfn> - </li><li><dfn id="dfn-text-track-mode">Text track mode</dfn> - </li><li><dfn id="dfn-text-track-disabled">Text track disabled</dfn> - </li><li><dfn id="dfn-text-track-showing">Text track showing</dfn> - </li><li><dfn id="dfn-text-track-cue">Text track cue</dfn> - </li><li><dfn id="dfn-text-track-list-of-cues">Text track list of cues</dfn> - </li><li><dfn id="dfn-text-track-cue-order">Text track cue order</dfn> - </li><li><dfn id="dfn-text-track-cue-identifier">Text track cue identifier</dfn> - </li><li><dfn id="dfn-text-track-cue-start-time">Text track cue start time</dfn> - </li><li><dfn id="dfn-text-track-cue-end-time">Text track cue end time</dfn> - </li><li><dfn id="dfn-text-track-cue-pause-on-exit-flag">Text track cue pause-on-exit flag</dfn> - </li><li><dfn id="dfn-text-track-cue-text">Text track cue text</dfn> - </li><li><dfn id="dfn-text-track-cue-active-flag">Text track cue active flag</dfn> - </li><li><dfn id="dfn-text-track-cue-display-state">Text track cue display state</dfn> - </li><li><dfn id="dfn-rules-for-updating-the-text-track-rendering">Rules for updating the text track rendering</dfn> - </li><li><dfn id="dfn-rules-for-rendering-the-cue-in-isolation">Rules for rendering the cue in isolation</dfn> - </li><li><dfn id="dfn-texttrackcue"><code>TextTrackCue</code></dfn> interface - </li><li><dfn id="dfn-texttrack"><code>TextTrack</code></dfn> interface + <li><a href="http://www.w3.org/TR/html51/single-page.html#html-elements"><dfn id="dfn-html-elements">HTML elements</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#script's-document"><dfn id="dfn-script-s-document">Script's document</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#entry-script"><dfn id="dfn-entry-script">Entry script</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#mime-type"><dfn id="dfn-mime-type">MIME type</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#utf-8-decode"><dfn id="dfn-utf-8-decode">UTF-8 decode</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#case-sensitive"><dfn id="dfn-case-sensitive">Case-sensitive</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#collect-a-sequence-of-characters"><dfn id="dfn-collect-a-sequence-of-characters">Collect a sequence of characters</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#ascii-digits"><dfn id="dfn-ascii-digits">ASCII digits</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#alphanumeric-ascii-characters"><dfn id="dfn-alphanumeric-ascii-characters">Alphanumeric ASCII characters</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#space-character"><dfn id="dfn-space-character">Space character</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#skip-whitespace"><dfn id="dfn-skip-whitespace">Skip whitespace</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#supported-property-indices"><dfn id="dfn-supported-property-indices">Supported property indices</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#determine-the-value-of-an-indexed-property"><dfn id="dfn-determine-the-value-of-an-indexed-property">Determine the value of an indexed property</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#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/TR/html51/single-page.html#html-namespace"><dfn id="dfn-html-namespace">HTML namespace</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#media-element"><dfn id="dfn-media-element">Media element</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#current-playback-position"><dfn id="dfn-current-playback-position">Current playback position</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#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/TR/html51/single-page.html#list-of-text-tracks"><dfn id="dfn-list-of-text-tracks">List of text tracks</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track"><dfn id="dfn-text-track">Text track</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-kind"><dfn id="dfn-text-track-kind">Text track kind</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-mode"><dfn id="dfn-text-track-mode">Text track mode</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-disabled"><dfn id="dfn-text-track-disabled">Text track disabled</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-showing"><dfn id="dfn-text-track-showing">Text track showing</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-cue"><dfn id="dfn-text-track-cue">Text track cue</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-list-of-cues"><dfn id="dfn-text-track-list-of-cues">Text track list of cues</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-cue-order"><dfn id="dfn-text-track-cue-order">Text track cue order</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-cue-identifier"><dfn id="dfn-text-track-cue-identifier">Text track cue identifier</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-cue-start-time"><dfn id="dfn-text-track-cue-start-time">Text track cue start time</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-cue-end-time"><dfn id="dfn-text-track-cue-end-time">Text track cue end time</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-cue-pause-on-exit-flag"><dfn id="dfn-text-track-cue-pause-on-exit-flag">Text track cue pause-on-exit flag</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-cue-text"><dfn id="dfn-text-track-cue-text">Text track cue text</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-cue-active-flag"><dfn id="dfn-text-track-cue-active-flag">Text track cue active flag</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#text-track-cue-display-state"><dfn id="dfn-text-track-cue-display-state">Text track cue display state</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#rules-for-updating-the-text-track-rendering"><dfn id="dfn-rules-for-updating-the-text-track-rendering">Rules for updating the text track rendering</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#rules-for-rendering-the-cue-in-isolation"><dfn id="dfn-rules-for-rendering-the-cue-in-isolation">Rules for rendering the cue in isolation</dfn></a> + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#texttrackcue"><dfn id="dfn-texttrackcue"><code>TextTrackCue</code></dfn></a> interface + </li><li><a href="http://www.w3.org/TR/html51/single-page.html#texttrack"><dfn id="dfn-texttrack"><code>TextTrack</code></dfn></a> interface </li></ul> </section> </section> @@ -1114,7 +1119,7 @@ the given order:</p> <ol> - <li>The string "<code title="">NOTE</code>".</li> + <li>The <a href="#dfn-case-sensitive" class="internalDFN">case-sensitive</a> string "<code title="">NOTE</code>".</li> <li>Optionally, the following components, in the given order: <ol> <li>Either: @@ -1677,10 +1682,18 @@ <section id="webvtt-file-using-only-nested-cues"> <h4><span class="secno">4.5.1 </span>WebVTT file using only nested cues</h4> - <p>A <a href="#dfn-webvtt-file" class="internalDFN">WebVTT file</a> whose cues all have an end time offset - <var title="">x</var> greater than or equal to the end time offsets - of all the cues whose start time offsets are less than <var title="">x</var> is said to be a <dfn id="dfn-webvtt-file-using-only-nested-cues">WebVTT file using only nested - cues</dfn>.</p> + <p>A <a href="#dfn-webvtt-file" class="internalDFN">WebVTT file</a> whose cues all follow the following rules + is said to be a <dfn id="dfn-webvtt-file-using-only-nested-cues">WebVTT file using only nested cues</dfn>:</p> + + <p>given any two cues <var title="">cue1</var> and <var title="">cue2</var> with start and end time + offsets <var title="">(x1, y1)</var> and <var title="">(x2, y2)</var> respectively,</p> + + <ul> + <li>either <var title="">cue1</var> lies fully within <var title""="">cue2</var>, i.e. + <var title="">x1 >= x2</var> and <var title="">y1 <= y2</var></li> + <li>or <var title="">cue1</var> fully contains <var title""="">cue2</var>, i.e. + <var title="">x1 <= x2</var> and <var title="">y1 >= y2</var></li> + </ul> <div class="example"> @@ -3457,7 +3470,7 @@ <td><a href="#dfn-webvtt-voice-object" class="internalDFN">WebVTT Voice Object</a> </td><td><code>HTMLElement</code> element node with <code title="dom-Node-localName">localName</code> "<code>span</code>", and a <code title="attr-title">title</code> attribute set to the <a href="#dfn-webvtt-voice-object" class="internalDFN">WebVTT Voice Object</a>'s value. </td></tr><tr> - <td><a href="#dfn-webvtt-class-object" class="internalDFN">WebVTT Class Object</a> + <td><a href="#dfn-webvtt-language-object" class="internalDFN">WebVTT Language Object</a> </td><td><code>HTMLElement</code> element node with <code title="dom-Node-localName">localName</code> "<code>span</code>", and a <code title="attr-lang">lang</code> attribute set to the <a href="#dfn-webvtt-language-object" class="internalDFN">WebVTT Language Object</a>'s <a title="WebVTT Node Object's applicable language" href="#dfn-webvtt-node-object-s-applicable-language" class="internalDFN">applicable language</a>. </td></tr><tr> <td><a href="#dfn-webvtt-text-object" class="internalDFN">WebVTT Text Object</a> @@ -3720,14 +3733,6 @@ <li><p>If the <a href="#dfn-text-track-cue-size" class="internalDFN">text track cue size</a> is less than <var title="">maximum size</var>, then let <var title="">size</var> be <a href="#dfn-text-track-cue-size" class="internalDFN">text track cue size</a>. Otherwise, let <var title="">size</var> be <var title="">maximum size</var>.</p></li> - <li><p>If the <a href="#dfn-text-track-cue-writing-direction" class="internalDFN">text track cue writing direction</a> is - <a title="text track cue horizontal writing - direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a>, then let <var title="">width</var> - be '<var title="">size</var> vw' and <var title="">height</var> be 'auto'. Otherwise, let <var title="">width</var> be 'auto' and <var title="">height</var> be - '<var title="">size</var> vh'. (These are CSS values used - by the next section to set CSS properties for the rendering; 'vw' - and 'vh' are CSS units.) <a href="#refsCSSVALUES">[CSSVALUES]</a></p></li> - <li> <p>Determine the value of <var title="">x-position</var> or <var title="">y-position</var> for <var title="">cue</var> as per the @@ -3934,6 +3939,14 @@ </li> + <li><p>If the <a href="#dfn-text-track-cue-writing-direction" class="internalDFN">text track cue writing direction</a> is + <a title="text track cue horizontal writing + direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a>, then let <var title="">width</var> + be '<var title="">size</var> vw' and <var title="">height</var> be 'auto'. Otherwise, let <var title="">width</var> be 'auto' and <var title="">height</var> be + '<var title="">size</var> vh'. (These are CSS values used + by the next section to set CSS properties for the rendering; 'vw' + and 'vh' are CSS units.) <a href="#refsCSSVALUES">[CSSVALUES]</a></p></li> + <li><p>Let <var title="">left</var> be '<var title="">x-position</var> vw' and <var title="">top</var> be '<var title="">y-position</var> vh'. (These again are CSS values used by the next section to set CSS properties for the @@ -4751,7 +4764,7 @@ <p>The <a title="pseudo-cue" href="#dfn-pseudo-cue" class="internalDFN">same properties that apply to '::cue'</a> apply to the '::cue-region' pseudo-element with no argument; other properties set on the pseudo-element must be ignored.</p> - <p>When a user agent is rendering one or more text track regions according to the WebVTT cue text rendering rules, <a title="WebVTT region object" href="#dfn-webvtt-region-object" class="internalDFN">WebVTT region objects</a> used in the rendering can be matched by the above pseudo-element. User agents that support the pseudo-element must dynamically update renderings accordingly. When either 'white-space' or one of the properties corresponding to the 'font' shorthand (including 'line-height') changes value, then the text track cue display state of all the text track cues in the region must be emptied and the text track's rules for updating the text track rendering must be immediately rerun.</p> + <p>When a user agent is rendering one or more text track regions according to the <a href="#dfn-rules-for-updating-the-display-of-webvtt-text-tracks" class="internalDFN">rules for updating the display of WebVTT text tracks</a>, <a title="WebVTT region object" href="#dfn-webvtt-region-object" class="internalDFN">WebVTT region objects</a> used in the rendering can be matched by the above pseudo-element. User agents that support the pseudo-element must dynamically update renderings accordingly. When either 'white-space' or one of the properties corresponding to the 'font' shorthand (including 'line-height') changes value, then the text track cue display state of all the text track cues in the region must be emptied and the text track's rules for updating the text track rendering must be immediately rerun.</p> <p>A CSS user agent that implements the text tracks model must implement the '::cue-region' pseudo-element.</p> @@ -4772,15 +4785,17 @@ <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" }; +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)] 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 DOMString <a title="dom-VTTCue-regionId" href="#dfn-dom-vttcue-regionid" class="internalDFN">regionId</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 (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 <a href="#dfn-alignsetting" class="internalDFN">AlignSetting</a> <a title="dom-VTTCue-align" href="#dfn-dom-vttcue-align" class="internalDFN">align</a>; attribute DOMString <a title="dom-VTTCue-text" href="#dfn-dom-vttcue-text" class="internalDFN">text</a>; DocumentFragment <a title="dom-VTTCue-getCueAsHTML" href="#dfn-dom-vttcue-getcueashtml" class="internalDFN">getCueAsHTML</a>(); };</pre> @@ -4789,15 +4804,15 @@ <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>Returns a new <code>VTTCue</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> <p>The <var title="">endTime</var> argument sets the <a href="#dfn-text-track-cue-end-time" class="internalDFN">text track cue end time</a>.</p> <p>The <var title="">text</var> argument sets the <a href="#dfn-text-track-cue-text" class="internalDFN">text track cue text</a>.</p> </dd> - <dt><var title="">cue</var> . <a title="dom-VTTCue-regionId">regionId</a></dt> + <dt><var title="">cue</var> . <a title="dom-VTTCue-regionId" href="#dfn-dom-vttcue-regionid" class="internalDFN">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>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-vttcue" class="internalDFN">VTTCue</a> object belongs to. If the <a href="#dfn-vttcue" class="internalDFN">VTTCue</a> doesn't belong to a text track region, returns the empty string.</p> <p>Can be set.</p> </dd> @@ -4893,6 +4908,9 @@ <!-- default settings --> + <li><p>Let <var title="">cue</var>'s <a href="#dfn-text-track-cue-region-identifier" class="internalDFN">text track cue region identifier</a> + be the empty string.</p></li> + <li><p>Let <var title="">cue</var>'s <a href="#dfn-text-track-cue-identifier" class="internalDFN">text track cue identifier</a> be the empty string.</p></li> @@ -4923,16 +4941,22 @@ alignment</a> be <a title="text track cue middle alignment" href="#dfn-text-track-cue-middle-alignment" class="internalDFN">middle alignment</a>.</p></li> - <li><p>Return the <code>TextTrackCue</code> object representing + <li><p>Return the <code>VTTCue</code> object representing <var title="">cue</var>.</p></li> </ol> + <p>The <dfn title="dom-VTTCue-regionId" id="dfn-dom-vttcue-regionid"><code>regionId</code></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 <a href="#dfn-text-track-cue" class="internalDFN">text + track cue</a> that the <code>VTTCue</code> object represents; or the empty string otherwise. + On setting, the <a href="#dfn-text-track-cue-region-identifier" class="internalDFN">text track cue region identifier</a> must be set to the new value if that + value refers to a <a href="#dfn-webvtt-region" class="internalDFN">WebVTT region</a>, or unset otherwise.</p> + <p>The <dfn title="dom-VTTCue-vertical" id="dfn-dom-vttcue-vertical"><code>vertical</code></dfn> attribute, on getting, must return the string from the second cell of the row in the table below whose first cell is the <a href="#dfn-text-track-cue-writing-direction" class="internalDFN">text track cue writing direction</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text track - cue</a> that the <code>TextTrackCue</code> object represents:</p> + cue</a> that the <code>VTTCue</code> object represents:</p> <table> <thead> @@ -4954,13 +4978,13 @@ <p>The <dfn title="dom-VTTCue-snapToLines" id="dfn-dom-vttcue-snaptolines"><code>snapToLines</code></dfn> attribute, on getting, must return true if the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue snap-to-lines flag</a> of the <a href="#dfn-text-track-cue" class="internalDFN">text - track cue</a> that the <code>TextTrackCue</code> object represents is set; or false otherwise. + track cue</a> that the <code>VTTCue</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-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 + <code>VTTCue</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 the new value; if the new value is the string "<code title="">auto</code>", then it must be interpreted as the special value <a title="text track cue automatic line @@ -4968,20 +4992,20 @@ <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 + the <code>VTTCue</code> object represents. On setting, if the new value is negative or greater than 100, then an <code>IndexSizeError</code> exception must be thrown. Otherwise, the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> must be set to the new value.</p> <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 + <code>VTTCue</code> object represents. On setting, if the new value is negative or greater than 100, then an <code>IndexSizeError</code> exception must be thrown. Otherwise, the <a href="#dfn-text-track-cue-size" class="internalDFN">text track cue size</a> must be set to the new value.</p> <p>The <dfn title="dom-VTTCue-align" id="dfn-dom-vttcue-align"><code>align</code></dfn> attribute, on getting, must return the string from the second cell of the row in the table below whose first cell is the <a href="#dfn-text-track-cue-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> + <code>VTTCue</code> object represents:</p> <table> <thead> @@ -5001,7 +5025,7 @@ <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 + <code>VTTCue</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-VTTCue-getCueAsHTML" id="dfn-dom-vttcue-getcueashtml"><code>getCueAsHTML()</code></dfn> method must @@ -5401,6 +5425,7 @@ Anne van Kesteren, Glenn Maynard, Ronny Mennerich, + Ms2ger, Frank Olivier, Giuseppe Pascale, Simon Pieters,
Received on Monday, 8 July 2013 06:40:30 UTC