The flex
CSS property specifies how a flex item will grow or shrink so as to fit the space available in its flex container. This is a shorthand property that sets flex-grow
, flex-shrink
, and flex-basis
.
/* Basic values */ flex: auto; flex: initial; flex: none; flex: 2; /* One value, unitless number: flex-grow */ flex: 2; /* One value, width/height: flex-basis */ flex: 10em; flex: 30px; /* Two values: flex-grow | flex-basis */ flex: 1 30px; /* Two values: flex-grow | flex-shrink */ flex: 2 2; /* Three values: flex-grow | flex-shrink | flex-basis */ flex: 2 2 10%; /* Global values */ flex: inherit; flex: initial; flex: unset;
For most purposes, authors should set flex
to one of the following values: auto
, initial
, none
, or a positive unitless number. To see the effect of these values, try resizing the flex containers below:
auto
width
and height
properties, but grows to absorb any extra free space in the flex container, and shrinks to its minimum size to fit the container. This is equivalent to setting "flex: 1 1 auto
".initial
width
and height
properties. It shrinks to its minimum size to fit the container, but does not grow to absorb any extra free space in the flex container. This is equivalent to setting "flex: 0 1 auto
".none
width
and height
properties. It is fully inflexible: it neither shrinks nor grows in relation to the flex container. This is equivalent to setting "flex: 0 0 auto
".<positive-number>
flex: <positive-number> 1 0
".By default flex items don't shrink below their minimum content size. To change this, set the item's min-width
or min-height
.
Initial value | as each of the properties of the shorthand:
|
---|---|
Applies to | flex items, including in-flow pseudo-elements |
Inherited | no |
Media | visual |
Computed value | as each of the properties of the shorthand:
|
Animation type | as each of the properties of the shorthand:
|
Canonical order | order of appearance in the formal grammar of the values |
The flex
property may be specified using one, two, or three values.
One-value syntax: the value must be one of:
<number>
: then it is interpreted as <flex-grow>
.width
: then it is interpreted as <flex-basis>
.none
, auto
, or initial
.Two-value syntax: the first value must be a unitless <number>
and it is interpreted as <flex-grow>
. The second value must be one of:
<number>
: then it is interpreted as <flex-shrink>
.width
: then it is interpreted as <flex-basis>
.Three-value syntax:
<number>
and it is interpreted as <flex-grow>
.<number>
and it is interpreted as <flex-shrink>
.width
and is interpreted as <flex-basis>
.<'flex-grow'>
flex-grow
of the flex item. See <number>
for more details. Negative values are considered invalid. Defaults to 0
when omitted.<'flex-shrink'>
flex-shrink
of the flex item. See <number>
for more details. Negative values are considered invalid. Defaults to 1
when omitted.<'flex-basis'>
flex-basis
of the flex item. Any value valid for width
and height
properties are accepted. A preferred size of 0
must have a unit to avoid being interpreted as a flexibility. Defaults to 0
when omitted.none
0 0 auto
.When using one or two unitless values, flex-basis changes from auto to 0. More information can be found in the draft for the Flexible Box Layout Module.
none | [ <'flex-grow'> <'flex-shrink'>? || <'flex-basis'> ]
#flex-container { display: flex; flex-direction: row; } #flex-container > .flex-item { flex: auto; } #flex-container > .raw-item { width: 5rem; }
<div id="flex-container"> <div class="flex-item" id="flex">Flex box (click to toggle raw box)</div> <div class="raw-item" id="raw">Raw box</div> </div>
Specification | Status | Comment |
---|---|---|
CSS Flexible Box Layout Module The definition of 'flex' in that specification. | Candidate Recommendation | Initial definition |
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support |
29 21 -webkit- |
Yes Yes -webkit- |
49 -webkit- 18 — 284 |
12.1 |
9 6.1 -webkit- |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
---|---|---|---|---|---|---|---|
Basic support |
4.4 Yes -webkit- |
? |
Yes Yes -webkit- |
? | 12.1 |
Yes 7.1 -webkit- |
? |
1. Since Firefox 28, multi-line flexbox is supported.
2. Before Firefox 32, Firefox wasn't able to animate values starting or stopping at 0
.
3. From version 44: this feature is behind the layout.css.prefixes.webkit
preference (needs to be set to true
). To change preferences in Firefox, visit about:config.
4. From version 18 until version 28 (exclusive): this feature is behind the layout.css.flexbox.enabled
preference (needs to be set to true
). To change preferences in Firefox, visit about:config.
5. Internet Explorer 11 ignores uses of calc()
in the flex-basis
part of the flex
syntax. This can be worked around by using the longhand properties instead of the shorthand. See Flexbug #8 for more info.
6. Internet Explorer 11 considers a unitless value in the flex-basis
part to be syntactically invalid (and will thus be ignored). A workaround is to always include a unit in the flex-basis
part of the flex
shorthand value. See Flexbug #4 for more info.
7. Internet Explorer 10 and 11 ignore uses of calc()
in the flex-basis
part of the flex
syntax. This can be worked around by using the longhand properties instead of the shorthand. See Flexbug #8 for more info.
8. Internet Explorer 10 and 11 consider a unitless value in the flex-basis
part to be syntactically invalid (and will thus be ignored). A workaround is to always include a unit in the flex-basis
part of the flex
shorthand value. See Flexbug #4 for more info.
© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/flex