Skip to content

Commit 4480d6c

Browse files
committed
[css-display] Drop in an issue explaining the status of box-suppress. <w3c#343 (comment)> per WG resolution <https://lists.w3.org/Archives/Public/www-style/2016Aug/0034.html>. Not edited in due to expectation of deferring to next level with the next publication cycle.
1 parent a4dde50 commit 4480d6c

1 file changed

Lines changed: 17 additions & 12 deletions

File tree

css-display/Overview.bs

Lines changed: 17 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Previous Version: https://www.w3.org/TR/2015/WD-css-display-3-20150721/
1313
Previous Version: https://www.w3.org/TR/2014/WD-css-display-3-20140911/
1414
Editor: Tab Atkins Jr., Google, http://xanthir.com/contact/
1515
Editor: Elika J. Etemad / fantasai, Invited Expert, http://fantasai.inkedblade.net/contact
16-
Abstract: This module describes how the CSS formatting box tree is generated from the document element tree and defines the 'display' and 'box-suppress' properties that control it.
16+
Abstract: This module describes how the CSS formatting box tree is generated from the document element tree and defines the 'display' and 'display-or-not' properties that control it.
1717
Ignored Terms: display-model, display-role, table row group box, absolutely positioned
1818
</pre>
1919
<pre class="link-defaults">
@@ -40,14 +40,14 @@ Introduction</h2>
4040
(See [[!CSS3-CASCADE]].)
4141

4242
Then, for each element, it generates zero or more boxes
43-
as specified by that element's 'display' and 'box-suppress' properties.
43+
as specified by that element's 'display' and 'display-or-not' properties.
4444
Typically, an element generates a single <a>box</a>.
4545
However, some 'display' values
4646
(e.g. ''display: list-item'')
4747
generate more than one box
4848
(e.g. a <a href="https://www.w3.org/TR/CSS2/visuren.html#principal-box">principal block box</a> and a <a href="https://www.w3.org/TR/CSS2/generate.html#lists">marker box</a>).
4949
And some values
50-
(such as ''display:none'', ''display: contents'', and ''box-suppress: discard'')
50+
(such as ''display:none'', ''display: contents'', and ''display-or-not: discard'')
5151
cause the <a>element</a> and/or its descendants to not generate any <a>boxes</a> at all.
5252
<a>Boxes</a> are assigned the same styles as their generating <a>element</a>, unless otherwise indicated.
5353
They're often referred to by their 'display' type--
@@ -479,7 +479,7 @@ Box Generation: the ''none'' and ''contents'' keywords</h3>
479479
<dd>
480480
The element and its descendants generates no boxes.
481481

482-
Advisement: It is recommended that 'box-suppress' be used instead of ''display: none'',
482+
Advisement: It is recommended that 'display-or-not' be used instead of ''display: none'',
483483
so that the element's display type is automatically preserved
484484
for when it's no longer suppressed.
485485
</dl>
@@ -553,16 +553,16 @@ Automatic Box Type Transformations</h3>
553553

554554

555555
<h2 id='box-suppress'>
556-
Toggling Box Generation: the 'box-suppress' property</h2>
556+
Toggling Box Generation: the 'display-or-not' property</h2>
557557

558558
<pre class="propdef">
559-
Name: box-suppress
559+
Name: display-or-not
560560
Value: show | discard | hide
561561
Initial: show
562562
Applies to: all elements
563563
Inherited: no
564564
Percentages: n/a
565-
Computed value: see prose
565+
Computed value: as specified
566566
Media: all
567567
</pre>
568568

@@ -571,16 +571,21 @@ Toggling Box Generation: the 'box-suppress' property</h2>
571571
Making this reversible requires either setting up the CSS <a>cascade</a> carefully,
572572
or remembering what the 'display' value was before it was set to ''none''.
573573
To make this common use-case easier,
574-
this module introduces the separate 'box-suppress' property to do the same thing,
574+
this module introduces the separate 'display-or-not' property to do the same thing,
575575
so that toggling whether or not an element appears in the formatting tree
576576
can now be done without affecting its display type when it <em>is</em> displayed.
577577

578-
If the computed value of 'display' is ''none'',
579-
the computed value of 'box-suppress' is ''discard''.
580-
Otherwise, the computed value is the specified value.
578+
Issue: This property (which needs a better name)
579+
along with a <css>display-type</css> (or possibly <css>display-as</css>) longhand
580+
which takes all values of 'display' other than ''none'',
581+
are intended to be longhands of 'display'.
582+
This has not yet been edited in, as this split feature is likely to be deferred to the next level
583+
in order to have time to thoroughly work through and accommodate the
584+
<a href="https://lists.w3.org/Archives/Public/www-style/2016Aug/0025.html">various use cases</a> for showing/hiding an element.
585+
581586
Values have the following meanings:
582587

583-
<dl dfn-type="value" dfn-for="box-suppress">
588+
<dl dfn-type="value" dfn-for="display-or-not">
584589
<dt><dfn>show</dfn>
585590
<dd>
586591
The element generates boxes as normal,

0 commit comments

Comments
 (0)