Skip to content

Commit 907351d

Browse files
committed
[css-overflow-3] Update Abstract, Status, and Changes sections
1 parent 9ba26ac commit 907351d

File tree

1 file changed

+58
-9
lines changed

1 file changed

+58
-9
lines changed

css-overflow-3/Overview.bs

Lines changed: 58 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -14,17 +14,30 @@ Editor: L. David Baron, Mozilla https://www.mozilla.org/, https://dbaron.org/, w
1414
Editor: Elika J. Etemad / fantasai, Invited Expert, http://fantasai.inkedblade.net/contact, w3cid 35400
1515
Editor: Florian Rivoal, On behalf of Bloomberg, http://florian.rivoal.net/, w3cid 43241
1616
Abstract: This module contains the features of CSS relating to scrollable overflow handling in visual media.
17-
!Change Log: <a href="https://hg.csswg.org/drafts/log/tip/css-overflow/Overview.bs">from 27 January 2015 to the present</a>
18-
!Change Log: <a href="https://hg.csswg.org/drafts/log/tip/css-overflow/Overview.src.html">from 28 March 2013 to 27 January 2015</a>
19-
!Change Log: <a href="https://hg.csswg.org/drafts/log/tip/css3-overflow/Overview.src.html">from 31 July 2012 to 27 March 2013</a>
17+
This level is focused on completing a precise specification for the existing overflow features,
18+
including the 'overflow' property and its longhands;
19+
'line-clamp', its longhands, and its legacy pre-standard syntax;
20+
and the 'text-overflow' property.
21+
A few additional features introduced in support of [[CSS-CONTAIN-1]] and [[CSS-CONTAIN-2]] are also defined:
22+
''overflow: clip'' and the 'overflow-clip-margin' property.
2023
Ignored Vars: B, P
2124
Ignored Terms: padding edge, viewport, line box, flex order, -webkit-box-orient
2225
At Risk: the 'max-lines' property
23-
Status Text: <strong>This update trims away most of the experimental new ideas
24-
for handling overflow that were described in the <a href="https://www.w3.org/TR/2013/WD-css-overflow-3-20130418/">previous Working Draft</a>.
25-
These ideas are not abandoned; they are merely <a href="https://drafts.csswg.org/css-overflow/">deferred until Level 4</a>.</strong>
26-
Level 3 is focused solely on completing a spec for the existing, shipped 'overflow' features;
27-
work will resume on fragmented overflow and other fun things once this is completed.
26+
Status Text:
27+
The desciption of 'overflow' and its longhands is considered
28+
significantly more complete and correct than previous working drafs
29+
or than [[CSS2]],
30+
but a few questions and issues remain open.
31+
''overflow: clip' and 'overflow-clip-margin' are rather new,
32+
and lack implementation experience.
33+
'text-overflow' is stable,
34+
is unchanged form its earlier definition in [[CSS-UI-3]].
35+
While not yet fully validated by implementation experience,
36+
the design of 'line-clamp' and its longhands is considered roughly complete.
37+
Earlier versions of this specification included experimental new ideas
38+
for handling overflow by creating new boxes using fragmentation.
39+
These ideas are not abandoned; they are merely <a href="https://drafts.csswg.org/css-overflow-4/">deferred until Level 4</a>.
40+
Work will resume on fragmented overflow once this level stabilizes completed.
2841
</pre>
2942
<!-- FIXME: Regressions from bikeshed conversion: -->
3043
<!-- - Value lines in propdef tables no longer link to #values. -->
@@ -1315,11 +1328,47 @@ Once it is sufficiently stable in this specification,
13151328
</div>
13161329

13171330

1318-
Privacy and Security Considerations {#priv-sec}
1331+
<h2 class="no-num non-normative" id="priv-sec">Appendex A. Privacy and Security Considerations</h2>
13191332
===============================================
13201333

13211334
This specification introduces no new privacy or security concerns.
13221335

1336+
<h2 class="no-num non-normative" id="changes">Appendix B. Changes</h2>
1337+
1338+
This appendix is <em>informative</em>.
1339+
1340+
<h3 id="changes-since-2018-07-31">
1341+
Changes from the <a href="https://www.w3.org/TR/2018/WD-css-overflow-3-20180731/">2018-07-31 Working Draft</a>
1342+
</h3>
1343+
1344+
* Fixed markup errors and typos
1345+
* Made various editorial clarifications and fixed inconsistencies
1346+
* Renamed <code>block-overflow</code> to 'block-ellipsis'
1347+
* Define 'text-overflow' to affect an overflowing [=block overflow ellipsis=]
1348+
* Define the behavior of a [=block overflow ellipsis=] that is longer than the line
1349+
* Define interaction of 'block-ellipsis' and ''::first-line'' / ''::first-letter''
1350+
* Adjust the intrinsic size of elements with ''continue: discard''
1351+
* Define how to layout the [=block overflow ellipsis=]
1352+
* Define the legacy behavior of '-webkit-line-clamp' for compatibility with existing content
1353+
* Define that end padding is included in the scrollable overflow area except for block containers
1354+
(which are more tricky to handle, due to web-compat issues)
1355+
* Define that Margins of flex and grid items are included in scrollable overflow
1356+
* Do not propagate overflow from boxless elements
1357+
* Rename 'scrollable overflow region' to 'scrollable overflow area'
1358+
* Introduce the 'overflow-clip-margin' property
1359+
1360+
<h3 id="old-changes">
1361+
Changes Prior to the <a href="https://www.w3.org/TR/2018/WD-css-overflow-3-20180731/">2018-07-31 Working Draft</a>
1362+
</h3>
1363+
1364+
Changes predating the publication of the <a href="https://www.w3.org/TR/2018/WD-css-overflow-3-20180731/">2018-07-31 Working Draft</a>
1365+
can be found in the following change logs:
1366+
1367+
* <a href="https://github.com/w3c/csswg-drafts/commits/master?path=css-overflow-3&until=2018-07-31">from 2017-08-02 to 2018-07-31</a>
1368+
* <a href="https://hg.csswg.org/drafts/log/tip/css-overflow/Overview.bs">from 2015-01-27 to 2017-08-01</a>
1369+
* <a href="https://hg.csswg.org/drafts/log/tip/css-overflow/Overview.src.html">from 2013-03-28 to 2015-01-27</a>
1370+
* <a href="https://hg.csswg.org/drafts/log/tip/css3-overflow/Overview.src.html">from 2012-07-31 to 2013-03-27</a>
1371+
13231372
<h2 class=no-num id="acknowledgments">
13241373
Acknowledgments</h2>
13251374

0 commit comments

Comments
 (0)