Skip to content

Commit

Permalink
[e] (0) Hyperlink to 'step 1' of the event loop
Browse files Browse the repository at this point in the history
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=25970
Affected topics: DOM APIs, HTML, Offline Web Applications, Video Text Tracks, Video and Audio

git-svn-id: https://svn.whatwg.org/webapps@8832 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Oct 9, 2014
1 parent 5b47ead commit 53a3762
Show file tree
Hide file tree
Showing 3 changed files with 116 additions and 106 deletions.
87 changes: 45 additions & 42 deletions complete.html

Large diffs are not rendered by default.

87 changes: 45 additions & 42 deletions index

Large diffs are not rendered by default.

48 changes: 26 additions & 22 deletions source
Expand Up @@ -15041,7 +15041,7 @@ own thing rather than part of the extended sentence -->
data-x="rel-stylesheet">external resource link that contributes to the styling processing data-x="rel-stylesheet">external resource link that contributes to the styling processing
model</span> when the element was created by the parser, and the element's style sheet was enabled model</span> when the element was created by the parser, and the element's style sheet was enabled
when the element was created by the parser, and the element's <span>style sheet ready</span> flag when the element was created by the parser, and the element's <span>style sheet ready</span> flag
is not yet set, and, the last time the <span>event loop</span> reached step 1, the element was is not yet set, and, the last time the <span>event loop</span> reached <a href="#step1">step 1</a>, the element was
<span data-x="in a document">in that <code>Document</code></span>, and the user agent hasn't given <span data-x="in a document">in that <code>Document</code></span>, and the user agent hasn't given
up on that particular style sheet yet. A user agent may give up on a style sheet at any time.</p> up on that particular style sheet yet. A user agent may give up on a style sheet at any time.</p>


Expand Down Expand Up @@ -25716,7 +25716,7 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>


<li>The element is <span data-x="in a document">in a <code>Document</code></span> or was <span <li>The element is <span data-x="in a document">in a <code>Document</code></span> or was <span
data-x="in a document">in a <code>Document</code></span> the last time the <span>event loop</span> data-x="in a document">in a <code>Document</code></span> the last time the <span>event loop</span>
reached step 1.</li> reached <a href="#step1">step 1</a>.</li>


<li>The element's <span>node document</span> is <span>fully active</span>.</li> <li>The element's <span>node document</span> is <span>fully active</span>.</li>


Expand All @@ -25732,7 +25732,7 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
<span>fallback content</span>.</li> <span>fallback content</span>.</li>


<li>The element is <span>being rendered</span>, or was <span>being rendered</span> the last time <li>The element is <span>being rendered</span>, or was <span>being rendered</span> the last time
the <span>event loop</span> reached step 1.</li> the <span>event loop</span> reached <a href="#step1">step 1</a>.</li>


</ul> </ul>


Expand Down Expand Up @@ -27049,7 +27049,7 @@ attribute, set the <span>browsing context name</span> of the element's <span>nes


<p>Frames of video must be obtained from the video track that was <span <p>Frames of video must be obtained from the video track that was <span
data-x="dom-VideoTrack-selected">selected</span> when the <span>event loop</span> last reached data-x="dom-VideoTrack-selected">selected</span> when the <span>event loop</span> last reached
step 1.</p> <a href="#step1">step 1</a>.</p>


<p class="note">Which frame in a video stream corresponds to a particular playback position is <p class="note">Which frame in a video stream corresponds to a particular playback position is
defined by the video stream's format.</p> defined by the video stream's format.</p>
Expand Down Expand Up @@ -27322,7 +27322,7 @@ interface <dfn>HTMLAudioElement</dfn> : <span>HTMLMediaElement</span> {};</pre>
<p>When an <code>audio</code> element is <span>potentially playing</span>, it must have its audio <p>When an <code>audio</code> element is <span>potentially playing</span>, it must have its audio
data played synchronised with the <span>current playback position</span>, at the element's data played synchronised with the <span>current playback position</span>, at the element's
<span>effective media volume</span>. The user agent must play the audio from audio tracks that <span>effective media volume</span>. The user agent must play the audio from audio tracks that
were enabled when the <span>event loop</span> last reached step 1.</p> were enabled when the <span>event loop</span> last reached <a href="#step1">step 1</a>.</p>


<p>When an <code>audio</code> element is not <span>potentially playing</span>, audio must not play <p>When an <code>audio</code> element is not <span>potentially playing</span>, audio must not play
for the element.</p> for the element.</p>
Expand Down Expand Up @@ -27946,10 +27946,10 @@ interface <dfn>HTMLMediaElement</dfn> : <span>HTMLElement</span> {
<span>media element</span>, the video data of the <span>media resource</span> is only that of the <span>media element</span>, the video data of the <span>media resource</span> is only that of the
currently selected track (if any) as given by the element's <code currently selected track (if any) as given by the element's <code
data-x="dom-media-videoTracks">videoTracks</code> attribute when the <span>event loop</span> last data-x="dom-media-videoTracks">videoTracks</code> attribute when the <span>event loop</span> last
reached step 1, and the audio data of the <span>media resource</span> is the result of mixing all reached <a href="#step1">step 1</a>, and the audio data of the <span>media resource</span> is the result of mixing all
the currently enabled tracks (if any) given by the element's <code the currently enabled tracks (if any) given by the element's <code
data-x="dom-media-audioTracks">audioTracks</code> attribute when the <span>event loop</span> last data-x="dom-media-audioTracks">audioTracks</code> attribute when the <span>event loop</span> last
reached step 1.</p> reached <a href="#step1">step 1</a>.</p>


<p class="note">Both <code>audio</code> and <code>video</code> elements can be used for both audio <p class="note">Both <code>audio</code> and <code>video</code> elements can be used for both audio
and video. The main difference between the two is simply that the <code>audio</code> element has and video. The main difference between the two is simply that the <code>audio</code> element has
Expand Down Expand Up @@ -30186,7 +30186,7 @@ interface <dfn>HTMLMediaElement</dfn> : <span>HTMLElement</span> {
</ul> </ul>


<p>The <dfn><code data-x="dom-media-ended">ended</code></dfn> attribute must return true if, the <p>The <dfn><code data-x="dom-media-ended">ended</code></dfn> attribute must return true if, the
last time the <span>event loop</span> reached step 1, the <span>media element</span> had last time the <span>event loop</span> reached <a href="#step1">step 1</a>, the <span>media element</span> had
<span>ended playback</span> and the <span>direction of playback</span> was forwards, and false <span>ended playback</span> and the <span>direction of playback</span> was forwards, and false
otherwise.</p> otherwise.</p>


Expand Down Expand Up @@ -30257,7 +30257,7 @@ interface <dfn>HTMLMediaElement</dfn> : <span>HTMLElement</span> {
doesn't fire in the loop case). --> doesn't fire in the loop case). -->


<li><p>As defined above, the <code data-x="dom-media-ended">ended</code> IDL attribute starts <li><p>As defined above, the <code data-x="dom-media-ended">ended</code> IDL attribute starts
returning true once the <span>event loop</span> returns to step 1.</p></li> returning true once the <span>event loop</span> returns to <a href="#step1">step 1</a>.</p></li>


<li><p><span>Queue a task</span> to <span>fire a simple event</span> named <code <li><p><span>Queue a task</span> to <span>fire a simple event</span> named <code
data-x="event-media-timeupdate">timeupdate</code> at the <span>media element</span>.</p></li> data-x="event-media-timeupdate">timeupdate</code> at the <span>media element</span>.</p></li>
Expand Down Expand Up @@ -33595,7 +33595,7 @@ interface <dfn>TextTrack</dfn> : <span>EventTarget</span> {


<p>A <span>text track cue</span>'s <dfn>active flag was set when the script started</dfn> if its <p>A <span>text track cue</span>'s <dfn>active flag was set when the script started</dfn> if its
<span>text track cue active flag</span> was set the last time the <span>event loop</span> reached <span>text track cue active flag</span> was set the last time the <span>event loop</span> reached
step 1.</p> <a href="#step1">step 1</a>.</p>


<hr> <hr>


Expand Down Expand Up @@ -35114,7 +35114,7 @@ dictionary <dfn>TrackEventInit</dfn> : <span>EventInit</span> {


<p>When a <span>media element</span> that is paused is <span data-x="remove an element from a <p>When a <span>media element</span> that is paused is <span data-x="remove an element from a
document">removed from a document</span> and not reinserted before the next time the <span>event document">removed from a document</span> and not reinserted before the next time the <span>event
loop</span> reaches step 1, implementations that are resource constrained are encouraged to take loop</span> reaches <a href="#step1">step 1</a>, implementations that are resource constrained are encouraged to take
that opportunity to release all hardware resources (like video planes, networking resources, and that opportunity to release all hardware resources (like video planes, networking resources, and
data buffers) used by the <span>media element</span>. (User agents still have to keep track of the data buffers) used by the <span>media element</span>. (User agents still have to keep track of the
playback position and so forth, though, in case playback is later restarted.)</p> playback position and so forth, though, in case playback is later restarted.)</p>
Expand Down Expand Up @@ -84352,7 +84352,7 @@ interface <dfn>ApplicationCache</dfn> : <span>EventTarget</span> {
</div> </div>




<h4>Browser state</h4> <h4 id="navigator.online">Browser state</h4>


<pre class="idl">[NoInterfaceObject, Exposed=(Window,Worker)] <pre class="idl">[NoInterfaceObject, Exposed=(Window,Worker)]
interface <dfn>NavigatorOnLine</dfn> { interface <dfn>NavigatorOnLine</dfn> {
Expand Down Expand Up @@ -85287,11 +85287,15 @@ dictionary <dfn>ErrorEventInit</dfn> : <span>EventInit</span> {


<!-- lots of places in the spec refer to "step 1" --> <!-- lots of places in the spec refer to "step 1" -->


<li><p>Select the oldest <span data-x="concept-task">task</span> on one of the <span>event <li id="step1">
loop</span>'s <span data-x="task queue">task queues</span>, if any, ignoring, in the case of a
<span>browsing context</span> <span>event loop</span>, tasks whose associated <p>Select the oldest <span data-x="concept-task">task</span> on one of the <span>event
<code>Document</code>s are not <span>fully active</span>. The user agent may pick any <span>task loop</span>'s <span data-x="task queue">task queues</span>, if any, ignoring, in the case of a
queue</span>.</p></li> <span>browsing context</span> <span>event loop</span>, tasks whose associated
<code>Document</code>s are not <span>fully active</span>. The user agent may pick any <span>task
queue</span>.</p>

</li>


<!-- note: reference to 'previous step' below --> <!-- note: reference to 'previous step' below -->


Expand Down Expand Up @@ -85339,7 +85343,7 @@ dictionary <dfn>ErrorEventInit</dfn> : <span>EventInit</span> {
loop</span>, aborting these steps, resuming the <span>run a worker</span> steps described in the loop</span>, aborting these steps, resuming the <span>run a worker</span> steps described in the
Web Workers section below.</p></li> Web Workers section below.</p></li>


<li><p>Return to the first step of the <span>event loop</span>.</p></li> <li><p>Return to the <a href="#step1">first step</a> of the <span>event loop</span>.</p></li>


</ol> </ol>


Expand Down Expand Up @@ -91212,7 +91216,7 @@ interface <dfn>WebSocket</dfn> : <span>EventTarget</span> {
<p>The <dfn><code data-x="dom-WebSocket-bufferedAmount">bufferedAmount</code></dfn> attribute must <p>The <dfn><code data-x="dom-WebSocket-bufferedAmount">bufferedAmount</code></dfn> attribute must
return the number of bytes of application data (UTF-8 text and binary data) that have been queued return the number of bytes of application data (UTF-8 text and binary data) that have been queued
using <code data-x="dom-WebSocket-send">send()</code> but that, as of the last time the using <code data-x="dom-WebSocket-send">send()</code> but that, as of the last time the
<span>event loop</span> reached step 1, had not yet been transmitted to the network. (This thus <span>event loop</span> reached <a href="#step1">step 1</a>, had not yet been transmitted to the network. (This thus
includes any text sent during the execution of the current task, regardless of whether the user includes any text sent during the execution of the current task, regardless of whether the user
agent is able to transmit text in the background <span>in parallel</span> with script execution.) This does not include agent is able to transmit text in the background <span>in parallel</span> with script execution.) This does not include
framing overhead incurred by the protocol, or buffering done by the operating system or network framing overhead incurred by the protocol, or buffering done by the operating system or network
Expand Down Expand Up @@ -91692,20 +91696,20 @@ dictionary <dfn>CloseEventInit</dfn> : <span>EventInit</span> {


<p>A <code>WebSocket</code> object whose <code data-x="dom-WebSocket-readyState">readyState</code> <p>A <code>WebSocket</code> object whose <code data-x="dom-WebSocket-readyState">readyState</code>
attribute's value was set to <code data-x="dom-WebSocket-CONNECTING">CONNECTING</code> (0) as of attribute's value was set to <code data-x="dom-WebSocket-CONNECTING">CONNECTING</code> (0) as of
the last time the <span>event loop</span> reached step 1 must not be garbage collected if there the last time the <span>event loop</span> reached <a href="#step1">step 1</a> must not be garbage collected if there
are any event listeners registered for <code data-x="event-open">open</code> events, <code are any event listeners registered for <code data-x="event-open">open</code> events, <code
data-x="event-message">message</code> events, <code data-x="event-error">error</code> events, or data-x="event-message">message</code> events, <code data-x="event-error">error</code> events, or
<code data-x="event-close">close</code> events.</p> <code data-x="event-close">close</code> events.</p>


<p>A <code>WebSocket</code> object whose <code data-x="dom-WebSocket-readyState">readyState</code> <p>A <code>WebSocket</code> object whose <code data-x="dom-WebSocket-readyState">readyState</code>
attribute's value was set to <code data-x="dom-WebSocket-OPEN">OPEN</code> (1) as of the last time attribute's value was set to <code data-x="dom-WebSocket-OPEN">OPEN</code> (1) as of the last time
the <span>event loop</span> reached step 1 must not be garbage collected if there are any event the <span>event loop</span> reached <a href="#step1">step 1</a> must not be garbage collected if there are any event
listeners registered for <code data-x="event-message">message</code> events, <code listeners registered for <code data-x="event-message">message</code> events, <code
data-x="event-error">error</code>, or <code data-x="event-close">close</code> events.</p> data-x="event-error">error</code>, or <code data-x="event-close">close</code> events.</p>


<p>A <code>WebSocket</code> object whose <code data-x="dom-WebSocket-readyState">readyState</code> <p>A <code>WebSocket</code> object whose <code data-x="dom-WebSocket-readyState">readyState</code>
attribute's value was set to <code data-x="dom-WebSocket-CLOSING">CLOSING</code> (2) as of the attribute's value was set to <code data-x="dom-WebSocket-CLOSING">CLOSING</code> (2) as of the
last time the <span>event loop</span> reached step 1 must not be garbage collected if there are last time the <span>event loop</span> reached <a href="#step1">step 1</a> must not be garbage collected if there are
any event listeners registered for <code data-x="event-error">error</code> or <code any event listeners registered for <code data-x="event-error">error</code> or <code
data-x="event-close">close</code> events.</p> data-x="event-close">close</code> events.</p>


Expand Down

0 comments on commit 53a3762

Please sign in to comment.