The <display-outside>
keywords specify the elementβs outer display
type, which is essentially its role in flow layout. These keywords are used as values of the display
property, and can be used for legacy purposes as a single keyword, or as defined in the Level 3 specification alongside a value from the <display-inside>
keywords.
Syntax
Valid <display-outside>
values:
block
- The element generates a block element box, generating line breaks both before and after the element when in the normal flow.
inline
- The element generates one or more inline element boxes that do not generate line breaks before or after themselves. In normal flow, the next element will be on the same line if there is space
run-in
- The element generates a run-in box. If the adjacent sibling of the element defined as
display: run-in
box is a block box, therun-in
box becomes the first inline box of the block box that follows it.
Run-in elements act like inlines or blocks, depending on the surrounding elements. That is: 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 an inline box follows, the run-in box becomes a block box.
Note: Browsers that support the two value syntax, on finding the outer value only, such as when display: block
or display: inline
is specified, will set the inner value to flow
. This will result in expected behavior; for example if you specify an element to be block, you would expect that the children of that element would participate in block and inline normal flow layout.
Examples
In the following example, span elements (normally displayed as inline elements) are set to display: block
and so break onto new lines and expand to fill their container in the inline dimension.
HTML
<span>span 1</span> <span>span 2</span>
CSS
span { display: block; border: 1px solid rebeccapurple; }
Result
Specifications
Specification | Status |
---|---|
CSS Display Module Level 3 The definition of 'display-outside' in that specification. |
Candidate Recommendation |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
<display-outside> | Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 4 | Opera Full support 7 | Safari Full support 1 | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support 10.1 | Safari iOS Full support 1 | Samsung Internet Android Full support 1.0 |
run-in | Chrome
No support
1 — 32
| Edge No support No | Firefox No support No | IE Full support 8 | Opera No support 7 — 19 | Safari
No support
1 — 8
| WebView Android No support β€37 — β€37 | Chrome Android No support 18 — 32 | Firefox Android No support No | Opera Android No support 10.1 — 19 | Safari iOS
No support
1 — 8
| Samsung Internet Android No support 1.0 — 2.0 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- See implementation notes.