- From: poot <cvsmail@w3.org>
- Date: Mon, 22 Aug 2011 18:17:18 -0400
- To: public-html-diffs@w3.org
hixie: Make browsers fire events for all cues, even when they're
overloaded, rather that skipping events on skipped cues. (whatwg r6517)
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5216&r2=1.5217&f=h
http://html5.org/tools/web-apps-tracker?from=6516&to=6517
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5216
retrieving revision 1.5217
diff -u -d -r1.5216 -r1.5217
--- Overview.html 19 Aug 2011 19:52:01 -0000 1.5216
+++ Overview.html 22 Aug 2011 22:15:36 -0000 1.5217
@@ -321,7 +321,7 @@
<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-19-august-2011">Editor's Draft 19 August 2011</h2>
+ <h2 class="no-num no-toc" id="editor-s-draft-22-august-2011">Editor's Draft 22 August 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>
@@ -467,7 +467,7 @@
Group</a> is the W3C working group responsible for this
specification's progress along the W3C Recommendation
track.
- This specification is the 19 August 2011 Editor's Draft.
+ This specification is the 22 August 2011 Editor's Draft.
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><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 --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
@@ -24269,25 +24269,35 @@
agent rushes ahead to "catch up".)
</p>
- <ol><li><p>Let <var title="">current cues</var> be an ordered list of
- <a href="#text-track-cue" title="text track cue">cues</a>, initialized to contain
- all the <a href="#text-track-cue" title="text track cue">cues</a> of all the <a href="#text-track-hidden" title="text track hidden">hidden</a>, <a href="#text-track-showing" title="text track
+ <ol><li><p>Let <var title="">current cues</var> be a list of <a href="#text-track-cue" title="text track cue">cues</a>, initialized to contain all the
+ <a href="#text-track-cue" title="text track cue">cues</a> of all the <a href="#text-track-hidden" title="text track hidden">hidden</a>, <a href="#text-track-showing" title="text track
showing">showing</a>, or <a href="#text-track-showing-by-default" title="text track showing by
default">showing by default</a> <a href="#text-track" title="text track">text
tracks</a> of the <a href="#media-element">media element</a> (not the <a href="#text-track-disabled" title="text track disabled">disabled</a> ones) whose <a href="#text-track-cue-start-time" title="text track cue start time">start times</a> are less than
or equal to the <a href="#current-playback-position">current playback position</a> and whose
<a href="#text-track-cue-end-time" title="text track cue end time">end times</a> are greater
- than the <a href="#current-playback-position">current playback position</a>, in <a href="#text-track-cue-order">text
- track cue order</a>.</li>
+ than the <a href="#current-playback-position">current playback position</a>.</li>
- <li><p>Let <var title="">other cues</var> be an ordered list of
- <a href="#text-track-cue" title="text track cue">cues</a>, initialized to contain
- all the <a href="#text-track-cue" title="text track cue">cues</a> of <a href="#text-track-hidden" title="text track hidden">hidden</a>, <a href="#text-track-showing" title="text track
+ <li><p>Let <var title="">other cues</var> be a list of <a href="#text-track-cue" title="text track cue">cues</a>, initialized to contain all the
+ <a href="#text-track-cue" title="text track cue">cues</a> of <a href="#text-track-hidden" title="text track
+ hidden">hidden</a>, <a href="#text-track-showing" title="text track
showing">showing</a>, and <a href="#text-track-showing-by-default" title="text track showing by
default">showing by default</a> <a href="#text-track" title="text track">text
tracks</a> of the <a href="#media-element">media element</a> that are not
- present in <var title="">current cues</var>, also in <a href="#text-track-cue-order">text
- track cue order</a>.</li>
+ present in <var title="">current cues</var>.</li>
+
+ <li><p>Let <var title="">last time</var> be the <a href="#current-playback-position">current
+ playback position</a> at the time this algorithm was last run
+ for this <a href="#media-element">media element</a>, if this is not the first time
+ it has run.</li>
+
+ <li><p>If the <a href="#current-playback-position">current playback position</a> has, since the
+ last time this algorithm was run, only changed through its usual
+ monotonic increase during normal playback, then let <var title="">missed cues</var> be the list of <a href="#text-track-cue" title="text track
+ cue">cues</a> in <var title="">other cues</var> whose <a href="#text-track-cue-start-time" title="text track cue start time">start times</a> are greater
+ than or equal to <var title="">last time</var> and whose <a href="#text-track-cue-end-time" title="text track cue end time">end times</a> are less than or
+ equal to the <a href="#current-playback-position">current playback position</a>. Otherwise, let
+ <var title="">missed cues</var> be an empty list.</li>
<li><p>If the time was reached through the usual monotonic increase
of the <a href="#current-playback-position">current playback position</a> during normal
@@ -24309,51 +24319,107 @@
<li><p>If all of the <a href="#text-track-cue" title="text track cue">cues</a> in
<var title="">current cues</var> have their <a href="#text-track-cue-active-flag">text track cue
- active flag</a> set, and none of the <a href="#text-track-cue" title="text track
+ active flag</a> set, none of the <a href="#text-track-cue" title="text track
cue">cues</a> in <var title="">other cues</var> have their
- <a href="#text-track-cue-active-flag">text track cue active flag</a> set, then abort these
+ <a href="#text-track-cue-active-flag">text track cue active flag</a> set, and <var title="">missed cues</var> is empty, then abort these
steps.</li>
- <li><p>If the time was reached through the usual monotonic increase
- 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>. (In the other cases, such as explicit
- seeks, playback is not paused by going past the end time of a <a href="#text-track-cue" title="text track cue">cue</a>, even if that <a href="#text-track-cue" title="text
- track cue">cue</a> has its <a href="#text-track-cue-pause-on-exit-flag">text track cue pause-on-exit
- flag</a> set.)</li>
+ <li>
- <li><p>Let <var title="">affected tracks</var> be a list of <a href="#text-track" title="text track">text tracks</a>, initially empty.</li>
+ <p>If the time was reached through the usual monotonic increase 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 their <a href="#text-track-cue-pause-on-exit-flag">text track cue
+ pause-on-exit flag</a> set and that either have their
+ <a href="#text-track-cue-active-flag">text track cue active flag</a> set or are also in <var title="">missed cues</var>, then immediately <a href="#dom-media-pause" title="dom-media-pause">pause</a> the <a href="#media-element">media
+ element</a>. </p>
- <li><p>For each <a href="#text-track-cue" title="text track cue">text track
- cue</a> in <var title="">other cues</var> that has its
- <a href="#text-track-cue-active-flag">text track cue active flag</a> set, in list order,
- <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-exit">exit</code> at the
- <code><a href="#texttrackcue">TextTrackCue</a></code> object, and add the <a href="#text-track-cue" title="text
- track cue">cue</a>'s <a href="#text-track">text track</a> to <var title="">affected tracks</var>, if it's not already in the
- list.</li>
+ <p class="note">In the other cases, such as explicit seeks,
+ playback is not paused by going past the end time of a <a href="#text-track-cue" title="text track cue">cue</a>, even if that <a href="#text-track-cue" title="text
+ track cue">cue</a> has its <a href="#text-track-cue-pause-on-exit-flag">text track cue pause-on-exit
+ flag</a> set.</p>
- <li><p>For each <a href="#text-track-cue" title="text track cue">text track
- cue</a> in <var title="">current cues</var> that does not have
- its <a href="#text-track-cue-active-flag">text track cue active flag</a> set, in list order,
- <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-enter">enter</code> at the
- <code><a href="#texttrackcue">TextTrackCue</a></code> object, and add the <a href="#text-track-cue" title="text
- track cue">cue</a>'s <a href="#text-track">text track</a> to <var title="">affected tracks</var>, if it's not already in the
- list.</li>
+ </li>
+
+ <li>
+
+ <p>Let <var title="">events</var> be a list of <a href="#concept-task" title="concept-task">tasks</a>, initially empty. Each <a href="#concept-task" title="concept-task">task</a> in this list will be associated
+ with a <a href="#text-track">text track</a>, a <a href="#text-track-cue">text track cue</a>, and
+ a time, which are used to sort the list before the <a href="#concept-task" title="concept-task">tasks</a> are queued.</p>
+
+ <p>Let <var title="">affected tracks</var> be a list of <a href="#text-track" title="text track">text tracks</a>, initially empty.</p>
+
+ <p>When the steps below say to <dfn id="prepare-an-event">prepare an event</dfn> named
+ <var title="">event</var> for a <a href="#text-track-cue">text track cue</a> <var title="">target</var> with a time <var title="">time</var>, the
+ user agent must run these substeps:</p>
+
+ <ol><li><p>Let <var title="">track</var> be the <a href="#text-track">text
+ track</a> with which the <a href="#text-track-cue">text track cue</a> <var title="">target</var> is associated.</li>
+
+ <li><p>Create a <a href="#concept-task" title="concept-task">task</a> to
+ <a href="#fire-a-simple-event">fire a simple event</a> named <var title="">event</var>
+ at <var title="">target</var>.</li>
+
+ <li><p>Add to the newly create <a href="#concept-task" title="concept-task">task</a> to <var title="">events</var>,
+ associated with the time <var title="">time</var>, the <a href="#text-track">text
+ track</a> <var title="">track</var>, and the <a href="#text-track-cue">text track
+ cue</a> <var title="">target</var>.</li>
+
+ <li><p>Add <var title="">track</var> to <var title="">affected
+ tracks</var>.</li>
+
+ </ol></li>
+
+ <li><p>For each <a href="#text-track-cue" title="text track cue">text track cue</a>
+ in <var title="">missed cues</var>, <a href="#prepare-an-event">prepare an event</a>
+ named <code title="event-enter">enter</code> for the
+ <code><a href="#texttrackcue">TextTrackCue</a></code> object with the <a href="#text-track-cue-start-time">text track cue
+ start time</a>.</li>
+
+ <li><p>For each <a href="#text-track-cue" title="text track cue">text track cue</a>
+ in <var title="">other cues</var> that either has its <a href="#text-track-cue-active-flag">text
+ track cue active flag</a> set or is in <var title="">missed
+ cues</var>, <a href="#prepare-an-event">prepare an event</a> named <code title="event-exit">exit</code> for the <code><a href="#texttrackcue">TextTrackCue</a></code>
+ object with the <a href="#text-track-cue-end-time">text track cue end time</a>.</li>
+
+ <li><p>For each <a href="#text-track-cue" title="text track cue">text track cue</a>
+ in <var title="">current cues</var> that does not have its
+ <a href="#text-track-cue-active-flag">text track cue active flag</a> set, <a href="#prepare-an-event">prepare an
+ event</a> named <code title="event-enter">enter</code> for the
+ <code><a href="#texttrackcue">TextTrackCue</a></code> object with the <a href="#text-track-cue-start-time">text track cue
+ start time</a>.</li>
+
+ <li>
+
+ <p>Sort the <a href="#concept-task" title="concept-task">tasks</a> in <var title="">events</var> in ascending time order (<a href="#concept-task" title="concept-task">tasks</a> with earlier times
+ first).</p>
+
+ <p>Further sort <a href="#concept-task" title="concept-task">tasks</a> in <var title="">events</var> that have the same time by the <a href="#text-track">text
+ track</a> associated with the <a href="#concept-task" title="concept-task">tasks</a>, in the same order as the <a href="#text-track" title="text track">text tracks</a> appear in the <a href="#media-element">media
+ element</a>'s <a href="#list-of-text-tracks">list of text tracks</a>.</p>
+
+ <p>Further sort <a href="#concept-task" title="concept-task">tasks</a> in <var title="">events</var> that have the same time and <a href="#text-track">text
+ track</a> by the <a href="#text-track-cue">text track cue</a> associated with
+ the <a href="#concept-task" title="concept-task">tasks</a>, in the same order as
+ the <a href="#text-track-cue" title="text track cue">cues</a> were created (so e.g.
+ for cues from a <span>WebVTT file</span>, that would be the order
+ in which the cues were listed in the file).</p>
+
+ </li>
+
+ <li><p><a href="#queue-a-task" title="queue a task">Queue</a> each <a href="#concept-task" title="concept-task">task</a> in <var title="">events</var>, in
+ list order.</li>
+
+ <li><p>Sort <var title="">affected tracks</var> in the same order
+ as the <a href="#text-track" title="text track">text tracks</a> appear in the
+ <a href="#media-element">media element</a>'s <a href="#list-of-text-tracks">list of text tracks</a>, and
+ remove duplicates.</p>
<li><p>For each <a href="#text-track">text track</a> in <var title="">affected
- tracks</var>, in the order they were added to the list (which will
- match the relative order of the <a href="#text-track" title="text track">text
- tracks</a> in the <a href="#media-element">media element</a>'s <a href="#list-of-text-tracks">list of
- text tracks</a>), <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-cuechange">cuechange</code> at the
- <code><a href="#texttrack">TextTrack</a></code> object, and, if the <a href="#text-track">text
- track</a> has a corresponding <code><a href="#the-track-element">track</a></code> element, to
- then <a href="#fire-a-simple-event">fire a simple event</a> named <code title="event-cuechange">cuechange</code> at the <code><a href="#the-track-element">track</a></code>
+ tracks</var>, in the list order, <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-cuechange">cuechange</code> at the
+ <code><a href="#texttrack">TextTrack</a></code> object, and, if the <a href="#text-track">text track</a>
+ has a corresponding <code><a href="#the-track-element">track</a></code> element, to then <a href="#fire-a-simple-event">fire
+ a simple event</a> named <code title="event-cuechange">cuechange</code> at the <code><a href="#the-track-element">track</a></code>
element as well.</li>
<li><p>Set the <a href="#text-track-cue-active-flag">text track cue active flag</a> of all the
@@ -26543,15 +26609,14 @@
</dl><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 represents the subset of the <a href="#text-track-list-of-cues">text track list of
- cues</a> of the <a href="#text-track">text track</a> that the
- <code><a href="#texttrack">TextTrack</a></code> object represents whose <a href="#text-track-cue-start-time" title="text
- track cue start time">start times</a> occur before the
- <a href="#earliest-possible-position-when-the-script-started">earliest possible position when the script started</a>, in
- <a href="#text-track-cue-order">text track cue order</a>. Otherwise, it must return
- null. When an object is returned, the same object must be returned
- each time.</p>
+ return a <a href="#live">live</a> <code><a href="#texttrackcuelist">TextTrackCueList</a></code> object that
+ represents the subset of the <a href="#text-track-list-of-cues">text track list of cues</a> of
+ the <a href="#text-track">text track</a> that the <code><a href="#texttrack">TextTrack</a></code> object
+ represents whose <a href="#text-track-cue-start-time" title="text track cue start time">start
+ times</a> occur at or after the <a href="#earliest-possible-position-when-the-script-started">earliest possible position
+ when the script started</a>, in <a href="#text-track-cue-order">text track cue
+ order</a>. Otherwise, it must return null. When an object is
+ returned, the same object must be returned each time.</p>
<p>The <dfn id="earliest-possible-position-when-the-script-started">earliest possible position when the script started</dfn>
is whatever the <a href="#earliest-possible-position">earliest possible position</a> was the last
Received on Monday, 22 August 2011 22:17:46 UTC