- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 25 Apr 2012 20:58:49 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec In directory hutz:/tmp/cvs-serv791 Modified Files: Overview.html Log Message: Transition this API to strings rather than numbers. (whatwg r7071) Index: Overview.html =================================================================== RCS file: /sources/public/html5/spec/Overview.html,v retrieving revision 1.5636 retrieving revision 1.5637 diff -u -d -r1.5636 -r1.5637 --- Overview.html 25 Apr 2012 20:39:44 -0000 1.5636 +++ Overview.html 25 Apr 2012 20:58:44 -0000 1.5637 @@ -31227,10 +31227,7 @@ readonly attribute DOMString <a href="#dom-texttrack-label" title="dom-TextTrack-label">label</a>; readonly attribute DOMString <a href="#dom-texttrack-language" title="dom-TextTrack-language">language</a>; - const unsigned short <a href="#dom-texttrack-disabled" title="dom-TextTrack-DISABLED">DISABLED</a> = 0; - const unsigned short <a href="#dom-texttrack-hidden" title="dom-TextTrack-HIDDEN">HIDDEN</a> = 1; - const unsigned short <a href="#dom-texttrack-showing" title="dom-TextTrack-SHOWING">SHOWING</a> = 2; - attribute unsigned short <a href="#dom-texttrack-mode" title="dom-TextTrack-mode">mode</a>; + attribute DOMString <a href="#dom-texttrack-mode" title="dom-TextTrack-mode">mode</a>; readonly attribute <a href="#texttrackcuelist">TextTrackCueList</a>? <a href="#dom-texttrack-cues" title="dom-TextTrack-cues">cues</a>; readonly attribute <a href="#texttrackcuelist">TextTrackCueList</a>? <a href="#dom-texttrack-activecues" title="dom-TextTrack-activeCues">activeCues</a>; @@ -31259,16 +31256,16 @@ <dt><var title="">textTrack</var> . <code title="dom-TextTrack-mode"><a href="#dom-texttrack-mode">mode</a></code> [ = <var title="">value</var> ]</dt> <dd> <p>Returns the <a href="#text-track-mode">text track mode</a>, represented by a - number from the following list:</p> - <dl><dt><code><a href="#texttrack">TextTrack</a></code> . <code title="dom-TextTrack-DISABLED"><a href="#dom-texttrack-disabled">DISABLED</a></code> (0)</dt> + string from the following list:</p> + <dl><dt>"<code title="dom-TextTrack-disabled"><a href="#dom-texttrack-disabled">disabled</a></code>"</dt> <dd> <p>The <a href="#text-track-disabled">text track disabled</a> mode.</p> </dd> - <dt><code><a href="#texttrack">TextTrack</a></code> . <code title="dom-TextTrack-HIDDEN"><a href="#dom-texttrack-hidden">HIDDEN</a></code> (1)</dt> + <dt>"<code title="dom-TextTrack-hidden"><a href="#dom-texttrack-hidden">hidden</a></code>"</dt> <dd> <p>The <a href="#text-track-hidden">text track hidden</a> mode.</p> </dd> - <dt><code><a href="#texttrack">TextTrack</a></code> . <code title="dom-TextTrack-SHOWING"><a href="#dom-texttrack-showing">SHOWING</a></code> (2)</dt> + <dt>"<code title="dom-TextTrack-showing"><a href="#dom-texttrack-showing">showing</a></code>"</dt> <dd> <p>The <a href="#text-track-showing">text track showing</a> and <a href="#text-track-showing-by-default" title="text track showing by default">showing by default</a> modes.</p> </dd> @@ -31320,24 +31317,23 @@ represents.</p> <p>The <dfn id="dom-texttrack-mode" title="dom-TextTrack-mode"><code>mode</code></dfn> - attribute, on getting, must return the numeric value corresponding - to the <a href="#text-track-mode">text track mode</a> of the <a href="#text-track">text track</a> - that the <code><a href="#texttrack">TextTrack</a></code> object represents, as defined by - the following list:</p> + attribute, on getting, must return the string corresponding to the + <a href="#text-track-mode">text track mode</a> of the <a href="#text-track">text track</a> that the + <code><a href="#texttrack">TextTrack</a></code> object represents, as defined by the + following list:</p> - <dl><dt><dfn id="dom-texttrack-disabled" title="dom-TextTrack-DISABLED"><code>DISABLED</code></dfn> (numeric value 0)</dt> + <dl><dt>"<dfn id="dom-texttrack-disabled" title="dom-TextTrack-disabled"><code>disabled</code></dfn>"</dt> <dd>The <a href="#text-track-disabled">text track disabled</a> mode.</dd> - <dt><dfn id="dom-texttrack-hidden" title="dom-TextTrack-HIDDEN"><code>HIDDEN</code></dfn> (numeric value 1)</dt> + <dt>"<dfn id="dom-texttrack-hidden" title="dom-TextTrack-hidden"><code>hidden</code></dfn>"</dt> <dd>The <a href="#text-track-hidden">text track hidden</a> mode.</dd> - <dt><dfn id="dom-texttrack-showing" title="dom-TextTrack-SHOWING"><code>SHOWING</code></dfn> (numeric value 2)</dt> + <dt>"<dfn id="dom-texttrack-showing" title="dom-TextTrack-showing"><code>showing</code></dfn>"</dt> <dd>The <a href="#text-track-showing">text track showing</a> and <a href="#text-track-showing-by-default" title="text track showing by default">showing by default</a> modes.</dd> - </dl><p>On setting, if the new value is not either 0, 1, or 2, the user - agent must throw an <code><a href="#invalidaccesserror">InvalidAccessError</a></code> - exception. Otherwise, if the new value isn't equal to what the - attribute would currently return, the new value must be processed as - follows:</p> + </dl><p>On setting, if the new value is not either the string "<code title="dom-TextTrack-disabled"><a href="#dom-texttrack-disabled">disabled</a></code>", "<code title="dom-TextTrack-hidden"><a href="#dom-texttrack-hidden">hidden</a></code>", "<code title="dom-TextTrack-showing"><a href="#dom-texttrack-showing">showing</a></code>", the user agent must + throw an <code><a href="#invalidaccesserror">InvalidAccessError</a></code> exception. Otherwise, if + the new value isn't equal to what the attribute would currently + return, the new value must be processed as follows:</p> - <dl class="switch"><dt>If the new value is 0</dt> + <dl class="switch"><dt>If the new value is "<code title="dom-TextTrack-disabled"><a href="#dom-texttrack-disabled">disabled</a></code>"</dt> <dd> @@ -31347,7 +31343,7 @@ </dd> - <dt>If the new value is 1</dt> + <dt>If the new value is "<code title="dom-TextTrack-hidden"><a href="#dom-texttrack-hidden">hidden</a></code>"</dt> <dd> @@ -31357,7 +31353,7 @@ </dd> - <dt>If the new value is 2</dt> + <dt>If the new value is "<code title="dom-TextTrack-showing"><a href="#dom-texttrack-showing">showing</a></code>"</dt> <dd> @@ -31365,15 +31361,15 @@ track</a> that the <code><a href="#texttrack">TextTrack</a></code> object represents to the <a href="#text-track-showing">text track showing</a> mode.</p> - <p class="note">If the mode had been <a href="#text-track-showing-by-default" title="text track - showing by default">showing by default</a>, this will change it - to <a href="#text-track-showing" title="text track showing">showing</a>, even though - the value of <code title="dom-TextTrack-mode"><a href="#dom-texttrack-mode">mode</a></code> would - appear not to change.</p> - </dd> - </dl><p>If the <a href="#text-track-mode">text track mode</a> of the <a href="#text-track">text + </dl><p class="note">If the mode is <a href="#text-track-showing-by-default" title="text track showing by + default">showing by default</a>, then there is no way to change + it to <a href="#text-track-showing" title="text track showing">showing</a> without first + changing it to <a href="#text-track-disabled" title="text track disabled">disabled</a> or + <a href="#text-track-hidden" title="text track hidden">hidden</a>.</p> + + <p>If the <a href="#text-track-mode">text track mode</a> of the <a href="#text-track">text track</a> that the <code><a href="#texttrack">TextTrack</a></code> object represents is not the <a href="#text-track-disabled">text track disabled</a> mode, then the <dfn id="dom-texttrack-cues" title="dom-TextTrack-cues"><code>cues</code></dfn> attribute must return a <a href="#live">live</a> <code><a href="#texttrackcuelist">TextTrackCueList</a></code> object that
Received on Wednesday, 25 April 2012 20:58:52 UTC