Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[e] (0) more tweaking event definitions
git-svn-id: http://svn.whatwg.org/webapps@6016 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Apr 15, 2011
1 parent c6cd567 commit 9711ca0
Show file tree
Hide file tree
Showing 3 changed files with 126 additions and 53 deletions.
56 changes: 38 additions & 18 deletions complete.html
Expand Up @@ -29239,7 +29239,7 @@ <h6 id=media-controllers><span class=secno>4.8.10.11.2 </span>Media controllers<
<p>Every 15 to 250ms, or whenever the <code><a href=#mediacontroller>MediaController</a></code>'s
<a href=#media-controller-duration>media controller duration</a> changes, whichever happens
least often, 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-durationchange><a href=#event-media-durationchange>durationchange</a></code> at the
<a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-MediaController-durationchange><a href=#event-mediacontroller-durationchange>durationchange</a></code> at the
<code><a href=#mediacontroller>MediaController</a></code>.</p>

<p>The <dfn id=dom-mediacontroller-currenttime title=dom-MediaController-currentTime><code>currentTime</code></dfn>
Expand All @@ -29250,7 +29250,7 @@ <h6 id=media-controllers><span class=secno>4.8.10.11.2 </span>Media controllers<
<p>Every 15 to 250ms, or whenever the <code><a href=#mediacontroller>MediaController</a></code>'s
<a href=#media-controller-position>media controller position</a> changes, whichever happens
least often, 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
<a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-MediaController-timeupdate><a href=#event-mediacontroller-timeupdate>timeupdate</a></code> at the
<code><a href=#mediacontroller>MediaController</a></code>.</p>

<hr><p>The <dfn id=dom-mediacontroller-paused title=dom-MediaController-paused><code>paused</code></dfn>
Expand All @@ -29266,7 +29266,7 @@ <h6 id=media-controllers><span class=secno>4.8.10.11.2 </span>Media controllers<
<p>Whenever the <code><a href=#mediacontroller>MediaController</a></code> changes from a
<a href=#playing-media-controller>playing media controller</a> to a <a href=#paused-media-controller>paused media
controller</a>, 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-pause><a href=#event-media-pause>pause</a></code> at the
<a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-MediaController-pause><a href=#event-mediacontroller-pause>pause</a></code> at the
<code><a href=#mediacontroller>MediaController</a></code>.</p>

<p>When the <dfn id=dom-mediacontroller-play title=dom-MediaController-play><code>play()</code></dfn> method
Expand All @@ -29277,7 +29277,7 @@ <h6 id=media-controllers><span class=secno>4.8.10.11.2 </span>Media controllers<
<p>Whenever the <code><a href=#mediacontroller>MediaController</a></code> changes from a
<a href=#paused-media-controller>paused media controller</a> to a <a href=#playing-media-controller>playing media
controller</a>, 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-play><a href=#event-media-play>play</a></code> at the
<a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-MediaController-play><a href=#event-mediacontroller-play>play</a></code> at the
<code><a href=#mediacontroller>MediaController</a></code>.</p>

<hr><p>The <dfn id=dom-mediacontroller-defaultplaybackrate title=dom-MediaController-defaultPlaybackRate><code>defaultPlaybackRate</code></dfn>
Expand All @@ -29297,7 +29297,7 @@ <h6 id=media-controllers><span class=secno>4.8.10.11.2 </span>Media controllers<
<p>Whenever the <a href=#media-controller-default-playback-rate>media controller default playback rate</a>
or the <a href=#media-controller-playback-rate>media controller playback rate</a> are changed, 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-ratechange><a href=#event-media-ratechange>ratechange</a></code> at the
event</a> named <code title=event-MediaController-ratechange><a href=#event-mediacontroller-ratechange>ratechange</a></code> at the
<code><a href=#mediacontroller>MediaController</a></code>.</p>

<hr><p>The <dfn id=dom-mediacontroller-volume title=dom-MediaController-volume><code>volume</code></dfn>
Expand All @@ -29320,20 +29320,20 @@ <h6 id=media-controllers><span class=secno>4.8.10.11.2 </span>Media controllers<
<p>Whenever either the <a href=#media-controller-volume-multiplier>media controller volume
multiplier</a> or the <a href=#media-controller-mute-override>media controller mute override</a>
are changed, 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-volumechange><a href=#event-media-volumechange>volumechange</a></code> at the
<a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-MediaController-volumechange><a href=#event-mediacontroller-volumechange>volumechange</a></code> at the
<code><a href=#mediacontroller>MediaController</a></code>.</p>

<hr><p>The following are the <a href=#event-handlers>event handlers</a> that must be
supported, as IDL attributes, by all objects implementing the
<code><a href=#mediacontroller>MediaController</a></code> interface:</p>

<table><thead><tr><th><a href=#event-handlers title="event handlers">Event handler</a> <th><a href=#event-handler-event-type>Event handler event type</a>
<tbody><tr><td><dfn id=handler-mediacontroller-ondurationchange title=handler-MediaController-ondurationchange><code>ondurationchange</code></dfn> <td> <code title=event-durationchange>durationchange</code>
<tr><td><dfn id=handler-mediacontroller-ontimeupdate title=handler-MediaController-ontimeupdate><code>ontimeupdate</code></dfn> <td> <code title=event-durationchange>durationchange</code>
<tr><td><dfn id=handler-mediacontroller-onplay title=handler-MediaController-onplay><code>onplay</code></dfn> <td> <code title=event-play>play</code>
<tr><td><dfn id=handler-mediacontroller-onpause title=handler-MediaController-onpause><code>onpause</code></dfn> <td> <code title=event-pause>pause</code>
<tr><td><dfn id=handler-mediacontroller-onratechange title=handler-MediaController-onratechange><code>onratechange</code></dfn> <td> <code title=event-ratechange>ratechange</code>
<tr><td><dfn id=handler-mediacontroller-onvolumechange title=handler-MediaController-onvolumechange><code>onvolumechange</code></dfn> <td> <code title=event-volumechange>volumechange</code>
<tbody><tr><td><dfn id=handler-mediacontroller-ondurationchange title=handler-MediaController-ondurationchange><code>ondurationchange</code></dfn> <td> <code title=event-MediaController-durationchange><a href=#event-mediacontroller-durationchange>durationchange</a></code>
<tr><td><dfn id=handler-mediacontroller-ontimeupdate title=handler-MediaController-ontimeupdate><code>ontimeupdate</code></dfn> <td> <code title=event-MediaController-durationchange><a href=#event-mediacontroller-durationchange>durationchange</a></code>
<tr><td><dfn id=handler-mediacontroller-onplay title=handler-MediaController-onplay><code>onplay</code></dfn> <td> <code title=event-MediaController-play><a href=#event-mediacontroller-play>play</a></code>
<tr><td><dfn id=handler-mediacontroller-onpause title=handler-MediaController-onpause><code>onpause</code></dfn> <td> <code title=event-MediaController-pause><a href=#event-mediacontroller-pause>pause</a></code>
<tr><td><dfn id=handler-mediacontroller-onratechange title=handler-MediaController-onratechange><code>onratechange</code></dfn> <td> <code title=event-MediaController-ratechange><a href=#event-mediacontroller-ratechange>ratechange</a></code>
<tr><td><dfn id=handler-mediacontroller-onvolumechange title=handler-MediaController-onvolumechange><code>onvolumechange</code></dfn> <td> <code title=event-MediaController-volumechange><a href=#event-mediacontroller-volumechange>volumechange</a></code>
</table><hr><p>The <a href=#task-source>task source</a> for the <a href=#concept-task title=concept-task>tasks</a> listed in this section is the
<a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>

Expand Down Expand Up @@ -33090,16 +33090,16 @@ <h5 id=mediaevents><span class=secno>4.8.10.16 </span>Event summary</h5>
<td>Playback has started after having been delayed due to lack of <a href=#media-data>media data</a>.
<td>The element is newly <a href=#potentially-playing>potentially playing</a>, either because <code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> is newly equal to or greater than <code title=dom-media-HAVE_FUTURE_DATA><a href=#dom-media-have_future_data>HAVE_FUTURE_DATA</a></code>, or because <code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> is newly false. It is possible for playback to start without this event firing, e.g. if when playback would have started,
<!--CONTROLLER-->
one of the element's <a href=#current-media-controller>current media controller</a>'s other <a href=#slaved-media-elements>slaved media elements</a> was a <a href=#blocked-media-element>blocked media element</a>, or
the element was <a href=#blocked-on-its-media-controller>blocked on its media controller</a>, or
<!--CONTROLLER-->
the element had been <a href=#paused-for-user-interaction>paused for user interaction</a>.
<!-- XXXXX we should change this so that 'playing' fires in those two cases too (but when readyState/paused change, not when playback actually starts) -->
<!-- XXXXX we should change this so that 'playing' fires in those three cases too (when readyState/paused change, not when playback actually starts) -->
<tr><td><dfn id=event-media-waiting title=event-media-waiting><code>waiting</code></dfn>
<td><code><a href=#event>Event</a></code>
<td>Playback has stopped because the next frame is not available, but the user agent expects that frame to become available in due course.
<td><code title=dom-media-readyState><a href=#dom-media-readystate>readyState</a></code> is equal to or less than <code title=dom-media-HAVE_CURRENT_DATA><a href=#dom-media-have_current_data>HAVE_CURRENT_DATA</a></code>, and <code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> is false. Either <code title=dom-media-seeking><a href=#dom-media-seeking>seeking</a></code> is true, or the <a href=#current-playback-position>current playback position</a> is not contained in any of the ranges in <code title=dom-media-buffered><a href=#dom-media-buffered>buffered</a></code>. It is possible for playback to stop for other reasons without <code title=dom-media-paused><a href=#dom-media-paused>paused</a></code> being false, but those reasons do not fire this event (and when those situations resolve, a separate <code title=event-media-playing><a href=#event-media-playing>playing</a></code> event is not fired either): e.g.
<!--CONTROLLER-->
one of the element's <a href=#current-media-controller>current media controller</a>'s other <a href=#slaved-media-elements>slaved media elements</a> is a newly <a href=#blocked-media-element>blocked media element</a>, or
the element is newly <a href=#blocked-on-its-media-controller>blocked on its media controller</a>, or
<!--CONTROLLER-->
<a href=#ended-playback title="ended playback">playback ended</a>, or playback <a href=#stopped-due-to-errors>stopped due to errors</a>, or the element has <a href=#paused-for-user-interaction>paused for user interaction</a>.
<tbody><tr><td><dfn id=event-media-seeking title=event-media-seeking><code>seeking</code></dfn>
Expand Down Expand Up @@ -33139,11 +33139,31 @@ <h5 id=mediaevents><span class=secno>4.8.10.16 </span>Event summary</h5>
<td><code><a href=#event>Event</a></code>
<td>Either the <code title=dom-media-volume><a href=#dom-media-volume>volume</a></code> attribute or the <code title=dom-media-muted><a href=#dom-media-muted>muted</a></code> attribute has changed. Fired after the relevant attribute's setter has returned.
<td>
</table><!--CONTROLLER--><p>The last six events in this table are also fired on <code><a href=#mediacontroller>MediaController</a></code> objects.</p>
<!--CONTROLLER-->
</table><!--CONTROLLER--><p>The following events fire on <code><a href=#mediacontroller>MediaController</a></code> objects:</p>

<table><thead><tr><th>Event name
<th>Interface
<th>Dispatched when...

<div class=impl>
<tbody><tr><td><dfn id=event-mediacontroller-durationchange title=event-MediaController-durationchange><code>durationchange</code></dfn>
<td><code><a href=#event>Event</a></code>
<td>The <code title=dom-MediaController-duration><a href=#dom-mediacontroller-duration>duration</a></code> attribute has just been updated.
<tr><td><dfn id=event-mediacontroller-timeupdate title=event-MediaController-timeupdate><code>timeupdate</code></dfn>
<td><code><a href=#event>Event</a></code>
<td>The <a href=#media-controller-position>media controller position</a> changed.
<tr><td><dfn id=event-mediacontroller-play title=event-MediaController-play><code>play</code></dfn>
<td><code><a href=#event>Event</a></code>
<td>The <code title=dom-MediaController-paused><a href=#dom-mediacontroller-paused>paused</a></code> attribute is newly false.
<tr><td><dfn id=event-mediacontroller-pause title=event-MediaController-pause><code>pause</code></dfn>
<td><code><a href=#event>Event</a></code>
<td>The <code title=dom-MediaController-paused><a href=#dom-mediacontroller-paused>paused</a></code> attribute is newly true.
<tr><td><dfn id=event-mediacontroller-ratechange title=event-MediaController-ratechange><code>ratechange</code></dfn>
<td><code><a href=#event>Event</a></code>
<td>Either the <code title=dom-MediaController-defaultPlaybackRate><a href=#dom-mediacontroller-defaultplaybackrate>defaultPlaybackRate</a></code> attribute or the <code title=dom-MediaController-playbackRate><a href=#dom-mediacontroller-playbackrate>playbackRate</a></code> attribute has just been updated.
<tr><td><dfn id=event-mediacontroller-volumechange title=event-MediaController-volumechange><code>volumechange</code></dfn>
<td><code><a href=#event>Event</a></code>
<td>Either the <code title=dom-MediaController-volume><a href=#dom-mediacontroller-volume>volume</a></code> attribute or the <code title=dom-MediaController-muted><a href=#dom-mediacontroller-muted>muted</a></code> attribute has just been updated.
</table><!--CONTROLLER--><div class=impl>

<h5 id=security-and-privacy-considerations><span class=secno>4.8.10.17 </span>Security and privacy considerations</h5>

Expand Down

0 comments on commit 9711ca0

Please sign in to comment.