[cssom] Define when scroll and resize fire. https://www.w3.org/Bugs/Public/show_bug.cgi?id=11329

Author: Simon Pieters

cssom-view/Overview.html

@@ -13,7 +13,7 @@
 
    <h1 id="cssom-view-module">CSSOM View Module</h1>
 
-   <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 8 May 2013</h2>
+   <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 14 May 2013</h2>
 
    <dl>
 
@@ -69,7 +69,7 @@ <h2 class="no-num no-toc" id="sotd">Status of this Document</h2>
    can be found in the <a href="http://www.w3.org/TR/">W3C technical reports
    index at http://www.w3.org/TR/.</a></em>
 
-<p>This is the 8 May 2013 Editor's Draft of CSSOM View. Please send
+<p>This is the 14 May 2013 Editor's Draft of CSSOM View. Please send
 comments to
 <a href="mailto:www-style@w3.org?subject=%5Bcssom-view%5D%20">www-style@w3.org</a>
 (<a href="http://lists.w3.org/Archives/Public/www-style/">archived</a>)
@@ -126,6 +126,10 @@ <h2 class="no-num no-toc" id="toc">Table of Contents</h2>
   <ol class="toc">
    <li><a href="#the-clientrectlist-interface"><span class="secno">10.1 </span>The <code title="">ClientRectList</code> Interface</a></li>
    <li><a href="#the-clientrect-interface"><span class="secno">10.2 </span>The <code title="">ClientRect</code> Interface</a></ol></li>
+ <li><a href="#events"><span class="secno">11 </span>Events</a>
+  <ol class="toc">
+   <li><a href="#resizing-viewports"><span class="secno">11.1 </span>Resizing viewports</a></li>
+   <li><a href="#scrolling"><span class="secno">11.2 </span>Scrolling</a></ol></li>
  <li><a class="no-num" href="#references">References</a>
   <ol class="toc">
    <li><a class="no-num" href="#normative-references">Normative references</a></ol></li>
@@ -815,7 +819,31 @@ <h3 id="the-clientrect-interface"><span class="secno">10.2 </span>The <code titl
 <p>The <code><a href="#widl-ClientRect-height">height</a></code> attribute must return the height of the rectangle box.</p>    <p class="note">This is identical to <code title="widl-ClientRect-bottom">bottom</code> minus <code title="widl-ClientRect-top">top</code>.</dd>
 </dl>
 
-
+  
+  <h2 id="events"><span class="secno">11 </span>Events</h2>
+  
+  <h3 id="resizing-viewports"><span class="secno">11.1 </span>Resizing viewports</h3>
+  
+  <p>Whenever a <a href="#viewport">viewport</a> has its width or height changed (e.g. as a result of the user resizing the browser window, or zooming in, or an
+  <code>iframe</code> element's dimensions are changed), the user agent must <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#queue-a-task">queue a task</a> to
+  <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/infrastructure.html#concept-event-fire" title="concept-event-fire">fire</a> a <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/infrastructure.html#concept-events-trusted" title="concept-events-trusted">trusted</a> event named
+  <code>resize</code> that does not bubble and is not cancelable at the <code class="external"><a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#window">Window</a></code> object associated with that
+  <a href="#viewport">viewport</a>.
+  
+  <h3 id="scrolling"><span class="secno">11.2 </span>Scrolling</h3>
+  
+  <p>Whenever a <a href="#viewport">viewport</a> gets scrolled in response to user interaction, the user agent must <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#queue-a-task">queue a task</a> to
+  <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/infrastructure.html#concept-event-fire" title="concept-event-fire">fire</a> a <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/infrastructure.html#concept-events-trusted" title="concept-events-trusted">trusted</a> event named
+  <code><a href="#widl-Window-scroll">scroll</a></code> that bubbles but is not cancelable at the <code class="external"><a href="http://dom.spec.whatwg.org/#document">Document</a></code> object associated with that <a href="#viewport">viewport</a>.
+  
+  <p class="issue">Do viewports have associated documents?</p>
+  
+  <p>Whenever an element gets scrolled in response to user interaction, the user agent must <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#queue-a-task">queue a task</a> to
+  <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/infrastructure.html#concept-event-fire" title="concept-event-fire">fire</a> a <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/infrastructure.html#concept-events-trusted" title="concept-events-trusted">trusted</a> event named
+  <code><a href="#widl-Window-scroll">scroll</a></code> that does not bubble and is not cancelable at the element.
+  
+  <p class="issue">Should we specify that scroll events can be throttled (e.g. in a smooth scroll)?</p>
+  
 <h2 class="no-num" id="references">References</h2>
 <h3 class="no-num" id="normative-references">Normative references</h3>
 <div id="anolis-references-normative"><dl><dt id="refsCSSOM">[CSSOM]

cssom-view/cssom-view-source

@@ -384,7 +384,31 @@ out of memory, or to work around platform-specific limitations.
   <h3 id="the-clientrect-interface">The <code title>ClientRect</code> Interface</h3>
 
   <!--{@idl(ClientRect)}-->
-
+  
+  <h2>Events</h2>
+  
+  <h3>Resizing viewports</h3>
+  
+  <p>Whenever a <span>viewport</span> has its width or height changed (e.g. as a result of the user resizing the browser window, or zooming in, or an
+  <code>iframe</code> element's dimensions are changed), the user agent must <span data-anolis-spec=html>queue a task</span> to
+  <span data-anolis-spec=html title=concept-event-fire>fire</span> a <span data-anolis-spec=html title=concept-events-trusted>trusted</span> event named
+  <code>resize</code> that does not bubble and is not cancelable at the <code data-anolis-spec=html>Window</code> object associated with that
+  <span>viewport</span>.
+  
+  <h3>Scrolling</h3>
+  
+  <p>Whenever a <span>viewport</span> gets scrolled in response to user interaction, the user agent must <span data-anolis-spec=html>queue a task</span> to
+  <span data-anolis-spec=html title=concept-event-fire>fire</span> a <span data-anolis-spec=html title=concept-events-trusted>trusted</span> event named
+  <code>scroll</code> that bubbles but is not cancelable at the <code data-anolis-spec=dom>Document</code> object associated with that <span>viewport</span>.
+  
+  <p class=issue>Do viewports have associated documents?</p>
+  
+  <p>Whenever an element gets scrolled in response to user interaction, the user agent must <span data-anolis-spec=html>queue a task</span> to
+  <span data-anolis-spec=html title=concept-event-fire>fire</span> a <span data-anolis-spec=html title=concept-events-trusted>trusted</span> event named
+  <code>scroll</code> that does not bubble and is not cancelable at the element.
+  
+  <p class=issue>Should we specify that scroll events can be throttled (e.g. in a smooth scroll)?</p>
+  
 <h2 class=no-num>References</h2>
 <h3 class=no-num>Normative references</h3>
 <div id=anolis-references-normative></div>