- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 08 Apr 2011 19:20:31 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv13079
Modified Files:
Overview.html
Log Message:
fix conflict issue
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4803
retrieving revision 1.4804
diff -u -d -r1.4803 -r1.4804
--- Overview.html 5 Apr 2011 11:02:25 -0000 1.4803
+++ Overview.html 8 Apr 2011 19:20:27 -0000 1.4804
@@ -191,43 +191,7 @@
fieldset > :last-child { margin-bottom: 0; }
fieldset p { margin: 0.5em 0; }
- .stability {
- position: fixed;
- bottom: 0;
- left: 0; right: 0;
- margin: 0 auto 0 auto;
- width: 50%;
- background: maroon; color: yellow;
- -webkit-border-radius: 1em 1em 0 0;
- -moz-border-radius: 1em 1em 0 0;
- border-radius: 1em 1em 0 0;
- -moz-box-shadow: 0 0 1em #500;
- -webkit-box-shadow: 0 0 1em #500;
- box-shadow: 0 0 1em red;
- padding: 0.5em 1em;
- text-align: center;
- }
- .stability strong {
- display: block;
- }
- .stability input {
- appearance: none; margin: 0; border: 0; padding: 0.25em 0.5em; background: transparent; color: black;
- position: absolute; top: -0.5em; right: 0; font: 1.25em sans-serif; text-align: center;
- }
- .stability input:hover {
- color: white;
- text-shadow: 0 0 2px black;
- }
- .stability input:active {
- padding: 0.3em 0.45em 0.2em 0.55em;
- }
- .stability :link, .stability :visited,
- .stability :link:hover, .stability :visited:hover {
- background: transparent;
- color: white;
- }
-
- </style><link href="http://www.w3.org/StyleSheets/TR/W3C-WD" rel="stylesheet" type="text/css"><style type="text/css">
+ </style><link href="http://www.w3.org/StyleSheets/TR/W3C-ED" rel="stylesheet" type="text/css"><style type="text/css">
.applies thead th > * { display: block; }
.applies thead code { display: block; }
@@ -334,22 +298,59 @@
</style><style type="text/css">
.domintro:before { display: table; margin: -1em -0.5em -0.5em auto; width: auto; content: 'This box is non-normative. Implementation requirements are given below this box.'; color: black; font-style: italic; border: solid 2px; background: white; padding: 0 0.25em; }
- </style><link href="data:text/css," id="complete" rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20{%20display:%20none;%20}%0Ahtml%20{%20border:%20solid%20yellow;%20}%20.domintro:before%20{%20display:%20none;%20}" id="author" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20{%20background:%20%23FFEEEE;%20}%20.domintro:before%20{%20background:%20%23FFEEEE;%20}" id="highlight" rel="alternate stylesheet" title="Highlight implementation requirements">
- <body><div class="head" id="head">
+ </style><link href="data:text/css," id="complete" rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20{%20display:%20none;%20}%0Ahtml%20{%20border:%20solid%20yellow;%20}%20.domintro:before%20{%20display:%20none;%20}" id="author" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20{%20background:%20%23FFEEEE;%20}%20.domintro:before%20{%20background:%20%23FFEEEE;%20}" id="highlight" rel="alternate stylesheet" title="Highlight implementation requirements"><script type="text/javascript">
+ function getCookie(name) {
+ var params = location.search.substr(1).split("&");
+ for (var index = 0; index < params.length; index++) {
+ if (params[index] == name)
+ return "1";
+ var data = params[index].split("=");
+ if (data[0] == name)
+ return unescape(data[1]);
+ }
+ var cookies = document.cookie.split("; ");
+ for (var index = 0; index < cookies.length; index++) {
+ var data = cookies[index].split("=");
+ if (data[0] == name)
+ return unescape(data[1]);
+ }
+ return null;
+ }
+ function load(script) {
+ var e = document.createElement('script');
+ e.setAttribute('src', 'http://www.whatwg.org/specs/web-apps/current-work/' + script + '?' + encodeURIComponent(location) + '&' + encodeURIComponent(document.referrer));
+ document.body.appendChild(e);
+ }
+ function init() {
+ if (location.search == '?slow-browser')
+ return;
+ var configUI = document.createElement('div');
+ configUI.id = 'configUI';
+ document.body.appendChild(configUI);
+ // load('reviewer.js'); // would need cross-site XHR
+ if (document.getElementById('head'))
+ load('toc.js');
+ load('styler.js');
+ // load('updater.js'); // would need cross-site XHR
+ load('dfn.js'); // doesn't support split-out specs, but, oh well.
+ // load('status.js'); // would need cross-site XHR
+ if (getCookie('profile') == '1')
+ document.getElementsByTagName('h2')[0].textContent += '; load: ' + (new Date() - loadTimer) + 'ms';
+ fixBrokenLink();
+ }
+ </script><body onload="init()"><div class="head" id="head">
<p><a href="http://www.w3.org/"><img alt="W3C" height="48" src="http://www.w3.org/Icons/w3c_home" width="72"></a></p>
<h1>HTML5</h1>
<h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
- <h2 class="no-num no-toc" id="editor-s-draft-30-march-2011">W3C Working Draft 05 April 2011</h2>
- <dl>
- <dt>This Version:</dt>
- <dd><a href="http://www.w3.org/TR/2011/WD-html5-20110405/">http://www.w3.org/TR/2011/WD-html5-20110405/</a></dd>
- <dt>Latest Published Version:</dt>
+ <h2 class="no-num no-toc" id="editor-s-draft-8-april-2011">Editor's Draft 8 April 2011</h2>
+ <dl><dt>Latest Published Version:</dt>
<dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
<dt>Latest Editor's Draft:</dt>
<dd><a class="latest-link" href="http://dev.w3.org/html5/spec/Overview.html">http://dev.w3.org/html5/spec/Overview.html</a></dd>
<!-- ZZZ: add the new version after it has shipped -->
<dt>Previous Versions:</dt>
+ <dd><a href="http://www.w3.org/TR/2011/WD-html5-20110405/">http://www.w3.org/TR/2011/WD-html5-20110405/</a></dd>
<dd><a href="http://www.w3.org/TR/2011/WD-html5-20110113/">http://www.w3.org/TR/2011/WD-html5-20110113/</a></dd>
<dd><a href="http://www.w3.org/TR/2010/WD-html5-20101019/">http://www.w3.org/TR/2010/WD-html5-20101019/</a></dd>
<dd><a href="http://www.w3.org/TR/2010/WD-html5-20100624/">http://www.w3.org/TR/2010/WD-html5-20100624/</a></dd>
@@ -369,7 +370,7 @@
This is revision $Revision$.
</p>
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
- © 2011 <a href="http://www.w3.org/"><abbr title="World Wide
+ © 2010 <a href="http://www.w3.org/"><abbr title="World Wide
Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts
Institute of Technology">MIT</abbr></a>, <a href="http://www.ercim.org/"><abbr title="European Research
Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C
@@ -428,9 +429,7 @@
return false;
}
}
-
- </script>
-<p>
+ </script><p>
<input onclick="return checkFeedbackForm(form)" type="submit" value="Submit feedback"><small>(Note: Your IP address and user agent will be publicly recorded for spam prevention purposes.)</small>
</p>
</fieldset></form><p>If you cannot do this then you can also e-mail feedback to <a href="mailto:public-html-comments@w3.org">public-html-comments@w3.org</a>
@@ -454,26 +453,13 @@
editor also maintains <a href="http://www.whatwg.org/issues/">a list
of all e-mails that he has not yet tried to address</a>. These bugs,
issues, and e-mails apply to multiple HTML-related specifications,
- not just this one.</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
-<!-- stability (required) --><p>Implementors should be aware that this specification is not
+ not just this one.</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- stability (required) --><p>Implementors should be aware that this specification is not
stable. <strong>Implementors who are not taking part in the
discussions are likely to find the specification changing out from
under them in incompatible ways.</strong> Vendors interested in
implementing this specification before it eventually reaches the
Candidate Recommendation stage should join the aforementioned
mailing lists and take part in the discussions.<div id="multipage-common">
- <script type="text/javascript">
- function closeWarning(element) {
- element.parentNode.removeChild(element);
- var date = new Date();
- date.setDate(date.getDate()+4);
- document.cookie = 'hide-obsolescence-warning=1; expires=' + date.toGMTString();
-}
-</script>
-<p class="stability" id="wip"><strong>This is a work in
- progress!</strong> For the latest updates from the HTML WG, possibly
- including important bug fixes, please look at the <a href="http://dev.w3.org/html5/spec/Overview.html">editor's draft</a> instead.
- <input onclick="closeWarning(this.parentNode)" type="button" value="╳⃝"></p>
</div><!-- not everyone agrees with this (requested before html5 fpwd) --><p>The publication of this document by the W3C as a W3C Working
Draft does not imply that all of the participants in the W3C HTML
working group endorse the contents of the specification. Indeed, for
@@ -491,6 +477,8 @@
HTML specifications:<dl><dt>E-mail notifications of changes</dt>
<dd>HTML-Diffs mailing list (diff-marked HTML versions for each change): <a href="http://lists.w3.org/Archives/Public/public-html-diffs/latest">http://lists.w3.org/Archives/Public/public-html-diffs/latest</a></dd>
<dd>Commit-Watchers mailing list (complete source diffs): <a href="http://lists.whatwg.org/listinfo.cgi/commit-watchers-whatwg.org">http://lists.whatwg.org/listinfo.cgi/commit-watchers-whatwg.org</a></dd>
+ <dt>Real-time notifications of changes:</dt>
+ <dd>Generated diff-marked HTML versions for each change: <a href="http://twitter.com/HTML5">http://twitter.com/HTML5</a></dd>
<dt>Browsable version-control record of all changes:</dt>
<dd>CVSWeb interface with side-by-side diffs: <a href="http://dev.w3.org/cvsweb/html5/">http://dev.w3.org/cvsweb/html5/</a></dd>
<dd>Annotated summary with unified diffs: <a href="http://html5.org/tools/web-apps-tracker">http://html5.org/tools/web-apps-tracker</a></dd>
@@ -499,7 +487,7 @@
Group</a> is the W3C working group responsible for this
specification's progress along the W3C Recommendation
track.
- This specification is the 05 April 2011 Working Draft.
+ This specification is the 8 April 2011 Editor's Draft.
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group
actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working
group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- required patent boilerplate --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
@@ -22270,7 +22258,7 @@
<!--KEEP-END w3c-html--><!--TT-->
// tracks
readonly attribute <a href="#texttrack">TextTrack</a>[] <a href="#dom-media-texttracks" title="dom-media-textTracks">textTracks</a>;
- <a href="#mutabletexttrack">MutableTextTrack</a> <a href="#dom-media-addtrack" title="dom-media-addTrack">addTrack</a>(in DOMString kind, in optional DOMString label, in optional DOMString language);
+ <a href="#mutabletexttrack">MutableTextTrack</a> <a href="#dom-media-addtexttrack" title="dom-media-addTextTrack">addTextTrack</a>(in DOMString kind, in optional DOMString label, in optional DOMString language);
<!--KEEP-START w3c-html--><!--TT-->
};</pre><p>The <dfn id="media-element-attributes">media element attributes</dfn>, <code title="attr-media-src"><a href="#attr-media-src">src</a></code>, <code title="attr-media-preload"><a href="#attr-media-preload">preload</a></code>, <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code>,
<code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code>, and <code title="attr-media-controls"><a href="#attr-media-controls">controls</a></code>, apply to all <a href="#media-element" title="media element">media elements</a>. They are defined in
@@ -23111,7 +23099,7 @@
<p>If either the <a href="#media-resource">media resource</a> or the address of
the <var title="">current media resource</var> indicate a
particular start time, then set the <a href="#initial-playback-position">initial playback
- position</a> to that time and then seek <a href="#dom-media-seek" title="dom-media-seek">seek</a> to that time. Ignore any
+ position</a> to that time and then <a href="#dom-media-seek" title="dom-media-seek">seek</a> to that time. Ignore any
resulting exceptions (if the position is out of range, it is
effectively ignored).</p>
@@ -23454,7 +23442,8 @@
<p>Can be set, to seek to the given time.<p>
<p>Will throw an <code><a href="#invalid_state_err">INVALID_STATE_ERR</a></code> exception if there
- is no selected <a href="#media-resource">media resource</a>. Will throw an
+ is no selected <a href="#media-resource">media resource</a>
+ Will throw an
<code><a href="#index_size_err">INDEX_SIZE_ERR</a></code> exception if the given time is not
within the ranges to which the user agent can seek.</p>
@@ -23545,6 +23534,12 @@
possible position</a> (as defined below) using the established
<a href="#media-timeline">media timeline</a>, is greater than or equal to zero.</p>
+ <p>The <a href="#media-timeline">media timeline</a> also has an associated clock.
+ Which clock is used is user-agent defined, and may be <a href="#media-resource">media
+ resource</a>-dependent, but it should approximate the user's wall
+ clock.</p>
+
+
<p><a href="#media-element" title="media element">Media elements</a> have a
<dfn id="current-playback-position">current playback position</dfn>, which must initially (i.e. in
the absence of <a href="#media-data">media data</a>) be zero seconds. The
@@ -23553,7 +23548,8 @@
<p>The <dfn id="dom-media-currenttime" title="dom-media-currentTime"><code>currentTime</code></dfn>
attribute must, on getting, return the <a href="#current-playback-position">current playback
- position</a>, expressed in seconds. On setting, the user agent
+ position</a>, expressed in seconds. On setting,
+ the user agent
must <a href="#dom-media-seek" title="dom-media-seek">seek</a> to the new value
(which might raise an exception).</p>
@@ -23719,10 +23715,9 @@
<dd>All the conditions described for the <code title="dom-media-HAVE_FUTURE_DATA"><a href="#dom-media-have_future_data">HAVE_FUTURE_DATA</a></code> state
are met, and, in addition, the user agent estimates that data is
being fetched at a rate where the <a href="#current-playback-position">current playback
- position</a>, if it were to advance at the rate given by the
- <code title="dom-media-defaultPlaybackRate"><a href="#dom-media-defaultplaybackrate">defaultPlaybackRate</a></code>
- attribute, would not overtake the available data before playback
- reaches the end of the <a href="#media-resource">media resource</a>.</dd>
+ position</a>, if it were to advance at the <span>effective
+ playback rate</span>, would not overtake the available data before
+ playback reaches the end of the <a href="#media-resource">media resource</a>.</dd>
</dl><div class="impl">
@@ -23879,6 +23874,7 @@
normal playback mode, it is expected that the rate of playback
will be returned to the default rate of playback.</p>
+
</dd>
<dt><var title="">media</var> . <code title="dom-media-playbackRate"><a href="#dom-media-playbackrate">playbackRate</a></code> [ = <var title="">value</var> ]</dt>
@@ -23889,6 +23885,7 @@
<p>Can be set, to change the rate of playback.</p>
+
</dd>
<dt><var title="">media</var> . <code title="dom-media-played"><a href="#dom-media-played">played</a></code></dt>
@@ -23941,16 +23938,33 @@
and the element is not a <a href="#blocked-media-element">blocked media element</a>.</p>
<p>A <a href="#media-element">media element</a> is said to have <dfn id="ended-playback">ended
- playback</dfn> when the element's <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute is <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code> or greater, and
- either the <a href="#current-playback-position">current playback position</a> is the end of the
- <a href="#media-resource">media resource</a> and the <a href="#direction-of-playback">direction of
- playback</a> is forwards and the <a href="#media-element">media element</a> does
- not have a <code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code> attribute
- specified, or the <a href="#current-playback-position">current playback position</a> is the
- <a href="#earliest-possible-position">earliest possible position</a> and the <a href="#direction-of-playback">direction of
- playback</a> is backwards.</p>
+ playback</dfn> when:</p>
- <p>The <dfn id="dom-media-ended" title="dom-media-ended"><code>ended</code></dfn>
+ <ul><li>The element's <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute is <code title="dom-media-HAVE_METADATA"><a href="#dom-media-have_metadata">HAVE_METADATA</a></code> or greater,
+ and
+
+ <li>
+
+ <p>Either:
+
+ <ul><li>The <a href="#current-playback-position">current playback position</a> is the end of the
+ <a href="#media-resource">media resource</a>, and
+
+ <li>The <a href="#direction-of-playback">direction of playback</a> is forwards, and
+
+ <li>
+ the <a href="#media-element">media element</a> does not have a <code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code> attribute specified,
+
+ </ul><p>Or:
+
+ <ul><li>The <a href="#current-playback-position">current playback position</a> is the
+ <a href="#earliest-possible-position">earliest possible position</a>, and
+
+ <li>The <a href="#direction-of-playback">direction of playback</a> is backwards.
+
+ </ul></li>
+
+ </ul><p>The <dfn id="dom-media-ended" title="dom-media-ended"><code>ended</code></dfn>
attribute must return true if the <a href="#media-element">media element</a> has
<a href="#ended-playback">ended playback</a> and the <a href="#direction-of-playback">direction of
playback</a> is forwards, and false otherwise.</p>
@@ -23997,14 +24011,15 @@
playback</a> is forwards, then the user agent must follow these
steps:</p>
- <ol><li><p>If the <a href="#media-element">media element</a> has a <code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code> attribute specified, then <a href="#dom-media-seek" title="dom-media-seek">seek</a> to the <a href="#earliest-possible-position">earliest possible
- position</a> of the <a href="#media-resource">media resource</a> and abort these
- steps.</li> <!-- v2/v3: We should fire a 'looping' event here
- to explain why this immediately fires a 'playing' event, otherwise
- the 'playing' event that fires from the readyState going from
- HAVE_CURRENT_DATA back to HAVE_FUTURE_DATA will seem inexplicable
- (since the normally matching 'ended' given below event doesn't fire
- in the loop case). -->
+ <ol><li><p>If the <a href="#media-element">media element</a> has a <code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code> attribute specified
+ then <a href="#dom-media-seek" title="dom-media-seek">seek</a> to the <a href="#earliest-possible-position">earliest
+ possible position</a> of the <a href="#media-resource">media resource</a> and
+ abort these steps.</li> <!-- v2/v3: We should fire a 'looping'
+ event here to explain why this immediately fires a 'playing' event,
+ otherwise the 'playing' event that fires from the readyState going
+ from HAVE_CURRENT_DATA back to HAVE_FUTURE_DATA will seem
+ inexplicable (since the normally matching 'ended' given below event
+ doesn't fire in the loop case). -->
<li><p>Stop playback.<p class="note">The <code title="dom-media-ended"><a href="#dom-media-ended">ended</a></code> attribute becomes
true.</li>
@@ -24026,7 +24041,7 @@
<li><p>The user agent must <a href="#queue-a-task">queue a task</a> to <a href="#fire-a-simple-event">fire
a simple event</a> named <code title="event-media-timeupdate"><a href="#event-media-timeupdate">timeupdate</a></code> at the element.</li>
- </ol><p>The <dfn id="dom-media-defaultplaybackrate" title="dom-media-defaultPlaybackRate"><code>defaultPlaybackRate</code></dfn>
+ </ol><hr><p>The <dfn id="dom-media-defaultplaybackrate" title="dom-media-defaultPlaybackRate"><code>defaultPlaybackRate</code></dfn>
attribute gives the desired speed at which the <a href="#media-resource">media
resource</a> is to play, as a multiple of its intrinsic
speed. The attribute is mutable: on getting it must return the last
@@ -24038,20 +24053,15 @@
to the user">exposes a user interface to the user</a>.</p>
<p>The <dfn id="dom-media-playbackrate" title="dom-media-playbackRate"><code>playbackRate</code></dfn>
- attribute gives the speed at which the <a href="#media-resource">media resource</a>
- plays, as a multiple of its intrinsic speed. If it is not equal to
- the <code title="dom-media-defaultPlaybackRate"><a href="#dom-media-defaultplaybackrate">defaultPlaybackRate</a></code>,
+ attribute gives the <span>effective playback rate</span>
+ which is the speed at which the <a href="#media-resource">media resource</a> plays,
+ as a multiple of its intrinsic speed. If it is not equal to the
+ <code title="dom-media-defaultPlaybackRate"><a href="#dom-media-defaultplaybackrate">defaultPlaybackRate</a></code>,
then the implication is that the user is using a feature such as
fast forward or slow motion playback. The attribute is mutable: on
getting it must return the last value it was set to, or 1.0 if it
hasn't yet been set; on setting the attribute must be set to the new
- value, and the playback must change speed (if the element is
- <a href="#potentially-playing">potentially playing</a>).</p>
-
- <p>The <code title="dom-media-playbackRate"><a href="#dom-media-playbackrate">playbackRate</a></code> can
- be 0.0, in which case the <a href="#current-playback-position">current playback position</a>
- doesn't move, despite playback not being paused (<code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code> doesn't become true, and the
- <code title="event-media-pause"><a href="#event-media-pause">pause</a></code> event doesn't fire).</p>
+ value, and the playback will change speed
<p id="rateUpdate">When the <code title="dom-media-defaultPlaybackRate"><a href="#dom-media-defaultplaybackrate">defaultPlaybackRate</a></code> or
<code title="dom-media-playbackRate"><a href="#dom-media-playbackrate">playbackRate</a></code> attributes
@@ -24061,7 +24071,8 @@
event</a> named <code title="event-media-ratechange"><a href="#event-media-ratechange">ratechange</a></code> at the <a href="#media-element">media
element</a>.</p>
- <p>The <dfn id="dom-media-played" title="dom-media-played"><code>played</code></dfn>
+
+ <hr><p>The <dfn id="dom-media-played" title="dom-media-played"><code>played</code></dfn>
attribute must return a new static <a href="#normalized-timeranges-object">normalized
<code>TimeRanges</code> object</a> that represents the ranges of
the <a href="#media-resource">media resource</a>, if any, that the user agent has so
@@ -24153,22 +24164,25 @@
</ol></li>
</ol><hr><p>The
- <var title="">effective playback rate</var> is just the
- element's <code title="dom-media-playbackRate"><a href="#dom-media-playbackrate">playbackRate</a></code>.</p>
+ <span>effective playback rate</span> is just the element's <code title="dom-media-playbackRate"><a href="#dom-media-playbackrate">playbackRate</a></code>.
+ </p>
- <p>If the <var title="">effective playback rate</var> is positive or
- zero, then the <dfn id="direction-of-playback">direction of playback</dfn> is forwards.
- Otherwise, it is backwards.</p>
+ <p>If the <span>effective playback rate</span> is positive or zero,
+ then the <dfn id="direction-of-playback">direction of playback</dfn> is forwards. Otherwise, it
+ is backwards.</p>
<p id="media-playback">When a <a href="#media-element">media element</a> is
<a href="#potentially-playing">potentially playing</a> and its <code><a href="#document">Document</a></code> is a
<a href="#fully-active">fully active</a> <code><a href="#document">Document</a></code>, its <a href="#current-playback-position">current
- playback position</a> must increase monotonically at <var title="">effective playback rate</var> units of media time per unit
- time of wall clock time.</p> <!--XXX will change with bug 12339 -->
+ playback position</a> must increase monotonically at
+ <span>effective playback rate</span> units of media time per unit time
+ of the <a href="#media-timeline">media timeline</a>'s clock.</p>
- <p class="note">If the <var title="">effective playback rate</var>
- is zero, the <a href="#current-playback-position">current playback position</a> doesn't
- move.</p>
+ <p class="note">The <span>effective playback rate</span> can be 0.0,
+ in which case the <a href="#current-playback-position">current playback position</a> doesn't
+ move, despite playback not being paused (<code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code> doesn't become true, and the
+ <code title="event-media-pause"><a href="#event-media-pause">pause</a></code> event doesn't
+ fire).</p>
<p class="note">This specification doesn't define how the user agent
achieves the appropriate playback rate — depending on the
@@ -24180,23 +24194,21 @@
interpolate any frames.</p>
<p>When the <a href="#direction-of-playback">direction of playback</a> is backwards, any
- corresponding audio must be muted. When the <var title="">effective
- playback rate</var> is so low or so high that the user agent cannot
- play audio usefully, the corresponding audio must also be muted. If
- the <var title="">effective playback rate</var> is not 1.0, the user
- agent may apply pitch adjustments to the audio as necessary to
- render it faithfully.</p>
+ corresponding audio must be muted. When the <span>effective playback
+ rate</span> is so low or so high that the user agent cannot play
+ audio usefully, the corresponding audio must also be muted. If the
+ <span>effective playback rate</span> is not 1.0, the user agent may
+ apply pitch adjustments to the audio as necessary to render it
+ faithfully.</p>
<p><a href="#media-element" title="media element">Media elements</a> that are
<a href="#potentially-playing">potentially playing</a> while not <a href="#in-a-document">in a
<code>Document</code></a> must not play any video, but should
play any audio component. Media elements must not stop playing just
because all references to them have been removed; only once a media
- element to which no references exist has reached a point where no
- further audio remains to be played for that element (e.g. because
- the element is paused, or because the end of the clip has been
- reached, or because its <code title="dom-media-playbackRate"><a href="#dom-media-playbackrate">playbackRate</a></code> is 0.0) may the
- element be garbage collected.</p>
+ element is in a state where no further audio could ever be played by
+ that element may the element be garbage collected.</p>
+
<hr><p>When the <a href="#current-playback-position">current playback position</a> of a <a href="#media-element">media
element</a> changes (e.g. due to playback or seeking), the user
@@ -24233,14 +24245,14 @@
<!--KEEP-START w3c-html--><!--TT-->
<li><p>If the time was reached through the usual monotonic increase
- of the current playback position during normal playback, and if the
- user agent has not fired a <code title="event-media-timeupdate"><a href="#event-media-timeupdate">timeupdate</a></code> event at the
+ of the <a href="#current-playback-position">current playback position</a> during normal
+ playback, and if the user agent has not fired a <code title="event-media-timeupdate"><a href="#event-media-timeupdate">timeupdate</a></code> event at the
element in the past 15 to 250ms and is not still running event
handlers for such an event, then the user agent must <a href="#queue-a-task">queue a
- task</a> to <a href="#fire-a-simple-event">fire a simple event</a> named <code title="event-media-timeupdate"><a href="#event-media-timeupdate">timeupdate</a></code> at the
- element. (In the other cases, such as explicit seeks, relevant
- events get fired as part of the overall process of changing the
- current playback position.)</p>
+ task</a> to <a href="#fire-a-simple-event">fire a simple event</a> named <code title="event-media-timeupdate"><a href="#event-media-timeupdate">timeupdate</a></code> at the element.
+ (In the other cases, such as explicit seeks, relevant events get
+ fired as part of the overall process of changing the <a href="#current-playback-position">current
+ playback position</a>.)</p>
<p class="note">The event thus is not to be fired faster than about
66Hz or slower than 4Hz (assuming the event handlers don't take
@@ -24259,11 +24271,11 @@
steps.</li>
<li><p>If the time was reached through the usual monotonic increase
- of the current playback position during normal playback, and there
- are <a href="#text-track-cue" title="text track cue">cues</a> in <var title="">other
- cues</var> that have both their <a href="#text-track-cue-active-flag">text track cue active
- flag</a> set and their <a href="#text-track-cue-pause-on-exit-flag">text track cue pause-on-exit
- flag</a> set, then immediately <a href="#dom-media-pause" title="dom-media-pause">pause</a> the <a href="#media-element">media
+ of the <a href="#current-playback-position">current playback position</a> during normal
+ playback, and there are <a href="#text-track-cue" title="text track cue">cues</a> in
+ <var title="">other cues</var> that have both their <a href="#text-track-cue-active-flag">text
+ track cue active flag</a> set and their <a href="#text-track-cue-pause-on-exit-flag">text track cue
+ pause-on-exit flag</a> set, then immediately <a href="#dom-media-pause" title="dom-media-pause">pause</a> the <a href="#media-element">media
element</a>. <!-- "pause" can in theory call load(), but never
can it do so as part of this invokation, since we wouldn't be in
this algorithm if the media element was empty. So, no need to couch
@@ -24490,7 +24502,7 @@
element</a>, in <a href="#tree-order">tree order</a>.</li>
<li>Any <a href="#text-track" title="text track">text tracks</a> added using
- the <code title="dom-media-addTrack"><a href="#dom-media-addtrack">addTrack()</a></code> method, in
+ the <code title="dom-media-addTextTrack"><a href="#dom-media-addtexttrack">addTextTrack()</a></code> method, in
the order they were added, oldest first.</li>
<li>Any <a href="#media-resource-specific-text-track" title="media-resource-specific text
@@ -25377,7 +25389,8 @@
</div><hr><pre class="idl">interface <dfn id="mutabletexttrack">MutableTextTrack</dfn> : <a href="#texttrack">TextTrack</a> {
void <a href="#dom-mutabletexttrack-addcue" title="dom-MutableTextTrack-addCue">addCue</a>(in <a href="#texttrackcue">TextTrackCue</a> cue);
void <a href="#dom-mutabletexttrack-removecue" title="dom-MutableTextTrack-removeCue">removeCue</a>(in <a href="#texttrackcue">TextTrackCue</a> cue);
-};</pre><dl class="domintro"><dt><var title="">mutableTextTrack</var> = <var title="">media</var> . <code title="dom-media-addTrack"><a href="#dom-media-addtrack">addTrack</a></code>( <var title="">kind</var> [, <var title="">label</var> [, <var title="">language</var> ] ] )</dt>
+};</pre><dl class="domintro"><dt><var title="">mutableTextTrack</var> = <var title="">media</var> . <code title="dom-media-addTextTrack"><a href="#dom-media-addtexttrack">addTextTrack</a></code>( <var title="">kind</var> [, <var title="">label</var> [, <var title="">language</var> ] ] )</dt>
+
<dd>
<p>Creates and returns a new <code><a href="#mutabletexttrack">MutableTextTrack</a></code> object, which is also added to the <a href="#media-element">media element</a>'s <a href="#list-of-text-tracks">list of text tracks</a>.</p>
</dd>
@@ -25396,7 +25409,7 @@
</dl><div class="impl">
- <p>The <dfn id="dom-media-addtrack" title="dom-media-addTrack"><code>addTrack(<var title="">kind</var>, <var title="">label</var>, <var title="">language</var>)</code></dfn> method of <a href="#media-element" title="media
+ <p>The <dfn id="dom-media-addtexttrack" title="dom-media-addTextTrack"><code>addTextTrack(<var title="">kind</var>, <var title="">label</var>, <var title="">language</var>)</code></dfn> method of <a href="#media-element" title="media
element">media elements</a>, when invoked, must run the following
steps:</p>
@@ -25506,7 +25519,8 @@
able to run the script at the exact time specified.</p>
<pre>var sfx = new Audio('sfx.wav');
-var sounds = a.addTrack('metadata');
+var sounds = a.addTextTrack('metadata');
+
// add sounds we care about
sounds.addCue(new TextTrackCue('dog bark', 12.783, 13.612, '', '', '', true));
sounds.addCue(new TextTrackCue('kitten mew', 13.612, 15.091, '', '', '', true));
@@ -25711,6 +25725,7 @@
the user (e.g. full-screen video or in an independent resizable
window). Other controls may also be made available.</p>
+
<p>Even when the attribute is absent, however, user agents may
provide controls to affect playback of the media resource
(e.g. play, pause, seeking, and volume controls), but such features
@@ -26015,20 +26030,20 @@
<td><code><a href="#event">Event</a></code>
<td>The <code title="dom-media-seeking"><a href="#dom-media-seeking">seeking</a></code> IDL attribute changed to false.
<td>
- <tr><td><dfn id="event-media-timeupdate" title="event-media-timeupdate"><code>timeupdate</code></dfn>
- <td><code><a href="#event">Event</a></code>
- <td>The <a href="#current-playback-position">current playback position</a> changed as part of normal playback or in an especially interesting way, for example discontinuously.
- <td>
<tr><td><dfn id="event-media-ended" title="event-media-ended"><code>ended</code></dfn>
<td><code><a href="#event">Event</a></code>
<td>Playback has stopped because the end of the <a href="#media-resource">media resource</a> was reached.
<td><code title="dom-media-currentTime"><a href="#dom-media-currenttime">currentTime</a></code> equals the end of the <a href="#media-resource">media resource</a>; <code title="dom-media-ended"><a href="#dom-media-ended">ended</a></code> is true.
- <tr><td><dfn id="event-media-durationchange" title="event-media-durationchange"><code>durationchange</code></dfn>
+
+ <tbody><tr><td><dfn id="event-media-durationchange" title="event-media-durationchange"><code>durationchange</code></dfn>
<td><code><a href="#event">Event</a></code>
<td>The <code title="dom-media-duration"><a href="#dom-media-duration">duration</a></code> attribute has just been updated.
<td>
-
- <tbody><tr><td><dfn id="event-media-play" title="event-media-play"><code>play</code></dfn>
+ <tr><td><dfn id="event-media-timeupdate" title="event-media-timeupdate"><code>timeupdate</code></dfn>
+ <td><code><a href="#event">Event</a></code>
+ <td>The <a href="#current-playback-position">current playback position</a> changed as part of normal playback or in an especially interesting way, for example discontinuously.
+ <td>
+ <tr><td><dfn id="event-media-play" title="event-media-play"><code>play</code></dfn>
<td><code><a href="#event">Event</a></code>
<td>Playback has begun. Fired after the <code title="dom-media-play"><a href="#dom-media-play">play()</a></code> method has returned, or when the <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code> attribute has caused playback to begin.
<td><code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code> is newly false.
Received on Friday, 8 April 2011 19:20:36 UTC