Summary
The display
CSS property specifies the type of rendering box used for an element. In HTML, default display
property values are taken from behaviors described in the HTML specifications or from the browser/user default stylesheet. The default value in XML isinline
.
In addition to the many different display box types, the value none
lets you turn off the display of an element; when you use none
, all descendant elements also have their display turned off. The document is rendered as though the element doesn't exist in the document tree.
- Initial value
inline
- Applies toall elements
- Inheritedno
- Media
all
- Computed valueas the specified value, except for positioned and floating elements and for the root element. In both case the computed value may be another keyword than the one specified.
- Animatableno
- Canonical orderthe unique non-ambiguous order defined by the formal grammar
Syntax
Formal syntax: none | inline | block | list-item | inline-block | inline-table | table | table-cell | table-column | table-column-group | table-footer-group | table-header-group | table-row | table-row-group | flex | inline-flex | grid | inline-grid | run-in
display: none
display: inline
display: block
display: list-item
display: inline-block
display: inline-table
display: table
display: table-cell
display: table-column
display: table-column-group
display: table-footer-group
display: table-header-group
display: table-row
display: table-row-group
display: flex
display: inline-flex
display: grid
display: inline-grid
display: run-in
display: inherit
Values
display-value
-
Is a keyword defining the rendering type to apply to the element. Its possible values and their meanings are:
Value set Value Description Basic values (CSS 1) none
Turns off the display of an element (it has no effect on layout); all descendant elements also have their display turned off. The document is rendered as though the element did not exist.
To render an element box's dimensions, yet have its contents be invisible, see the
visibility
property.inline
The element generates one or more inline element boxes. block
The element generates a block element box. list-item
The element generates a block box for the content and a separate list-item inline box. Extended values (CSS 2.1) inline-block
The element generates a block element box that will be flowed with surrounding content as if it were a single inline box (behaving much like a replaced element would) Table model values (CSS 2.1) inline-table
The inline-table
value does not have a direct mapping in HTML. It behaves like a<table>
HTML element, but as an inline box, rather than a block-level box. Inside the table box is a block-level context.table
Behaves like the <table>
HTML element. It defines a block-level box.table-caption
Behaves like the <caption>
HTML element.table-cell
Behaves like the <td>
HTML elementtable-column
These elements behave like the corresponding <col>
HTML elements.table-column-group
These elements behave like the corresponding <colgroup>
HTML elements.table-footer-group
These elements behave like the corresponding <tfoot>
HTML elementstable-header-group
These elements behave like the corresponding <thead>
HTML elementstable-row
Behaves like the <tr>
HTML elementtable-row-group
These elements behave like the corresponding <tbody>
HTML elementsFlexbox model values (CSS3) flex
The element behaves like a block element and lays out its content according to the flexbox model. inline-flex
The element behaves like an inline element and lays out its content according to the flexbox model. Grid box model values (CSS3) Experimental grid
The element behaves like a block element and lay out its content according to the grid model.
As this is experimental, most browsers don't support it. Especially pay attention that-moz-grid
is not the prefixed version of this, but a XUL layout model that must not be used on a Web site.inline-grid
The element behaves like an inline element and lay out its content according to the grid model. Experimental valuesExperimental run-in
- If the run-in box contains a block box, same as block.
- If a block box follows the run-in box, the run-in box becomes the first inline box of the block box.
- If a inline box follows, the run-in box becomes a block box.
Examples
p.secret { display: none }
<p style="display:none"> invisible text </p>
Specifications
Specification | Status | Comment |
---|---|---|
CSS Basic Box Model | Unknown | Added the run-in value. |
CSS Grid Layout | Working Draft | Added the grid box model values. |
CSS Flexible Box Layout Module | Candidate Recommendation | Added the flexible box model values. |
CSS Level 2 (Revision 1) | Recommendation | Added the table model values and inline-block. |
CSS Level 1 | Recommendation | Basic values: none , block , inline , and list-item . |
Browser compatibility
- Desktop
- Mobile
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
none , inline and block | 1.0 | 1.0 (1.0) | 4.0 | 7.0 | 1.0 (85) |
inline-block | 1.0 | 3.0 (1.9) | 5.5 (-7.0) natural inline elements only | 7.0 | 1.0 (85) |
list-item | 1.0 | 1.0 (1.0) | 6.0 | 7.0 | 1.0 (85) |
run-in Experimental | 1.0 Not before inline-elements | Not supported | 8.0 | 7.0 | 1.0 (85) Not before inline-elements |
4.0 | 5.0 (532.5) | ||||
inline-table | 1.0 | 3.0 (1.9) | 8.0 | 7.0 | 1.0 (85) |
table , table-cell , table-column , table-colgroup , table-header-group , table-row-group , table-footer-group , table-row , and table-caption | 1.0 | 1.0 (1.0) | 8.0 | 7.0 | 1.0 (85) |
flex | 21.0-webkit | 18.0 (18.0)(behind a pref) [1] | Not supported | 12.50 | Not supported |
inline-flex | 21.0-webkit | 18.0 (18.0)(behind a pref) [1] | Not supported | 12.50 | Not supported |
grid Experimental | ? | Not supported | 10.0-ms | ? | ? |
inline-grid Experimental | ? | Not supported | 10.0-ms | ? | ? |