added CSSRegionStyleRule to OM section
authorAlan Stearns <stearns@adobe.com>
Mon, 23 Apr 2012 22:27:12 -0700
changeset 55982e04f2d16ef5
parent 5597 647ff846ad7f
child 5599 c76a4ff42fc3
added CSSRegionStyleRule to OM section
css3-regions/Overview.html
css3-regions/Overview.src.html
     1.1 --- a/css3-regions/Overview.html	Mon Apr 23 18:29:57 2012 -0700
     1.2 +++ b/css3-regions/Overview.html	Mon Apr 23 22:27:12 2012 -0700
     1.3 @@ -35,13 +35,13 @@
     1.4  
     1.5     <h1 id=css-regions-module>CSS Regions Module Level 3</h1>
     1.6  
     1.7 -   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 23 April 2012</h2>
     1.8 +   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 24 April 2012</h2>
     1.9  
    1.10     <dl>
    1.11      <dt>This version:
    1.12  
    1.13      <dd><a
    1.14 -     href="http://www.w3.org/TR/2012/ED-css3-regions-20120423/">http://www.w3.org/csswg/css3-regions</a>
    1.15 +     href="http://www.w3.org/TR/2012/ED-css3-regions-20120424/">http://www.w3.org/csswg/css3-regions</a>
    1.16  
    1.17      <dt>Latest version:
    1.18  
    1.19 @@ -224,18 +224,21 @@
    1.20       <li><a href="#the-region-interface"><span class=secno>6.2. </span>The
    1.21        Region interface</a>
    1.22  
    1.23 -     <li><a href="#region-flow-layout-events"><span class=secno>6.3.
    1.24 +     <li><a href="#region-style-rule-interface"><span class=secno>6.3.
    1.25 +      </span>The CSSRegionStyleRule interface</a>
    1.26 +
    1.27 +     <li><a href="#region-flow-layout-events"><span class=secno>6.4.
    1.28        </span>Region flow layout events</a>
    1.29  
    1.30 -     <li><a href="#cssomview-and-regions"><span class=secno>6.4.
    1.31 +     <li><a href="#cssomview-and-regions"><span class=secno>6.5.
    1.32        </span>Clarifications on pre-existing APIs</a>
    1.33        <ul class=toc>
    1.34         <li><a
    1.35          href="#cssomview-getclientrects-and-getboundingclientrect"><span
    1.36 -        class=secno>6.4.1. </span><code class=idl>getClientRects()</code> and
    1.37 +        class=secno>6.5.1. </span><code class=idl>getClientRects()</code> and
    1.38          <code>getBoundingClientRects()</code></a>
    1.39  
    1.40 -       <li><a href="#cssomview-offset-attributes"><span class=secno>6.4.2.
    1.41 +       <li><a href="#cssomview-offset-attributes"><span class=secno>6.5.2.
    1.42          </span><code class=idl>offsetTop</code>, <code
    1.43          class=idl>offsetLeft</code>, <code class=idl>offsetWidth</code> and
    1.44          <code class=idl>offsetWidth</code></a>
    1.45 @@ -1353,13 +1356,6 @@
    1.46    <h3 id=the-at-region-style-rule><span class=secno>3.5. </span>The @region
    1.47     rule</h3>
    1.48  
    1.49 -  <div class=issue-marker data-bug_id=15116 data-bug_status=NEW> <a
    1.50 -   href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15116">Bug-15116</a>
    1.51 -   <div class=issue-details>
    1.52 -    <p class=short-desc>Add CSS OM Interface for @region style rules</p>
    1.53 -   </div>
    1.54 -  </div>
    1.55 -
    1.56    <p>An &lsquo;<a href="#css-region"><code
    1.57     class=css>@region</code></a>&rsquo; rule contains style declarations
    1.58     specific to particular regions.
    1.59 @@ -2093,14 +2089,90 @@
    1.60     href="http://www.w3.org/TR/dom/#dom-domexception-invalid_access_err"><code
    1.61     class=idl>INVALID_ACCESS_ERR</code></a> error code.
    1.62  
    1.63 -  <div class=issue-marker data-bug_id=15952 data-bug_status=ASSIGNED> <a
    1.64 -   href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15952">Bug-15952</a>
    1.65 -   <div class=issue-details>
    1.66 -    <p class=short-desc>CSSOM section should define REGIONS_RULE on CSSRule</p>
    1.67 -   </div>
    1.68 -  </div>
    1.69 -
    1.70 -  <h3 id=region-flow-layout-events><span class=secno>6.3. </span>Region flow
    1.71 +  <h3 id=region-style-rule-interface><span class=secno>6.3. </span>The
    1.72 +   CSSRegionStyleRule interface</h3>
    1.73 +
    1.74 +  <p>The CSSRegionStyleRule interface represents an &lsquo;<a
    1.75 +   href="#css-region"><code class=css>@region</code></a>&rsquo; rule in a CSS
    1.76 +   style sheet. This rule type is added to the <a
    1.77 +   href="http://dev.w3.org/csswg/cssom/#cssrule"><code>CSSRule</code></a> <a
    1.78 +   href="#CSSOM" rel=biblioentry>[CSSOM]<!--{{!CSSOM}}--></a> interface.
    1.79 +
    1.80 +  <pre class=idl>
    1.81 +partial interface CSSRule {
    1.82 +  const unsigned short REGION_STYLE_RULE = 1001;
    1.83 +}
    1.84 +</pre>
    1.85 +
    1.86 +  <dl>
    1.87 +   <dt>REGION_STYLE_RULE
    1.88 +
    1.89 +   <dd>The rule is a CSSRegionStyleRule
    1.90 +  </dl>
    1.91 +
    1.92 +  <pre class=idl>
    1.93 +interface CSSRegionStyleRule : CSSRule {
    1.94 +  attribute DOMString selectorText;
    1.95 +  readonly attribute CSSRuleList cssRules;
    1.96 +  unsigned long insertRule(DOMString rule,  unsigned long index)
    1.97 +      raises(DOMException);
    1.98 +  void deleteRule(unsigned long index)
    1.99 +      raises(DOMException);
   1.100 +};
   1.101 +</pre>
   1.102 +
   1.103 +  <p>The <dfn id=region-style-rule-selectorText> <code
   1.104 +   class=idl>selectorText</code></dfn> attribute gets and sets the associated
   1.105 +   selector as defined in section <a
   1.106 +   href="http://dev.w3.org/csswg/cssom/#dom-cssstylerule-selectortext">6.4.3</a>
   1.107 +   of <a href="#CSSOM" rel=biblioentry>[CSSOM]<!--{{!CSSOM}}--></a>.
   1.108 +
   1.109 +  <p>The <dfn id=region-style-rule-cssRules> <code
   1.110 +   class=idl>cssRules</code></dfn> attribute must return a <a
   1.111 +   href="http://dev.w3.org/csswg/cssom/#cssrulelist"><code>CSSRuleList</code></a>
   1.112 +   <a href="#CSSOM" rel=biblioentry>[CSSOM]<!--{{!CSSOM}}--></a> object for
   1.113 +   the list of <a
   1.114 +   href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code
   1.115 +   class=idl>CSSStyleRules</code></a> specified in the region style block.
   1.116 +
   1.117 +  <p>The <dfn id=region-style-rule-insertRule> <code
   1.118 +   class=idl>insertRule(rule, index)</code></dfn> method inserts a <a
   1.119 +   href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code
   1.120 +   class=idl>CSSStyleRule</code></a> into the region style block before the
   1.121 +   specified index. If the index is equal to the length of the <a
   1.122 +   href="http://dev.w3.org/csswg/cssom/#cssrulelist"><code>CSSRuleList</code></a>
   1.123 +   the <a
   1.124 +   href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code
   1.125 +   class=idl>CSSStyleRule</code></a> is inserted at the end of the list.
   1.126 +
   1.127 +  <p>Possible exceptions:
   1.128 +
   1.129 +  <ul>
   1.130 +   <li>HIERARCHY_REQUEST_ERR: Raised if the rule to insert is not a <a
   1.131 +    href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code
   1.132 +    class=idl>CSSStyleRule</code></a>.
   1.133 +
   1.134 +   <li>INDEX_SIZE_ERR: Raised if the specified index is not a valid insertion
   1.135 +    point.
   1.136 +
   1.137 +   <li>SYNTAX_ERR: Raised if the specified rule has a syntax error and is
   1.138 +    unparsable.
   1.139 +  </ul>
   1.140 +
   1.141 +  <p>The <dfn id=region-style-rule-deleteRule> <code
   1.142 +   class=idl>deleteRule(index)</code></dfn> method deletes the <a
   1.143 +   href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code
   1.144 +   class=idl>CSSStyleRule</code></a> in the CSSRuleList at the specified
   1.145 +   index.
   1.146 +
   1.147 +  <p>Possible exceptions:
   1.148 +
   1.149 +  <ul>
   1.150 +   <li>INDEX_SIZE_ERR: Raised if the specified index does not correspond to a
   1.151 +    rule in the region style block.
   1.152 +  </ul>
   1.153 +
   1.154 +  <h3 id=region-flow-layout-events><span class=secno>6.4. </span>Region flow
   1.155     layout events</h3>
   1.156  
   1.157    <p><a href="#dom-named-flow"><code class=idl>NamedFlow</code></a> objects
   1.158 @@ -2171,11 +2243,11 @@
   1.159        </ul>
   1.160    </table>
   1.161  
   1.162 -  <h3 id=cssomview-and-regions><span class=secno>6.4. </span>Clarifications
   1.163 +  <h3 id=cssomview-and-regions><span class=secno>6.5. </span>Clarifications
   1.164     on pre-existing APIs</h3>
   1.165  
   1.166    <h4 id=cssomview-getclientrects-and-getboundingclientrect><span
   1.167 -   class=secno>6.4.1. </span><code class=idl>getClientRects()</code> and
   1.168 +   class=secno>6.5.1. </span><code class=idl>getClientRects()</code> and
   1.169     <code>getBoundingClientRects()</code></h4>
   1.170  
   1.171    <p>The <a href="http://www.w3.org/TR/cssom-view/">CSSOM View Module</a>
   1.172 @@ -2192,7 +2264,7 @@
   1.173     well and is computed from the set of rectangles returned by <code
   1.174     class=idl>getClientRects()</code>.
   1.175  
   1.176 -  <h4 id=cssomview-offset-attributes><span class=secno>6.4.2. </span><code
   1.177 +  <h4 id=cssomview-offset-attributes><span class=secno>6.5.2. </span><code
   1.178     class=idl>offsetTop</code>, <code class=idl>offsetLeft</code>, <code
   1.179     class=idl>offsetWidth</code> and <code class=idl>offsetWidth</code></h4>
   1.180  
   1.181 @@ -2824,6 +2896,8 @@
   1.182     <li>Added opacity to region styling.
   1.183  
   1.184     <li>Added possibility of ::before content contributing to overflow.
   1.185 +
   1.186 +   <li>Added CSSRegionStyleRule
   1.187    </ul>
   1.188  
   1.189    <h3 id="changes_from_June_09_2011"><span class=secno>12.2. </span>Changes
   1.190 @@ -3319,6 +3393,15 @@
   1.191      </dd>
   1.192     <!---->
   1.193  
   1.194 +   <dt id=CSSOM>[CSSOM]
   1.195 +
   1.196 +   <dd>Anne van Kesteren. <a
   1.197 +    href="http://www.w3.org/TR/2011/WD-cssom-20110712/"><cite>CSSOM.</cite></a>
   1.198 +    12 July 2011. W3C Working Draft. (Work in progress.) URL: <a
   1.199 +    href="http://www.w3.org/TR/2011/WD-cssom-20110712/">http://www.w3.org/TR/2011/WD-cssom-20110712/</a>
   1.200 +    </dd>
   1.201 +   <!---->
   1.202 +
   1.203     <dt id=DOM>[DOM]
   1.204  
   1.205     <dd>Anne van Kesteren; Aryeh Gregor; Ms2ger. <a
   1.206 @@ -3451,9 +3534,18 @@
   1.207     <li>break-inside, <a href="#break-inside"
   1.208      title=break-inside><strong>3.3.</strong></a>
   1.209  
   1.210 +   <li><a href="#region-style-rule-cssRules"><code
   1.211 +    class=idl>cssRules</code></a>, <a href="#region-style-rule-cssRules"
   1.212 +    title=cssRules><strong>6.3.</strong></a>
   1.213 +
   1.214     <li>current-region, <a href="#current-region"
   1.215      title=current-region><strong>2.4.</strong></a>
   1.216  
   1.217 +   <li><a href="#region-style-rule-deleteRule"><code
   1.218 +    class=idl>deleteRule(index)</code></a>, <a
   1.219 +    href="#region-style-rule-deleteRule"
   1.220 +    title="deleteRule(index)"><strong>6.3.</strong></a>
   1.221 +
   1.222     <li>firstEmptyRegionIndex, <a
   1.223      href="#dom-named-flow-first-empty-region-index"
   1.224      title=firstEmptyRegionIndex><strong>6.1.</strong></a>
   1.225 @@ -3485,6 +3577,11 @@
   1.226      href="#dom-named-flow-get-regions-by-content"
   1.227      title="getRegionsByContent()"><strong>6.1.</strong></a>
   1.228  
   1.229 +   <li><a href="#region-style-rule-insertRule"><code
   1.230 +    class=idl>insertRule(rule, index)</code></a>, <a
   1.231 +    href="#region-style-rule-insertRule"
   1.232 +    title="insertRule(rule, index)"><strong>6.3.</strong></a>
   1.233 +
   1.234     <li><a href="#dom-named-flow-collection-item"><code
   1.235      class=idl>item(index)</code></a>, <a
   1.236      href="#dom-named-flow-collection-item"
   1.237 @@ -3532,6 +3629,11 @@
   1.238      class=idl>regionOverset</code></a>, <a href="#dom-region-regionoverset"
   1.239      title=regionOverset><strong>6.2.</strong></a>
   1.240  
   1.241 +   <li><a href="#region-style-rule-selectorText"><code
   1.242 +    class=idl>selectorText</code></a>, <a
   1.243 +    href="#region-style-rule-selectorText"
   1.244 +    title=selectorText><strong>6.3.</strong></a>
   1.245 +
   1.246     <li>specified flow, <a href="#specified-flow"
   1.247      title="specified flow"><strong>3.1.</strong></a>
   1.248    </ul>
     2.1 --- a/css3-regions/Overview.src.html	Mon Apr 23 18:29:57 2012 -0700
     2.2 +++ b/css3-regions/Overview.src.html	Mon Apr 23 22:27:12 2012 -0700
     2.3 @@ -1198,13 +1198,6 @@
     2.4      </div>
     2.5  
     2.6      <h3 id="the-at-region-style-rule">The @region rule</h3>
     2.7 -
     2.8 -    <div class="issue-marker" data-bug_id="15116" data-bug_status="NEW">
     2.9 -        <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15116">Bug-15116</a>
    2.10 -        <div class="issue-details">
    2.11 -            <p class="short-desc">Add CSS OM Interface for @region style rules</p>
    2.12 -        </div>  
    2.13 -    </div>
    2.14      
    2.15      <p>An '@region' rule contains style declarations specific to particular
    2.16      regions.</p>
    2.17 @@ -1852,14 +1845,85 @@
    2.18          method throws a <a href="http://www.w3.org/TR/dom/#interface-domexception"><code class="idl">DOMException</code></a> with the 
    2.19          <a href="http://www.w3.org/TR/dom/#dom-domexception-invalid_access_err"><code class="idl">INVALID_ACCESS_ERR</code></a> error code.</p>  
    2.20          </div>
    2.21 -    
    2.22 -    <div class="issue-marker" data-bug_id="15952" data-bug_status="ASSIGNED">
    2.23 -    <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15952">Bug-15952</a>
    2.24 -    <div class="issue-details">
    2.25 -        <p class="short-desc">CSSOM section should define REGIONS_RULE on CSSRule</p>
    2.26 -    </div>  
    2.27 -    </div>
    2.28 -    
    2.29 +
    2.30 +    <h3 id="region-style-rule-interface">The CSSRegionStyleRule interface</h3>
    2.31 +
    2.32 +    <p>The CSSRegionStyleRule interface represents 
    2.33 +      an '@region' rule 
    2.34 +      in a CSS style sheet. 
    2.35 +      This rule type is added 
    2.36 +      to the <a href="http://dev.w3.org/csswg/cssom/#cssrule"><code>CSSRule</code></a> [[!CSSOM]] interface.</p>
    2.37 +
    2.38 +    <pre class="idl">
    2.39 +partial interface CSSRule {
    2.40 +  const unsigned short REGION_STYLE_RULE = 1001;
    2.41 +}
    2.42 +</pre>
    2.43 +    <dt>REGION_STYLE_RULE</dt>
    2.44 +    <dd>The rule is a CSSRegionStyleRule</dd>
    2.45 +
    2.46 +    <pre class="idl">
    2.47 +interface CSSRegionStyleRule : CSSRule {
    2.48 +  attribute DOMString selectorText;
    2.49 +  readonly attribute CSSRuleList cssRules;
    2.50 +  unsigned long insertRule(DOMString rule,  unsigned long index)
    2.51 +      raises(DOMException);
    2.52 +  void deleteRule(unsigned long index)
    2.53 +      raises(DOMException);
    2.54 +};
    2.55 +</pre>
    2.56 +
    2.57 +    <p>The <dfn id="region-style-rule-selectorText">
    2.58 +      <code class="idl">selectorText</code></dfn> 
    2.59 +      attribute gets and sets 
    2.60 +      the associated selector 
    2.61 +      as defined in section <a href="http://dev.w3.org/csswg/cssom/#dom-cssstylerule-selectortext">6.4.3</a> of [[!CSSOM]].
    2.62 +
    2.63 +    <p>The <dfn id="region-style-rule-cssRules">
    2.64 +      <code class="idl">cssRules</code></dfn> 
    2.65 +      attribute must return a 
    2.66 +      <a href="http://dev.w3.org/csswg/cssom/#cssrulelist"><code>CSSRuleList</code></a> [[!CSSOM]] 
    2.67 +      object for the list of 
    2.68 +      <a href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code class="idl">CSSStyleRules</code></a> 
    2.69 +      specified in the region style block.</p>
    2.70 +
    2.71 +    <p>The <dfn id="region-style-rule-insertRule">
    2.72 +      <code class="idl">insertRule(rule, index)</code></dfn> 
    2.73 +      method inserts a 
    2.74 +      <a href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code class="idl">CSSStyleRule</code></a> 
    2.75 +      into the region style block 
    2.76 +      before the specified index. 
    2.77 +      If the index is equal to the length 
    2.78 +      of the <a href="http://dev.w3.org/csswg/cssom/#cssrulelist"><code>CSSRuleList</code></a> the 
    2.79 +      <a href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code class="idl">CSSStyleRule</code></a> 
    2.80 +      is inserted at the end of the list.</p>
    2.81 +
    2.82 +    <p>Possible exceptions:</p>
    2.83 +    <ul>
    2.84 +      <li>HIERARCHY_REQUEST_ERR: 
    2.85 +        Raised if the rule to insert is not a 
    2.86 +        <a href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code class="idl">CSSStyleRule</code></a>.</li>
    2.87 +      <li>INDEX_SIZE_ERR: 
    2.88 +        Raised if the specified index 
    2.89 +        is not a valid insertion point.</li>
    2.90 +      <li>SYNTAX_ERR: 
    2.91 +        Raised if the specified rule 
    2.92 +        has a syntax error 
    2.93 +        and is unparsable.</li>
    2.94 +    </ul>
    2.95 +    <p>The <dfn id="region-style-rule-deleteRule">
    2.96 +      <code class="idl">deleteRule(index)</code></dfn> 
    2.97 +      method deletes the <a href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code class="idl">CSSStyleRule</code></a> in the CSSRuleList 
    2.98 +      at the specified index.</p>
    2.99 +
   2.100 +    <p>Possible exceptions:</p>
   2.101 +    <ul>
   2.102 +      <li>INDEX_SIZE_ERR: 
   2.103 +        Raised if the specified index 
   2.104 +        does not correspond to a rule 
   2.105 +        in the region style block.</li>
   2.106 +    </ul>
   2.107 +
   2.108      <h3 id="region-flow-layout-events">Region flow layout events</h3>
   2.109  
   2.110      <p><a href="#dom-named-flow"><code class="idl">NamedFlow</code></a> objects are
   2.111 @@ -2355,6 +2419,7 @@
   2.112          <li>Changed break and region-overflow properties to apply to visual media instead of paged.</li>
   2.113          <li>Added opacity to region styling.</li>
   2.114          <li>Added possibility of ::before content contributing to overflow.</li>
   2.115 +        <li>Added CSSRegionStyleRule</li>
   2.116      </ul>
   2.117      
   2.118