# HG changeset patch # User Alan Stearns # Date 1335245232 25200 # Node ID 2e04f2d16ef5e30c6ecfb33ed9710808edb396e7 # Parent 647ff846ad7f36dbd725755176c4e6e0405e59b0 added CSSRegionStyleRule to OM section diff -r 647ff846ad7f -r 2e04f2d16ef5 css3-regions/Overview.html --- a/css3-regions/Overview.html Mon Apr 23 18:29:57 2012 -0700 +++ b/css3-regions/Overview.html Mon Apr 23 22:27:12 2012 -0700 @@ -35,13 +35,13 @@

CSS Regions Module Level 3

-

Editor's Draft 23 April 2012

+

Editor's Draft 24 April 2012

This version:
http://www.w3.org/csswg/css3-regions + href="http://www.w3.org/TR/2012/ED-css3-regions-20120424/">http://www.w3.org/csswg/css3-regions
Latest version: @@ -224,18 +224,21 @@
  • 6.2. The Region interface -
  • 6.3. +
  • 6.3. + The CSSRegionStyleRule interface + +
  • 6.4. Region flow layout events -
  • 6.4. +
  • 6.5. Clarifications on pre-existing APIs
    • 6.4.1. getClientRects() and + class=secno>6.5.1. getClientRects() and getBoundingClientRects() -
    • 6.4.2. +
    • 6.5.2. offsetTop, offsetLeft, offsetWidth and offsetWidth @@ -1353,13 +1356,6 @@

      3.5. The @region rule

      -
      Bug-15116 -
      -

      Add CSS OM Interface for @region style rules

      -
      -
      -

      An ‘@region’ rule contains style declarations specific to particular regions. @@ -2093,14 +2089,90 @@ href="http://www.w3.org/TR/dom/#dom-domexception-invalid_access_err">INVALID_ACCESS_ERR error code. -

      Bug-15952 -
      -

      CSSOM section should define REGIONS_RULE on CSSRule

      -
      -
      - -

      6.3. Region flow +

      6.3. The + CSSRegionStyleRule interface

      + +

      The CSSRegionStyleRule interface represents an ‘@region’ rule in a CSS + style sheet. This rule type is added to the CSSRule [CSSOM] interface. + + 

      +partial interface CSSRule {
+  const unsigned short REGION_STYLE_RULE = 1001;
+}
+
      + +
      +
      REGION_STYLE_RULE + +
      The rule is a CSSRegionStyleRule +
      + + 
      +interface CSSRegionStyleRule : CSSRule {
+  attribute DOMString selectorText;
+  readonly attribute CSSRuleList cssRules;
+  unsigned long insertRule(DOMString rule,  unsigned long index)
+      raises(DOMException);
+  void deleteRule(unsigned long index)
+      raises(DOMException);
+};
+
      + +

      The selectorText attribute gets and sets the associated + selector as defined in section 6.4.3 + of [CSSOM]. + +

      The cssRules attribute must return a CSSRuleList + [CSSOM] object for + the list of CSSStyleRules specified in the region style block. + +

      The insertRule(rule, index) method inserts a CSSStyleRule into the region style block before the + specified index. If the index is equal to the length of the CSSRuleList + the CSSStyleRule is inserted at the end of the list. + +

      Possible exceptions: + +

        +
      • HIERARCHY_REQUEST_ERR: Raised if the rule to insert is not a CSSStyleRule. + +
      • INDEX_SIZE_ERR: Raised if the specified index is not a valid insertion + point. + +
      • SYNTAX_ERR: Raised if the specified rule has a syntax error and is + unparsable. +
      + +

      The deleteRule(index) method deletes the CSSStyleRule in the CSSRuleList at the specified + index. + +

      Possible exceptions: + +

        +
      • INDEX_SIZE_ERR: Raised if the specified index does not correspond to a + rule in the region style block. +
      + +

      6.4. Region flow layout events

      NamedFlow objects @@ -2171,11 +2243,11 @@

    -

    6.4. Clarifications +

    6.5. Clarifications on pre-existing APIs

    6.4.1. getClientRects() and + class=secno>6.5.1. getClientRects() and getBoundingClientRects()

    The CSSOM View Module @@ -2192,7 +2264,7 @@ well and is computed from the set of rectangles returned by getClientRects(). -

    6.4.2. 6.5.2. offsetTop, offsetLeft, offsetWidth and offsetWidth

    @@ -2824,6 +2896,8 @@
  • Added opacity to region styling.
  • Added possibility of ::before content contributing to overflow. + +
  • Added CSSRegionStyleRule

    12.2. Changes @@ -3319,6 +3393,15 @@ +
    [CSSOM] + +
    Anne van Kesteren. CSSOM. + 12 July 2011. W3C Working Draft. (Work in progress.) URL: http://www.w3.org/TR/2011/WD-cssom-20110712/ +
    + +
    [DOM]
    Anne van Kesteren; Aryeh Gregor; Ms2ger. break-inside, 3.3. +
  • cssRules, 6.3. +
  • current-region, 2.4. +
  • deleteRule(index), 6.3. +
  • firstEmptyRegionIndex, 6.1. @@ -3485,6 +3577,11 @@ href="#dom-named-flow-get-regions-by-content" title="getRegionsByContent()">6.1. +
  • insertRule(rule, index), 6.3. +
  • item(index), regionOverset, 6.2. +
  • selectorText, 6.3. +
  • specified flow, 3.1. diff -r 647ff846ad7f -r 2e04f2d16ef5 css3-regions/Overview.src.html --- a/css3-regions/Overview.src.html Mon Apr 23 18:29:57 2012 -0700 +++ b/css3-regions/Overview.src.html Mon Apr 23 22:27:12 2012 -0700 @@ -1198,13 +1198,6 @@

    The @region rule

    - -
    - Bug-15116 -
    -

    Add CSS OM Interface for @region style rules

    -
    -

    An '@region' rule contains style declarations specific to particular regions.

    @@ -1852,14 +1845,85 @@ method throws a DOMException with the INVALID_ACCESS_ERR error code.

    - -
    - Bug-15952 -
    -

    CSSOM section should define REGIONS_RULE on CSSRule

    -
    -
    - + +

    The CSSRegionStyleRule interface

    + +

    The CSSRegionStyleRule interface represents + an '@region' rule + in a CSS style sheet. + This rule type is added + to the CSSRule [[!CSSOM]] interface.

    + + 
    +partial interface CSSRule {
+  const unsigned short REGION_STYLE_RULE = 1001;
+}
+
    +
    REGION_STYLE_RULE
    +
    The rule is a CSSRegionStyleRule
    + + 
    +interface CSSRegionStyleRule : CSSRule {
+  attribute DOMString selectorText;
+  readonly attribute CSSRuleList cssRules;
+  unsigned long insertRule(DOMString rule,  unsigned long index)
+      raises(DOMException);
+  void deleteRule(unsigned long index)
+      raises(DOMException);
+};
+
    + +

    The + selectorText + attribute gets and sets + the associated selector + as defined in section 6.4.3 of [[!CSSOM]]. + +

    The + cssRules + attribute must return a + CSSRuleList [[!CSSOM]] + object for the list of + CSSStyleRules + specified in the region style block.

    + +

    The + insertRule(rule, index) + method inserts a + CSSStyleRule + into the region style block + before the specified index. + If the index is equal to the length + of the CSSRuleList the + CSSStyleRule + is inserted at the end of the list.

    + +

    Possible exceptions:

    +
      +
    • HIERARCHY_REQUEST_ERR: + Raised if the rule to insert is not a + CSSStyleRule.
      • +
    • INDEX_SIZE_ERR: + Raised if the specified index + is not a valid insertion point.
      • +
    • SYNTAX_ERR: + Raised if the specified rule + has a syntax error + and is unparsable.
      • +
    +

    The + deleteRule(index) + method deletes the CSSStyleRule in the CSSRuleList + at the specified index.

    + +

    Possible exceptions:

    +
      +
    • INDEX_SIZE_ERR: + Raised if the specified index + does not correspond to a rule + in the region style block.
      • +
    +

    Region flow layout events

    NamedFlow objects are @@ -2355,6 +2419,7 @@

  • Changed break and region-overflow properties to apply to visual media instead of paged.
  • Added opacity to region styling.
  • Added possibility of ::before content contributing to overflow.
    • +
  • Added CSSRegionStyleRule