The min-width
CSS property sets the minimum width of an element. It prevents the used value of the width
property from becoming smaller than the value specified for min-width
.
/* <length> value */ min-width: 3.5em; /* <percentage> value */ min-width: 10%; /* Keyword values */ min-width: max-content; min-width: min-content; min-width: fit-content; min-width: fill-available; /* Global values */ min-width: inherit; min-width: initial; min-width: unset;
The element's width is set to the value of min-width
whenever min-width
is larger than max-width
or width
.
Initial value | 0 |
---|---|
Applies to | all elements but non-replaced inline elements, table rows, and row groups |
Inherited | no |
Percentages | refer to the width of the containing block |
Media | visual |
Computed value | the percentage as specified or the absolute length |
Animation type | a length, percentage or calc(); |
Canonical order | the unique non-ambiguous order defined by the formal grammar |
Syntax
Values
<length>
- The minimum width, expressed as a
<length>
. Negative values make the declaration invalid. <percentage>
- The minimum width, expressed as a
<percentage>
of the containing block's width. Negative values make the declaration invalid.
Keyword values
auto
- The default minimum width for flex items, providing a more reasonable default than 0 for other layouts.
max-content
- The intrinsic preferred width.
min-content
- The intrinsic minimum width.
fill-available
- The containing block's width minus the horizontal margin, border, and padding. (Note that some browsers implement an ancient name for this keyword,
available
.) fit-content
- Defined as
min(max-content, max(min-content, fill-available))
.
Formal syntax
<length> | <percentage> | auto | max-content | min-content | fit-content | fill-available
Examples
table { min-width: 75%; } form { min-width: 0; }
Specifications
Specification | Status | Comment |
---|---|---|
CSS Intrinsic & Extrinsic Sizing Module Level 3 The definition of 'min-width' in that specification. |
Working Draft | Adds the max-content , min-content , fit-content , and fill-available keywords. (Both CSS3 Box and CSS3 Writing Modes drafts used to define these keywords, but are superseded by this spec.) |
CSS Flexible Box Layout Module The definition of 'min-width' in that specification. |
Candidate Recommendation | Adds the auto keyword and uses it as the initial value. |
CSS Transitions The definition of 'min-width' in that specification. |
Working Draft | Defines min-width as animatable. |
CSS Level 2 (Revision 1) The definition of 'min-width' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Basic support | 1.0 | (Yes) | 1.0 (1.0) | 7.0 | 4.0 | 2.0.2 (416), buggy before |
applies to <table> [1] |
No support | No support | (Yes) | No support | (Yes) | No support |
max-content , min-content , fit-content , and fill- available |
24.0 -webkit [3] | No support | 3.0 (1.9) -moz [2] | No support | No support | No support [3] |
auto |
21.0 [4] | ? | 16.0 (16.0) [4] Removed in 22.0 (22.0) Reintroduced in 34.0 (34.0) with the new behavior defined by the spec. |
No support | 12.10 [6] | No support |
auto as initial value |
21.0 | (Yes) | 18.0 (18.0) Removed in 22.0 (22.0) |
No support | 12.10 | No support |
Feature | Android | Chrome for Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Basic support | ? | ? | (Yes) | ? | ? | ? | ?[5] |
applies to <table> [1] |
? | ? | No support | ? | ? | ? | ? |
max-content , min-content , fit-content , and fill- available |
? | ? | No support | ? | ? | ? | ? |
auto |
? | ? | ? | ? | ? | ? | ? |
auto as initial value |
? | ? | ? | ? | ? | ? | ? |
[1] CSS 2.1 explicitly leaves the behavior of min-width
with <table>
undefined. Therefore any behavior is CSS2.1-compliant; newer CSS specifications may define this behavior, so Web developers shouldn't rely on a specific one now.
[2] Gecko experimentally implements the definitions given in CSS3 Basic Box. This one defines available
and not fill-available
. Also the definition of fit-content
is simpler than in CSS3 Intrinsic.
[3] WebKit also implements an earlier proposal, the keyword intrinsic
.
[4] These implementations where implementing a slightly simpler behavior for this keyword: it computed to min-content
on flex items, and it computes to 0
on everything else.
[5] In some browsers, on iOS, a <button> element in its native (default) configuration will not respond to min-width. This problem is due to native buttons. A <span> inside a native button will exhibit the same problem, despite having "display:inline-block" set. When changes are made to other style parameters and the browser is forced to abandon the native button, the min-width setting takes affect.
See also
width
,max-width
- The box model,
box-sizing