ContextQMD
Back to Content

minmax()

files/en-us/web/css/reference/values/minmax/index.md

latest4.9 KB
Original Source

The minmax() CSS function defines a size range greater than or equal to min and less than or equal to max. It is used with CSS grids.

{{InteractiveExample("CSS Demo: minmax()")}}

css
grid-template-columns: minmax(20px, auto) 1fr 1fr;
css
grid-template-columns: minmax(0, 1fr) minmax(0, 1fr) minmax(0, 1fr);
css
grid-template-columns: minmax(2ch, 10ch) 1fr 1fr;
html
<section class="default-example" id="default-example">
  <div class="example-container">
    <div class="transition-all" id="example-element">
      <div>One. This column has more text in it.</div>
      <div>Two</div>
      <div>Three</div>
      <div>Four</div>
      <div>Five</div>
    </div>
  </div>
</section>
css
#example-element {
  border: 1px solid #c5c5c5;
  display: grid;
  grid-gap: 10px;
  width: 250px;
}

#example-element > div {
  background-color: rgb(0 0 255 / 0.2);
  border: 3px solid blue;
  text-align: left;
}

Syntax

css
/* <inflexible-breadth>, <track-breadth> values */
minmax(200px, 1fr)
minmax(400px, 50%)
minmax(30%, 300px)
minmax(100px, max-content)
minmax(min-content, 400px)
minmax(max-content, auto)
minmax(auto, 300px)
minmax(min-content, auto)

/* <fixed-breadth>, <track-breadth> values */
minmax(200px, 1fr)
minmax(30%, 300px)
minmax(400px, 50%)
minmax(50%, min-content)
minmax(300px, max-content)
minmax(200px, auto)

/* <inflexible-breadth>, <fixed-breadth> values */
minmax(400px, 50%)
minmax(30%, 300px)
minmax(min-content, 200px)
minmax(max-content, 200px)
minmax(auto, 300px)

A function taking two parameters, min and max.

Each parameter can be a <length>, a <percentage> or one of the keyword values max-content, min-content, or auto.

The second parameter max also accepts {{cssxref("flex_value","<flex>")}} values. (this fr units can only be used for max, and are invalid for min.)

If max < min, then max is ignored and minmax(min,max) is treated as min.

Values

  • {{cssxref("<length>")}}
    • : A non-negative length.
  • {{cssxref("<percentage>")}}
    • : A non-negative percentage relative to the inline size of the grid container in column grid tracks, and the block size of the grid container in row grid tracks. If the size of the grid container depends on the size of its tracks, then the <percentage> must be treated as auto. The {{glossary("user agent")}} may adjust the intrinsic size contributions of the track to the size of the grid container and increase the final size of the track by the minimum amount that would result in honoring the percentage.
  • {{cssxref("<flex>")}}
    • : A non-negative dimension with the unit fr specifying the track's flex factor. Each <flex>-sized track takes a share of the remaining space in proportion to its flex factor.
  • {{cssxref("max-content")}}
    • : Represents the largest max-content contribution of the grid items occupying the grid track.
  • {{cssxref("min-content")}}
    • : Represents the largest min-content contribution of the grid items occupying the grid track.
  • auto
    • : As min, it represents the largest minimum size (as specified by {{cssxref("min-width")}}/{{cssxref("min-height")}}) of the grid items occupying the grid track. As max, it is identical to max-content. However, unlike max-content, it allows expansion of the track by the {{cssxref("align-content")}} and {{cssxref("justify-content")}} property values like normal and stretch.

Formal syntax

{{CSSSyntax}}

CSS properties

minmax() function can be used within:

  • {{CSSxRef("grid-template-columns")}}
  • {{CSSxRef("grid-template-rows")}}
  • {{CSSxRef("grid-auto-columns")}}
  • {{CSSxRef("grid-auto-rows")}}

Examples

CSS

css
#container {
  display: grid;
  grid-template-columns: minmax(min-content, 300px) minmax(200px, 1fr) 150px;
  grid-gap: 5px;
  box-sizing: border-box;
  height: 200px;
  width: 100%;
  background-color: #8cffa0;
  padding: 10px;
}

#container > div {
  background-color: #8ca0ff;
  padding: 5px;
}

HTML

html
<div id="container">
  <div>Item as wide as the content, but at most 300 pixels.</div>
  <div>Item with flexible width but a minimum of 200 pixels.</div>
  <div>Inflexible item of 150 pixels width.</div>
</div>

Result

{{EmbedLiveSample("Examples", "100%", 200)}}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also