[css-regions] timing for regionLayoutUpdate event
authorAlan Stearns <stearns@adobe.com>
Thu, 04 Oct 2012 16:22:48 -0700
changeset 6816d5407e5d40c8
parent 6815 39dafac3efc5
child 6817 afc7818f1791
[css-regions] timing for regionLayoutUpdate event
css3-regions/Overview.html
css3-regions/Overview.src.html
     1.1 --- a/css3-regions/Overview.html	Thu Oct 04 13:41:14 2012 -0700
     1.2 +++ b/css3-regions/Overview.html	Thu Oct 04 16:22:48 2012 -0700
     1.3 @@ -10,12 +10,12 @@
     1.4    <link href="http://purl.org/dc/terms/" rel=schema.DC>
     1.5    <meta content="CSS Regions Module Level 3" name=DC.title>
     1.6    <meta content=text name=DC.type>
     1.7 -  <meta content=2012-10-02 name=DC.issued>
     1.8 +  <meta content=2012-10-04 name=DC.issued>
     1.9    <meta content="Vincent Hardy" name=DC.creator>
    1.10    <meta content="Alex Mogilevsky" name=DC.creator>
    1.11    <meta content="Alan Stearns" name=DC.creator>
    1.12    <meta content=W3C name=DC.publisher>
    1.13 -  <meta content="http://www.w3.org/TR/2012/ED-css3-regions-20121002/"
    1.14 +  <meta content="http://www.w3.org/TR/2012/ED-css3-regions-20121004/"
    1.15     name=DC.identifier>
    1.16    <link href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright"
    1.17     rel=DC.rights>
    1.18 @@ -50,13 +50,13 @@
    1.19  
    1.20     <h1 id=css-regions-module>CSS Regions Module Level 3</h1>
    1.21  
    1.22 -   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 2 October 2012</h2>
    1.23 +   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 4 October 2012</h2>
    1.24  
    1.25     <dl>
    1.26      <dt>This version:
    1.27  
    1.28      <dd><a
    1.29 -     href="http://www.w3.org/TR/2012/ED-css3-regions-20121002/">http://www.w3.org/csswg/css3-regions</a>
    1.30 +     href="http://www.w3.org/TR/2012/ED-css3-regions-20121004/">http://www.w3.org/csswg/css3-regions</a>
    1.31  
    1.32      <dt>Latest version:
    1.33  
    1.34 @@ -1388,14 +1388,6 @@
    1.35    <p>Only a limited list of properties can be set in a region style rule:
    1.36  
    1.37    <div class="issue-marker wrapper">
    1.38 -   <div class=issue-marker data-bug_id=15190 data-bug_status=NEW> <a
    1.39 -    href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15190">Issue-15190</a>
    1.40 -
    1.41 -    <div class=issue-details>
    1.42 -     <p class=short-desc>List of region style properties
    1.43 -    </div>
    1.44 -   </div>
    1.45 -
    1.46     <div class=issue-marker data-bug_id=16921 data-bug_status=REOPENED> <a
    1.47      href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=16921">Issue-16921</a>
    1.48  
    1.49 @@ -2216,8 +2208,10 @@
    1.50     are <a
    1.51     href="http://www.w3.org/TR/dom/#interface-eventtarget">EventTargets</a>
    1.52     which dispatch <code class=idl>regionLayoutUpdate</code> events when there
    1.53 -   is a possible layout change in their region chain. Note that the event is
    1.54 -   asynchronous.
    1.55 +   is a possible layout change in their region chain. The event is
    1.56 +   asynchronous, and fires when <a
    1.57 +   href="http://www.w3.org/TR/2012/WD-dom-20120405/#mutation-observers">MutationObservers</a>
    1.58 +   <a href="#DOM" rel=biblioentry>[DOM]<!--{{!DOM}}--></a> are invoked.
    1.59  
    1.60    <p>If region chain nesting occurs (the contents of a <a
    1.61     href="#dom-named-flow"><code class=idl>NamedFlow</code></a> contains
    1.62 @@ -2227,17 +2221,6 @@
    1.63     dispatched before the <code class=idl>regionLayoutUpdate</code> event for
    1.64     the containing flow is dispatched.
    1.65  
    1.66 -  <div class=issue-marker data-bug_id=16391 data-bug_status=ASSIGNED> <a
    1.67 -   href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=16391">Issue-16391</a>
    1.68 -
    1.69 -   <div class=issue-details>
    1.70 -    <p class=short-desc>regionLayoutUpdate needs to be async
    1.71 -   </div>
    1.72 -  </div>
    1.73 -
    1.74 -  <div class=note>The remaining issue in this bug is when the event gets
    1.75 -   fired.</div>
    1.76 -
    1.77    <table border=0 cellpadding=2 cellspacing=0 class=event-desc
    1.78     summary="This table contains information about the semantics of the given event type">
    1.79     <tbody>
    1.80 @@ -2791,8 +2774,9 @@
    1.81    <h2 id=usecases><span class=secno>10. </span>Use Cases</h2>
    1.82  
    1.83    <p>Use cases are described on <a
    1.84 -   href="http://wiki.csswg.org/spec/css3-regions/regions-use-cases">this
    1.85 -   page</a>.
    1.86 +   href="http://wiki.csswg.org/spec/css3-regions/regions-use-cases">these</a>
    1.87 +   <a
    1.88 +   href="http://wiki.csswg.org/spec/css3-regions/regions-print-use-cases">pages</a>.
    1.89  
    1.90    <h2 id=conformance><span class=secno>11. </span>Conformance</h2>
    1.91  
    1.92 @@ -2803,6 +2787,11 @@
    1.93     28<sup>th</sup> 2012</a> version</h3>
    1.94  
    1.95    <ul>
    1.96 +   <li>Added timing for regionLayoutUpdate event
    1.97 +
    1.98 +   <li>Clarified interaction between content and flow-from for
    1.99 +    pseudo-elements
   1.100 +
   1.101     <li>Changed NamedFlowCollection getters to return undefined when there is
   1.102      no NamedFlow.
   1.103  
     2.1 --- a/css3-regions/Overview.src.html	Thu Oct 04 13:41:14 2012 -0700
     2.2 +++ b/css3-regions/Overview.src.html	Thu Oct 04 16:22:48 2012 -0700
     2.3 @@ -1243,14 +1243,6 @@
     2.4      <p>Only a limited list of properties can be set in a region style rule:</p>
     2.5      
     2.6      <div class="issue-marker wrapper">
     2.7 -    <div class="issue-marker" data-bug_id="15190" data-bug_status="NEW">
     2.8 -        <a href=
     2.9 -        "https://www.w3.org/Bugs/Public/show_bug.cgi?id=15190">Issue-15190</a>
    2.10 -
    2.11 -        <div class="issue-details">
    2.12 -            <p class="short-desc">List of region style properties</p>
    2.13 -        </div>
    2.14 -    </div>
    2.15      <div class="issue-marker" data-bug_id="16921" data-bug_status="REOPENED">
    2.16          <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=16921">Issue-16921</a>
    2.17          <div class="issue-details">
    2.18 @@ -2001,9 +1993,11 @@
    2.19        which dispatch <code class="idl">regionLayoutUpdate</code> events 
    2.20        when there is a possible layout change 
    2.21        in their region chain. 
    2.22 -      Note that the event is asynchronous.</p>
    2.23 -
    2.24 -    <p>If region chain nesting occurs 
    2.25 +      The event is asynchronous, 
    2.26 +      and fires when 
    2.27 +      <a href="http://www.w3.org/TR/2012/WD-dom-20120405/#mutation-observers">MutationObservers</a> 
    2.28 +       [[!DOM]] are invoked.</p> 
    2.29 +    <p>If region chain nesting occurs
    2.30        (the contents of a <a href="#dom-named-flow"><code class="idl">NamedFlow</code></a> 
    2.31        contains regions 
    2.32        for a different <a href="#dom-named-flow"><code class="idl">NamedFlow</code></a>)
    2.33 @@ -2014,14 +2008,6 @@
    2.34        for the containing flow 
    2.35        is dispatched.</p>
    2.36      
    2.37 -    <div class="issue-marker" data-bug_id="16391" data-bug_status="ASSIGNED">
    2.38 -    <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=16391">Issue-16391</a>
    2.39 -    <div class="issue-details">
    2.40 -        <p class="short-desc">regionLayoutUpdate needs to be async</p>
    2.41 -    </div>  
    2.42 -    </div>
    2.43 -    <div class="note">The remaining issue in this bug is when the event gets fired.</div>
    2.44 -
    2.45      <table class="event-desc" border="0" summary="This table contains information about the semantics of the given event type" cellpadding="2" cellspacing="0">
    2.46                  <tbody><tr class="assert must"><th>Type</th>
    2.47                  <td class="eventname"><strong><code>regionLayoutUpdate</code></strong></td></tr>
    2.48 @@ -2435,8 +2421,9 @@
    2.49      
    2.50      <h2 id="usecases">Use Cases</h2>
    2.51      
    2.52 -    <p>Use cases are described on <a href="http://wiki.csswg.org/spec/css3-regions/regions-use-cases">this
    2.53 -            page</a>.</p>
    2.54 +    <p>Use cases are described on 
    2.55 +      <a href="http://wiki.csswg.org/spec/css3-regions/regions-use-cases">these</a> 
    2.56 +      <a href="http://wiki.csswg.org/spec/css3-regions/regions-print-use-cases">pages</a>.</p>
    2.57  
    2.58      <h2 id="conformance">Conformance</h2>
    2.59      
    2.60 @@ -2445,6 +2432,8 @@
    2.61      <h3 id="changes_from_Aug_28_2012">Changes from <a href="http://www.w3.org/TR/2012/WD-css3-regions-20120823/">August 28<sup>th</sup> 2012</a> version</h3>
    2.62  
    2.63      <ul>
    2.64 +      <li>Added timing for regionLayoutUpdate event</li>
    2.65 +      <li>Clarified interaction between content and flow-from for pseudo-elements</li>
    2.66        <li>Changed NamedFlowCollection getters to return undefined when there is no NamedFlow.</li>
    2.67        <li>Changed region-overflow property to region-fragment.</li>
    2.68      </ul>