Mercurial > drafts / changeset

     1.1 --- a/cssom-view/Overview.html	Mon May 13 17:51:52 2013 -0700
     1.2 +++ b/cssom-view/Overview.html	Tue May 14 12:27:19 2013 +0200
     1.3 @@ -13,7 +13,7 @@
     1.4  
     1.5     <h1 id="cssom-view-module">CSSOM View Module</h1>
     1.6  
     1.7 -   <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 8 May 2013</h2>
     1.8 +   <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 14 May 2013</h2>
     1.9  
    1.10     <dl>
    1.11  
    1.12 @@ -69,7 +69,7 @@
    1.13     can be found in the <a href="http://www.w3.org/TR/">W3C technical reports
    1.14     index at http://www.w3.org/TR/.</a></em>
    1.15  
    1.16 -<p>This is the 8 May 2013 Editor's Draft of CSSOM View. Please send
    1.17 +<p>This is the 14 May 2013 Editor's Draft of CSSOM View. Please send
    1.18  comments to
    1.19  <a href="mailto:www-style@w3.org?subject=%5Bcssom-view%5D%20">www-style@w3.org</a>
    1.20  (<a href="http://lists.w3.org/Archives/Public/www-style/">archived</a>)
    1.21 @@ -126,6 +126,10 @@
    1.22    <ol class="toc">
    1.23     <li><a href="#the-clientrectlist-interface"><span class="secno">10.1 </span>The <code title="">ClientRectList</code> Interface</a></li>
    1.24     <li><a href="#the-clientrect-interface"><span class="secno">10.2 </span>The <code title="">ClientRect</code> Interface</a></ol></li>
    1.25 + <li><a href="#events"><span class="secno">11 </span>Events</a>
    1.26 +  <ol class="toc">
    1.27 +   <li><a href="#resizing-viewports"><span class="secno">11.1 </span>Resizing viewports</a></li>
    1.28 +   <li><a href="#scrolling"><span class="secno">11.2 </span>Scrolling</a></ol></li>
    1.29   <li><a class="no-num" href="#references">References</a>
    1.30    <ol class="toc">
    1.31     <li><a class="no-num" href="#normative-references">Normative references</a></ol></li>
    1.32 @@ -815,7 +819,31 @@
    1.33  <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>
    1.34  </dl>
    1.35  
    1.36 -
    1.37 +  
    1.38 +  <h2 id="events"><span class="secno">11 </span>Events</h2>
    1.39 +  
    1.40 +  <h3 id="resizing-viewports"><span class="secno">11.1 </span>Resizing viewports</h3>
    1.41 +  
    1.42 +  <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
    1.43 +  <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
    1.44 +  <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
    1.45 +  <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
    1.46 +  <a href="#viewport">viewport</a>.
    1.47 +  
    1.48 +  <h3 id="scrolling"><span class="secno">11.2 </span>Scrolling</h3>
    1.49 +  
    1.50 +  <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
    1.51 +  <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
    1.52 +  <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>.
    1.53 +  
    1.54 +  <p class="issue">Do viewports have associated documents?</p>
    1.55 +  
    1.56 +  <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
    1.57 +  <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
    1.58 +  <code><a href="#widl-Window-scroll">scroll</a></code> that does not bubble and is not cancelable at the element.
    1.59 +  
    1.60 +  <p class="issue">Should we specify that scroll events can be throttled (e.g. in a smooth scroll)?</p>
    1.61 +  
    1.62  <h2 class="no-num" id="references">References</h2>
    1.63  <h3 class="no-num" id="normative-references">Normative references</h3>
    1.64  <div id="anolis-references-normative"><dl><dt id="refsCSSOM">[CSSOM]

     2.1 --- a/cssom-view/cssom-view-source	Mon May 13 17:51:52 2013 -0700
     2.2 +++ b/cssom-view/cssom-view-source	Tue May 14 12:27:19 2013 +0200
     2.3 @@ -384,7 +384,31 @@
     2.4    <h3 id="the-clientrect-interface">The <code title>ClientRect</code> Interface</h3>
     2.5  
     2.6    <!--{@idl(ClientRect)}-->
     2.7 -
     2.8 +  
     2.9 +  <h2>Events</h2>
    2.10 +  
    2.11 +  <h3>Resizing viewports</h3>
    2.12 +  
    2.13 +  <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
    2.14 +  <code>iframe</code> element's dimensions are changed), the user agent must <span data-anolis-spec=html>queue a task</span> to
    2.15 +  <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
    2.16 +  <code>resize</code> that does not bubble and is not cancelable at the <code data-anolis-spec=html>Window</code> object associated with that
    2.17 +  <span>viewport</span>.
    2.18 +  
    2.19 +  <h3>Scrolling</h3>
    2.20 +  
    2.21 +  <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
    2.22 +  <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
    2.23 +  <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>.
    2.24 +  
    2.25 +  <p class=issue>Do viewports have associated documents?</p>
    2.26 +  
    2.27 +  <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
    2.28 +  <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
    2.29 +  <code>scroll</code> that does not bubble and is not cancelable at the element.
    2.30 +  
    2.31 +  <p class=issue>Should we specify that scroll events can be throttled (e.g. in a smooth scroll)?</p>
    2.32 +  
    2.33  <h2 class=no-num>References</h2>
    2.34  <h3 class=no-num>Normative references</h3>
    2.35  <div id=anolis-references-normative></div>