Skip to content

Commit 06c2500

Browse files
committed
[css-display] Tweak title, move paragraph (and tweak wording), for box-suppress.
1 parent 422e039 commit 06c2500

1 file changed

Lines changed: 11 additions & 10 deletions

File tree

css-display/Overview.bs

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -422,15 +422,7 @@ Automatic Box Type Transformations</h3>
422422

423423

424424
<h2 id='box-suppress'>
425-
Controlling box generation: the 'box-suppress' property</h2>
426-
427-
''display:none'' was historically used as a "toggle" to switch between displaying an element or not.
428-
Making this reversible requires either setting up the CSS <a>cascade</a> properly,
429-
or remembering what the display type was before it was set to ''none''.
430-
To make this common use-case easier,
431-
the 'box-suppress' property was defined to do the same thing,
432-
so that toggling whether or not an element displays
433-
can now be done without affecting its layout type when it <em>is</em> displayed.
425+
Toggling box generation: the 'box-suppress' property</h2>
434426

435427
<pre class="propdef">
436428
Name: box-suppress
@@ -443,9 +435,19 @@ Controlling box generation: the 'box-suppress' property</h2>
443435
Media: all
444436
</pre>
445437

438+
The ''display: none'' value was historically used as a "toggle"
439+
to switch between showing and hiding an element.
440+
Making this reversible requires either setting up the CSS <a>cascade</a> carefully,
441+
or remembering what the 'display' value was before it was set to ''none''.
442+
To make this common use-case easier,
443+
this module introduces the separate 'box-suppress' property to do the same thing,
444+
so that toggling whether or not an element appears in the formatting tree
445+
can now be done without affecting its display type when it <em>is</em> displayed.
446+
446447
If the computed value of 'display' is ''none'',
447448
the computed value of 'box-suppress' is ''discard''.
448449
Otherwise, the computed value is the specified value.
450+
Values have the following meanings:
449451

450452
<dl dfn-type="value" dfn-for="box-suppress">
451453
<dt><dfn>show</dfn>
@@ -479,7 +481,6 @@ Controlling box generation: the 'box-suppress' property</h2>
479481

480482
Issue: We welcome better naming suggestions on this property.
481483

482-
483484
<h2 id='run-in'>
484485
Run-In Layout</h2>
485486

0 commit comments

Comments
 (0)