1.1 --- a/css3-regions/Overview.src.html Mon Apr 23 18:29:57 2012 -0700
1.2 +++ b/css3-regions/Overview.src.html Mon Apr 23 22:27:12 2012 -0700
1.3 @@ -1198,13 +1198,6 @@
1.4 </div>
1.5
1.6 <h3 id="the-at-region-style-rule">The @region rule</h3>
1.7 -
1.8 - <div class="issue-marker" data-bug_id="15116" data-bug_status="NEW">
1.9 - <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15116">Bug-15116</a>
1.10 - <div class="issue-details">
1.11 - <p class="short-desc">Add CSS OM Interface for @region style rules</p>
1.12 - </div>
1.13 - </div>
1.14
1.15 <p>An '@region' rule contains style declarations specific to particular
1.16 regions.</p>
1.17 @@ -1852,14 +1845,85 @@
1.18 method throws a <a href="http://www.w3.org/TR/dom/#interface-domexception"><code class="idl">DOMException</code></a> with the
1.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>
1.20 </div>
1.21 -
1.22 - <div class="issue-marker" data-bug_id="15952" data-bug_status="ASSIGNED">
1.23 - <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15952">Bug-15952</a>
1.24 - <div class="issue-details">
1.25 - <p class="short-desc">CSSOM section should define REGIONS_RULE on CSSRule</p>
1.26 - </div>
1.27 - </div>
1.28 -
1.29 +
1.30 + <h3 id="region-style-rule-interface">The CSSRegionStyleRule interface</h3>
1.31 +
1.32 + <p>The CSSRegionStyleRule interface represents
1.33 + an '@region' rule
1.34 + in a CSS style sheet.
1.35 + This rule type is added
1.36 + to the <a href="http://dev.w3.org/csswg/cssom/#cssrule"><code>CSSRule</code></a> [[!CSSOM]] interface.</p>
1.37 +
1.38 + <pre class="idl">
1.39 +partial interface CSSRule {
1.40 + const unsigned short REGION_STYLE_RULE = 1001;
1.41 +}
1.42 +</pre>
1.43 + <dt>REGION_STYLE_RULE</dt>
1.44 + <dd>The rule is a CSSRegionStyleRule</dd>
1.45 +
1.46 + <pre class="idl">
1.47 +interface CSSRegionStyleRule : CSSRule {
1.48 + attribute DOMString selectorText;
1.49 + readonly attribute CSSRuleList cssRules;
1.50 + unsigned long insertRule(DOMString rule, unsigned long index)
1.51 + raises(DOMException);
1.52 + void deleteRule(unsigned long index)
1.53 + raises(DOMException);
1.54 +};
1.55 +</pre>
1.56 +
1.57 + <p>The <dfn id="region-style-rule-selectorText">
1.58 + <code class="idl">selectorText</code></dfn>
1.59 + attribute gets and sets
1.60 + the associated selector
1.61 + as defined in section <a href="http://dev.w3.org/csswg/cssom/#dom-cssstylerule-selectortext">6.4.3</a> of [[!CSSOM]].
1.62 +
1.63 + <p>The <dfn id="region-style-rule-cssRules">
1.64 + <code class="idl">cssRules</code></dfn>
1.65 + attribute must return a
1.66 + <a href="http://dev.w3.org/csswg/cssom/#cssrulelist"><code>CSSRuleList</code></a> [[!CSSOM]]
1.67 + object for the list of
1.68 + <a href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code class="idl">CSSStyleRules</code></a>
1.69 + specified in the region style block.</p>
1.70 +
1.71 + <p>The <dfn id="region-style-rule-insertRule">
1.72 + <code class="idl">insertRule(rule, index)</code></dfn>
1.73 + method inserts a
1.74 + <a href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code class="idl">CSSStyleRule</code></a>
1.75 + into the region style block
1.76 + before the specified index.
1.77 + If the index is equal to the length
1.78 + of the <a href="http://dev.w3.org/csswg/cssom/#cssrulelist"><code>CSSRuleList</code></a> the
1.79 + <a href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code class="idl">CSSStyleRule</code></a>
1.80 + is inserted at the end of the list.</p>
1.81 +
1.82 + <p>Possible exceptions:</p>
1.83 + <ul>
1.84 + <li>HIERARCHY_REQUEST_ERR:
1.85 + Raised if the rule to insert is not a
1.86 + <a href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleRule"><code class="idl">CSSStyleRule</code></a>.</li>
1.87 + <li>INDEX_SIZE_ERR:
1.88 + Raised if the specified index
1.89 + is not a valid insertion point.</li>
1.90 + <li>SYNTAX_ERR:
1.91 + Raised if the specified rule
1.92 + has a syntax error
1.93 + and is unparsable.</li>
1.94 + </ul>
1.95 + <p>The <dfn id="region-style-rule-deleteRule">
1.96 + <code class="idl">deleteRule(index)</code></dfn>
1.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
1.98 + at the specified index.</p>
1.99 +
1.100 + <p>Possible exceptions:</p>
1.101 + <ul>
1.102 + <li>INDEX_SIZE_ERR:
1.103 + Raised if the specified index
1.104 + does not correspond to a rule
1.105 + in the region style block.</li>
1.106 + </ul>
1.107 +
1.108 <h3 id="region-flow-layout-events">Region flow layout events</h3>
1.109
1.110 <p><a href="#dom-named-flow"><code class="idl">NamedFlow</code></a> objects are
1.111 @@ -2355,6 +2419,7 @@
1.112 <li>Changed break and region-overflow properties to apply to visual media instead of paged.</li>
1.113 <li>Added opacity to region styling.</li>
1.114 <li>Added possibility of ::before content contributing to overflow.</li>
1.115 + <li>Added CSSRegionStyleRule</li>
1.116 </ul>
1.117
1.118
