spec/Overview.html 1.1091 1902 Make addCueRange() have an identifier so

Make addCueRange() have an identifier so that people don't have to use
currying. (Re: re-thinking 'cue ranges') (credit: ds) (whatwg r1902)
(changed by: Ian Hickson)
Diffs for this change per section: 
 addCueRange(className, id, start, end, pauseOnExit, enterCallback, exitCallback)
 http://people.w3.org/mike/diffs/html5/spec/Overview.1.1091.html#addcuerange
 HTMLMediaElement
 http://people.w3.org/mike/diffs/html5/spec/Overview.1.1091.html#htmlmediaelement
 removeCueRanges(className)
 http://people.w3.org/mike/diffs/html5/spec/Overview.1.1091.html#removecueranges
 handleEvent
 http://people.w3.org/mike/diffs/html5/spec/Overview.1.1091.html#handleevent
 CueRangeCallback
 http://people.w3.org/mike/diffs/html5/spec/Overview.1.1091.html#cuerangecallback
 VoidCallback
 http://people.w3.org/mike/diffs/html5/spec/Overview.1.1091.html#voidcallback
 4.7.10.10. User interface
 http://people.w3.org/mike/diffs/html5/spec/Overview.1.1091.html#user-interface
 cue ranges
 http://people.w3.org/mike/diffs/html5/spec/Overview.1.1091.html#cue-ranges0
Current content per affected section: 
 http://dev.w3.org/html5/spec/Overview.html#addcuerange
 http://dev.w3.org/html5/spec/Overview.html#htmlmediaelement
 http://dev.w3.org/html5/spec/Overview.html#removecueranges
 http://dev.w3.org/html5/spec/Overview.html#handleevent
 http://dev.w3.org/html5/spec/Overview.html#cuerangecallback
 http://dev.w3.org/html5/spec/Overview.html#voidcallback
 http://dev.w3.org/html5/spec/Overview.html#user-interface
 http://dev.w3.org/html5/spec/Overview.html#cue-ranges0
Previously published WD content per affected section: 
 http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#addcuerange
 http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#htmlmediaelement
 http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#removecueranges
 http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#handleevent
 http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#cuerangecallback
 http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#voidcallback
 http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#user-interface
 http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#cue-ranges0
Cumulative diff: http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.1090&r2=1.1091&f=h
http://html5.org/tools/web-apps-tracker?from=1901&to=1902
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1090
retrieving revision 1.1091
diff -u -d -r1.1090 -r1.1091
--- Overview.html 22 Jul 2008 02:57:51 -0000 1.1090
+++ Overview.html 22 Jul 2008 09:27:04 -0000 1.1091
@@ -17509,7 +17509,7 @@
 attribute unsigned long <a href="#currentloop" title=dom-media-currentLoop>currentLoop</a>;
 
 // cue ranges
- void <a href="#addcuerange" title=dom-media-addCueRange>addCueRange</a>(in DOMString className, in float start, in float end, in boolean pauseOnExit, in <a href="#voidcallback">VoidCallback</a> enterCallback, in <a href="#voidcallback">VoidCallback</a> exitCallback);
+ void <a href="#addcuerange" title=dom-media-addCueRange>addCueRange</a>(in DOMString className, in DOMString id, in float start, in float end, in boolean pauseOnExit, in <a href="#cuerangecallback">CueRangeCallback</a> enterCallback, in <a href="#cuerangecallback">CueRangeCallback</a> exitCallback);
 void <a href="#removecueranges" title=dom-media-removeCueRanges>removeCueRanges</a>(in DOMString className);
 
 // controls
@@ -19061,6 +19061,13 @@
 <dd>A group of related ranges can be given the same class name so that
 they can all be removed at the same time.
 
+ <dt>An identifier
+
+ <dt>
+
+ <dd>A string can be assigned to each cue range for identification by
+ script. The string need not be unique and can contain any value.
+
 <dt>A start time
 
 <dt>An end time
@@ -19089,20 +19096,20 @@
 
 <p>The <dfn id=addcuerange
 title=dom-media-addCueRange><code>addCueRange(<var
- title="">className</var>, <var title="">start</var>, <var
- title="">end</var>, <var title="">pauseOnExit</var>, <var
- title="">enterCallback</var>, <var
+ title="">className</var>, <var title="">id</var>, <var
+ title="">start</var>, <var title="">end</var>, <var
+ title="">pauseOnExit</var>, <var title="">enterCallback</var>, <var
 title="">exitCallback</var>)</code></dfn> method must, when called, add a
 <a href="#cue-ranges0">cue range</a> to the <a href="#media7">media
 element</a>, that cue range having the class name <var
- title="">className</var>, the start time <var title="">start</var> (in
- seconds), the end time <var title="">end</var> (in seconds), the "pause"
- boolean with the same value as <var title="">pauseOnExit</var>, the
- "enter" callback <var title="">enterCallback</var>, the "exit" callback
- <var title="">exitCallback</var>, and an "active" boolean that is true if
- the <a href="#current0">current playback position</a> is equal to or
- greater than the start time and less than the end time, and false
- otherwise.
+ title="">className</var>, the identifier <var title="">id</var>, the start
+ time <var title="">start</var> (in seconds), the end time <var
+ title="">end</var> (in seconds), the "pause" boolean with the same value
+ as <var title="">pauseOnExit</var>, the "enter" callback <var
+ title="">enterCallback</var>, the "exit" callback <var
+ title="">exitCallback</var>, and an "active" boolean that is true if the
+ <a href="#current0">current playback position</a> is equal to or greater
+ than the start time and less than the end time, and false otherwise.
 
 <p>The <dfn id=removecueranges
 title=dom-media-removeCueRanges><code>removeCueRanges(<var
@@ -19170,7 +19177,8 @@
 <p>Invoke all the non-null "exit" callbacks for all of the <a
 href="#cue-ranges0" title="cue range">cue ranges</a> in <var
 title="">other ranges</var> that have their "active" boolean set to
- "true" (active), in list order.
+ "true" (active), in list order, passing their identifier as the
+ callback's only argument.
 </li>
 <!-- XXX queue -->
 
@@ -19178,7 +19186,8 @@
 <p>Invoke all the non-null "enter" callbacks for all of the <a
 href="#cue-ranges0" title="cue range">cue ranges</a> in <var
 title="">current ranges</var> that have their "active" boolean set to
- "false" (inactive), in list order.
+ "false" (inactive), in list order, passing their identifier as the
+ callback's only argument.
 </li>
 <!-- XXX queue -->
 
@@ -19192,20 +19201,20 @@
 <!-- XXX the remainder of this subsection may be removed if we ever
 get a way to mark up callbacks in IDL -->
 
- <p>Invoking a callback (an object implementing the <code><a
- href="#voidcallback">VoidCallback</a></code> interface) means calling its
- <code title=dom-VoidCallback-handleEvent><a
- href="#handleevent">handleEvent()</a></code> method.
+ <p>Invoking a callback (an object implementing one of the following two
+ interfaces) means calling its <code title="">handleEvent()</code> method.
 
 <pre class=idl>interface <dfn id=voidcallback>VoidCallback</dfn> {
- void <a href="#handleevent" title=dom-voidCallback-handleEvent>handleEvent</a>();
+ void <span title=dom-voidCallback-handleEvent>handleEvent</span>();
+};
+
+interface <dfn id=cuerangecallback>CueRangeCallback</dfn> {
+ void <span title=dom-cueRangeCallback-handleEvent>handleEvent</span>(in DOMString id);
 };</pre>
 
- <p>The <dfn id=handleevent
- title=dom-voidCallback-handleEvent><code>handleEvent</code></dfn> method
- of objects implementing the <code><a
- href="#voidcallback">VoidCallback</a></code> interface is the entry point
- for the callback represented by the object.
+ <p>The <dfn id=handleevent title=""><code>handleEvent</code></dfn> method
+ of objects implementing these interfaces is the entry point for the
+ callback represented by the object.
 
 <h5 id=user-interface><span class=secno>4.7.10.10. </span>User interface</h5>

Received on Tuesday, 22 July 2008 09:30:57 UTC

AltStyle によって変換されたページ (->オリジナル) /