The display property defines box’s display type, which consists of the two basic qualities of how an element generates boxes:

the inner display type, which defines the kind of formatting context it generates, dictating how its descendant boxes are laid out.
the outer display type, which dictates how the box participates in its parent formatting context.

Some display values have additional side-effects: such as list-item, which also generates a ::marker pseudo-element, and none, which causes the element’s entire subtree to be left out of the box tree.

]]> The display: none value was historically used as a "toggle" to switch between showing and hiding an element. Making this reversible requires either setting up the CSS cascade carefully, or remembering what the value was before it was set to none. To make this common use-case easier, this module introduces the separate box-suppress property to do the same thing, so that toggling whether or not an element appears in the formatting tree can now be done without affecting its display type when it is displayed.

]]>