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 ‘<a href="#css-region"><code
1.57 class=css>@region</code></a>’ 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 ‘<a
1.75 + href="#css-region"><code class=css>@region</code></a>’ 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>
