Skip to content

Commit 7ef8348

Browse files
committed
removed exceptions from the Region interface
1 parent c20f821 commit 7ef8348

2 files changed

Lines changed: 31 additions & 29 deletions

File tree

css3-regions/Overview.html

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2035,7 +2035,9 @@ <h3 id=the-region-interface><span class=secno>6.2. </span>The Region
20352035
chain, that means the <a href="#named-flow0">named flow</a> content is
20362036
further fitted in subsequent regions. In this last case, note that the <a
20372037
href="#named-flow0">named flow</a> fragment may be empty (for example if
2038-
the region is too small to accommodate any content).
2038+
the region is too small to accommodate any content). This value is
2039+
returned if the <a href="#css-region">region</a> object is not (or no
2040+
longer) a region.
20392041

20402042
<dt><code class=property>empty</code>
20412043

@@ -2091,7 +2093,8 @@ <h3 id=the-region-interface><span class=secno>6.2. </span>The Region
20912093
fragmented across region boundaries, the <a
20922094
href="http://dev.w3.org/csswg/cssom/#cssstyledeclaration">CSSStyleDeclaration</a>
20932095
returned must apply only to the fragment that flows through the <span>CSS
2094-
Region</span>.
2096+
Region</span>. The method returns null if the <a
2097+
href="#css-region">region</a> object is not (or no longer) a region.
20952098

20962099
<div class=note>
20972100
<p>If the element is not contained in the <span>CSS Region</span> at all,
@@ -2109,14 +2112,7 @@ <h3 id=the-region-interface><span class=secno>6.2. </span>The Region
21092112
class=property>flow-from</code></a>’ property on the corresponding
21102113
pseudo-element, element or other construct becomes ‘<code
21112114
class=property>none</code>’ but a script is still holding a reference to
2112-
the <a href="#css-region"><code class=idl>Region</code></a> object. If a
2113-
<a href="#css-region"><code class=idl>Region</code></a> instance is no
2114-
longer a <a href="#css-region">region</a>, accessing its attributes or
2115-
invoking its methods throws a <a
2116-
href="http://www.w3.org/TR/dom/#exception-domexception"><code
2117-
class=idl>DOMException</code></a> with the <a
2118-
href="http://www.w3.org/TR/dom/#dom-domexception-invalid_access_err"><code
2119-
class=idl>INVALID_ACCESS_ERR</code></a> error code.
2115+
the <a href="#css-region"><code class=idl>Region</code></a> object.
21202116

21212117
<h3 id=region-style-rule-interface><span class=secno>6.3. </span>The
21222118
CSSRegionStyleRule interface</h3>
@@ -2817,6 +2813,8 @@ <h3 id="changes_from_May_03_2012"><span class=secno>12.1. </span>Changes
28172813
3<sup>rd</sup> 2012</a> version</h3>
28182814

28192815
<ul>
2816+
<li>Removed exceptions from the Region interface
2817+
28202818
<li>Changed NamedFlowCollection from live to a static snapshot
28212819

28222820
<li>Changed NamedFlow to inherit from EventTarget

css3-regions/Overview.src.html

Lines changed: 23 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1812,15 +1812,23 @@ <h3 id="the-region-interface">The Region interface</h3>
18121812

18131813
<dt>'fit'</dt>
18141814

1815-
<dd>The region's flow fragment content fits into the region's <a href=
1816-
"http://www.w3.org/TR/CSS21/box.html#box-dimensions">content box</a>.
1817-
If the region is the last one in the <span title=
1818-
"region-chain">region chain</span>, it means that the content fits
1819-
without overflowing. If the region is not the last one in the region
1820-
chain, that means the <span>named flow</span>
1821-
content is further fitted in subsequent regions. In this
1822-
last case, note that the <span>named flow</span> fragment may be
1823-
empty (for example if the region is too small to accommodate any content).</dd>
1815+
<dd>The region's flow fragment content
1816+
fits into the region's
1817+
<a href="http://www.w3.org/TR/CSS21/box.html#box-dimensions">content box</a>.
1818+
If the region is the last one
1819+
in the <span title="region-chain">region chain</span>,
1820+
it means that the content
1821+
fits without overflowing.
1822+
If the region is not the last one
1823+
in the region chain,
1824+
that means the <span>named flow</span> content
1825+
is further fitted in subsequent regions.
1826+
In this last case,
1827+
note that the <span>named flow</span> fragment may be empty
1828+
(for example if the region is too small
1829+
to accommodate any content).
1830+
This value is returned if the <span>region</span> object
1831+
is not (or no longer) a region.</dd>
18241832

18251833
<dt>'empty'</dt>
18261834

@@ -1883,7 +1891,10 @@ <h3 id="the-region-interface">The Region interface</h3>
18831891
If the element is fragmented across region boundaries,
18841892
the <a href="http://dev.w3.org/csswg/cssom/#cssstyledeclaration">CSSStyleDeclaration</a> returned must apply only
18851893
to the fragment that flows through
1886-
the <span>CSS Region</span>.</p>
1894+
the <span>CSS Region</span>.
1895+
The method returns null
1896+
if the <span>region</span> object
1897+
is not (or no longer) a region.</p>
18871898

18881899
<div class="note">
18891900
<p>If the element is not contained
@@ -1906,15 +1917,7 @@ <h3 id="the-region-interface">The Region interface</h3>
19061917
element or other construct
19071918
becomes 'none'
19081919
but a script is still holding
1909-
a reference to the <code class="idl">Region</code> object.
1910-
If a <code class="idl">Region</code> instance
1911-
is no longer a <span>region</span>,
1912-
accessing its attributes
1913-
or invoking its methods throws a
1914-
<a href="http://www.w3.org/TR/dom/#exception-domexception"><code class="idl">DOMException</code></a>
1915-
with the
1916-
<a href="http://www.w3.org/TR/dom/#dom-domexception-invalid_access_err"><code class="idl">INVALID_ACCESS_ERR</code></a>
1917-
error code.</p>
1920+
a reference to the <code class="idl">Region</code> object.
19181921
</div>
19191922

19201923
<h3 id="region-style-rule-interface">The CSSRegionStyleRule interface</h3>
@@ -2447,6 +2450,7 @@ <h2 id="changes">Changes</h2>
24472450
<h3 id="changes_from_May_03_2012">Changes from <a href="http://www.w3.org/TR/2012/WD-css3-regions-20120503/">May 3<sup>rd</sup> 2012</a> version</h3>
24482451

24492452
<ul>
2453+
<li>Removed exceptions from the Region interface</li>
24502454
<li>Changed NamedFlowCollection from live to a static snapshot</li>
24512455
<li>Changed NamedFlow to inherit from EventTarget</li>
24522456
<li>Removed flowFrom from Region interface and changed method name to getComputedRegionStyle().</li>

0 commit comments

Comments
 (0)