Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 6 additions & 10 deletions css-contain-1/Overview.bs
Original file line number Diff line number Diff line change
Expand Up @@ -224,15 +224,8 @@ Layout Containment</h3>
they remain part of the <a>fragmentation context</a>,
but do not receive any content from the <a>fragmented flow</a>.

Specifically:
- <a>CSS Regions</a> following the one which traps the content
are still considered part of the <a>region chain</a>
as returned by the {{NamedFlow/getRegions()}} method
of the {{NamedFlow}} interface.
- the {{Region/regionOverset}} attribute of the {{Region}} interface
of the region which traps the content
is set to ''overset'' if the content doesn't fit,
even if it is not the last region in the region chain.
Note: [[CSS-REGIONS-1]] has details over how <a>layout containment</a> affects
regions.

3. If the contents of the element overflow the element,
they must be treated as <a>ink overflow</a>.
Expand Down Expand Up @@ -261,9 +254,11 @@ Style Containment</h3>

Giving an element <dfn export>style containment</dfn> has the following effects:

1. The 'counter-increment', 'counter-set', 'flow-from', 'flow-into', and <a property spec=css2>content</a> (for the purpose of ''content/open-quote''/etc values) properties
1. The 'counter-increment', 'counter-set', and <a property spec=css2>content</a> (for the purpose of ''content/open-quote''/etc values) properties
must be <a for=property>scoped</a> to the element's sub-tree.

Note: [[CSS-REGIONS-1]] has normative requirements on how <a>style containment</a> affects regions.

A <dfn export for=property lt="scoped | scoped property | scoped properties">scoped property</dfn> has its effects scoped to a particular element or subtree.
It must act as if the scoping element was the root of the document
for the purpose of evaluating the property's effects:
Expand Down Expand Up @@ -416,6 +411,7 @@ This appendix is <em>informative</em>.
<li>Clarify to which box paint containment clips.
<li>Move the interaction between containment and the <code>bookmark-*</code> and <code>string-set</code> properties to [[CSS-CONTENT-3]]
<li>Remove the effects of style containment on the "break-*" properties.
<li>Move the description of the effects of containement on regions from this specification to [[CSS-REGIONS-1]].
</ul>

<h3 id="2017-04-19-changes">Changes from the
Expand Down
39 changes: 28 additions & 11 deletions css-regions-1/Overview.bs
Original file line number Diff line number Diff line change
Expand Up @@ -274,6 +274,15 @@ Region chain</h3>
into a <a>region chain</a>
according to the document order.

<h3 id=last-region>
Last region</h3>

A <a>CSS region</a> is deemed to be the <dfn lt="last usable region | last usable CSS region">last usable region</dfn>
in a <a>region chain</a>
if it is the first region in that chain to have <a>layout containment</a>,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you add a "(See [[!CSS-CONTAIN-1]])" here?

or the last region in the chain if none of them have <a>layout containment</a>
(See [[!CSS-CONTAIN-1]]).

<h3 id="named-flow-section">
Named flows</h3>

Expand Down Expand Up @@ -322,12 +331,12 @@ Regions flow breaking rules</h3>
at which point the next region
in the <a>region chain</a>
becomes the current region.
If there are no more <a>CSS Regions</a>
If there are no more usable <a>CSS Regions</a>
in the <a>region chain</a>
and there is still content in the flow,
the positioning of the remaining content
is controlled by the 'region-fragment' property
on the last <a>CSS Region</a> in the chain.
on the <a>last usable CSS Region</a> in the chain.

The CSS regions module follows
the fragmentation rules defined
Expand Down Expand Up @@ -462,6 +471,9 @@ The 'flow-into' property</h3>
The writing mode
on subsequent regions is ignored.

If an element has <a>style containment</a> (See [[!CSS-CONTAIN-1]]),
then the 'flow-into' property must be <a for=property>scoped</a> to that element.

<div class="note"><span class="note-prefix">Note </span>

The 'flow-into' property moves an element into the flow
Expand Down Expand Up @@ -607,6 +619,9 @@ The 'flow-from' property</h3>
which is an update to the behavior
described in [[!CSS21]].

If an element has <a>style containment</a> (See [[!CSS-CONTAIN-1]]),
then the 'flow-from' property must be <a for=property>scoped</a> to that element.

<div class="note"><span class="note-prefix">Note </span>

A block container becomes a <a>CSS Region</a>
Expand Down Expand Up @@ -903,7 +918,7 @@ The region-fragment property</h3>
</pre>

The 'region-fragment' property controls the behavior
of the <em id="last-region">last region</em>
of the <a>last usable region</a>
associated with a <a>named flow</a>.

<dl>
Expand All @@ -915,7 +930,7 @@ The region-fragment property</h3>
it is subject to the
<a href= "https://www.w3.org/TR/CSS21/visufx.html#propdef-overflow">overflow</a>
property's computed value on the <a>CSS Region</a>.
Region breaks must be ignored on the last region.
Region breaks must be ignored on the <a>last usable region</a>.
</dd>

<dt>break</dt>
Expand All @@ -929,7 +944,7 @@ The region-fragment property</h3>
See the <a href= "#regions-flow-breaking-rules">breaking rules</a> section.
A forced region break takes precedence over a natural break point.

Flow content that follows the last break in the last region is not rendered.
Flow content that follows the last break in the <a>last usable region</a> is not rendered.
</dd>
</dl>

Expand Down Expand Up @@ -1152,6 +1167,7 @@ The NamedFlow interface</h3>
method returns the sequence
of regions in the <a>region chain</a>
associated with the <a>named flow</a>.
Regions after the <a>last usable region</a>, if any, are included.
Note that the returned values
is a static sequence
in document order.
Expand Down Expand Up @@ -1240,7 +1256,7 @@ The Region interface</h3>
<dt>''overset''</dt>

<dd>
The region is the last one in the
The region is the <a>last usable region</a> in the
<a>region chain</a> and
not able to fit the remaining content from the <a>named flow</a>.
Note that the region's
Expand All @@ -1249,7 +1265,7 @@ The Region interface</h3>
property value can be used to control the
visibility of the overflowing content and the
'region-fragment' property controls whether or not fragmentation happens
on the content that overflows the last region.
on the content that overflows the <a>last usable region</a>.
</dd>

<dt>''fit''</dt>
Expand All @@ -1258,11 +1274,11 @@ The Region interface</h3>
The region's flow fragment content
fits into the region's
<a href="https://www.w3.org/TR/CSS21/box.html#box-dimensions">content box</a>.
If the region is the last one
If the region is the <a>last usable region</a>
in the <a>region chain</a>,
it means that the content
fits without overflowing.
If the region is not the last one
If the region is not the <a>last usable region</a>
in the <a>region chain</a>,
that means the <a>named flow</a> content
may be further fitted in subsequent regions.
Expand Down Expand Up @@ -1317,7 +1333,7 @@ The Region interface</h3>
is the first <code>Node</code>
in the <a>named flow</a>
and the <code>startOffset</code> is zero.
If the region is the last region
If the region is the <a>last usable region</a>
in the <a>region chain</a>
(but not the first and only one),
the <code>startContainer</code>
Expand Down Expand Up @@ -1501,7 +1517,7 @@ Multi-column regions</h2>
the remaining <a>region chain</a>.
However,
if a multicol region
is the last region
is the <a>last usable region</a>
in a <a>region chain</a>,
then the multicol region must follow the
<a href="https://drafts.csswg.org/css3-multicol/#overflow-columns">overflow column rules</a>
Expand Down Expand Up @@ -2136,6 +2152,7 @@ Changes from <a href="https://www.w3.org/TR/2014/WD-css3-regions-20140218/">Febr
<ul>
<li>Added three simpler examples to the introduction</li>
<li>Moved complex example to the <a href="http://wiki.csswg.org/spec/css3-regions/complex-layout-example">CSSWG wiki</a></li>
<li>Moved the effects of CSS containment to this specification from [[CSS-CONTAIN-1]].
</ul>

<h3 id="changes_from_May_28_2013">
Expand Down