Skip to content

Commit f8d6b33

Browse files
committed
[css-overflow-3] Editorial tweaks
Improvements based on a review by fantasai
1 parent abd0a2d commit f8d6b33

File tree

1 file changed

+23
-17
lines changed

1 file changed

+23
-17
lines changed

‎css-overflow-3/Overview.bs

+23-17
Original file line numberDiff line numberDiff line change
@@ -822,7 +822,7 @@ Limiting Visible Lines: the 'line-clamp' shorthand property</h2>
822822
See the corresponding longhand properties for details
823823
about how this mechanism operates.
824824

825-
Note: For the time being,
825+
Issue: For the time being,
826826
experiemental implementations are encouraged
827827
to follow the full behavior defined by this shorthand and its longhands,
828828
but to only expose the shorthand to authors.
@@ -934,10 +934,6 @@ Forcing a break after a set number of lines: the 'max-lines' property</h2>
934934
<h2 id="fragmentation">
935935
Fragmentation of overflow: the 'continue' property</h2>
936936

937-
The 'continue' property gives authors the ability
938-
to turn a box into a [=fragmentation container=] (see [[!CSS-BREAK-3]])
939-
and to specify that content after the [=fragmentation break=] must be discarded.
940-
941937
<pre class=propdef>
942938
Name: continue
943939
Value: ''continue/auto'' | ''discard''
@@ -949,6 +945,10 @@ and to specify that content after the [=fragmentation break=] must be discarded.
949945
Canonical order: <abbr title="follows order of property value definition">per grammar</abbr>
950946
</pre>
951947

948+
The 'continue' property gives authors the ability
949+
to turn a box into a [=fragmentation container=] (see [[!CSS-BREAK-3]])
950+
and to specify that content after the [=fragmentation break=] must be discarded.
951+
952952
Issue: This property is meant to generalize and replace the <code>region-fragment</code> property from [[CSS-REGIONS-1]].
953953
Once it is sufficiently stable in this specification,
954954
<code>region-fragment</code> should be removed from the regions specification in favor of this.
@@ -960,16 +960,16 @@ Once it is sufficiently stable in this specification,
960960
If the box has more content than can fit,
961961
the excess content is handled according to the usual rules:
962962

963-
* If the box is not a [=fragmentation container=]
964-
or if it is the last [=fragmentation container=] in a [=fragmentation context=]
965-
which does not automatically generate more as needed (for example the last region in a region chain, see [[CSS-REGIONS-1]]),
966-
content that doesn't fit into the box overflows,
967-
as specified by the 'overflow' property.
963+
If the box is not a [=fragmentation container=]
964+
or if it is the last [=fragmentation container=] in a [=fragmentation context=]
965+
which does not automatically generate more as needed (for example the last region in a region chain, see [[CSS-REGIONS-1]]),
966+
content that doesn't fit into the box overflows,
967+
as specified by the 'overflow' property.
968968

969-
* Otherwise (i.e. the box is a non-last fragmentation container),
970-
the remainer of the [=fragmented flow=] after the [=fragmentation break=] (if any)
971-
is flowed to the next [=fragmentation container=] in the [=fragmentation context=].
972-
The 'overflow' property continues to govern how to handle the contents of a box that extend outside one of that box’s edges
969+
Otherwise (i.e. the box is a non-last fragmentation container),
970+
the remainer of the [=fragmented flow=] after the [=fragmentation break=] (if any)
971+
is flowed to the next [=fragmentation container=] in the [=fragmentation context=].
972+
The 'overflow' property continues to govern how to handle the contents of a box that extend outside one of that box’s edges
973973

974974
<dt><dfn>discard</dfn>
975975
<dd>
@@ -986,13 +986,19 @@ Once it is sufficiently stable in this specification,
986986
is treated as the end of the <a>fragmentation container</a>,
987987
and the rest of the <a>fragmented flow</a> is laid out in
988988
the next <a>fragmentation container</a> in the <a>fragmentation context</a>.
989-
The remaining content after the [=fragmentation break=] is discarded,
989+
The remaining content after the [=fragmentation break=] is discarded,
990990
similar to if it were ''display: none'':
991+
* Just as the content is visually hidden, it is not made available for speech rendering
992+
* It does not allow user interaction
993+
* [=Positioned=] elements whose static position is in the discarded content are not rendered.
994+
995+
Issue: Are we sure about that?
996+
Discussions in the <a href="https://lists.w3.org/Archives/Public/www-style/2018Jul/0030.html">Syndey F2F meeting</a>
997+
seemed to generally converge on this,
998+
but other possibilities were raised.
991999
* It is neither rendered,
9921000
nor measured as part of the box’s contents for the purpose of
9931001
finding its <a lt="min-content block size">min-content</a>, <a>max-content</a>, or <a lt="automatic size">automatic</a> <a>block sizes</a>
994-
* It does not allow user interaction
995-
* [=Positioned=] elements whose static position is in the discarded content are not rendered
9961002

9971003
However, since intrinsic sizes are calculated across all <a>fragmentation containers</a>,
9981004
this content <em>is</em> taken into account

0 commit comments

Comments
 (0)