grid-template-columns#

#Introduction

The grid-template-columns CSS property defines track sizing functions of the grid columns.

#Examples

css-apisrc/grid-template-columns/App.tsx

Preview

#Syntax

/* Keyword value */
grid-template-columns: none;

/* <track-list> values */
grid-template-columns: 100px 1fr;
grid-template-columns: minmax(100px, 1fr);
grid-template-columns: fit-content(40%);
grid-template-columns: repeat(3, 200px);

#Values

• <length>

  <length> is a non-negative length, giving the width of the column.

• <percentage>

  Is a non-negative <percentage> value relative to the inline size of the grid container.

• <flex>

  Is 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.

  When appearing outside a minmax() notation, it implies an automatic minimum (i.e. minmax(auto, <flex>)).

• max-content

  Is a keyword representing the largest maximal content contribution of the grid items occupying the grid track.

• auto

  As a maximum represents the largest max-content size of the items in that track.

  As a minimum represents the largest minimum size of items in that track (specified by the min-width/min-height of the items). This is often, though not always, the min-content size.

  If used outside of minmax() notation, auto represents the range between the minimum and maximum described above.

  Info

  auto track sizes (and only auto track sizes) can be stretched by the align-content and justify-content properties. Therefore by default, an auto sized track will take up any remaining space in the grid container.

• minmax(min, max)

  Is a functional notation that defines a size range, greater than or equal to min, and less than or equal to max. If max is smaller than min, then max is ignored and the function is treated as min. As a maximum, a <flex> value sets the track's flex factor. It is invalid as a minimum.

• fit-content( [ <length> | <percentage> ] )

  Represents the formula max(minimum, min(limit, max-content)), where minimum represents an auto minimum (which is often, but not always, equal to a min-content minimum), and limit is the track sizing function passed as an argument to fit-content(). This is essentially calculated as the smaller of minmax(auto, max-content) and minmax(auto, limit).

• repeat(<positive-integer>, [<length> | <percentage> | auto])

  Represents a repeated fragment of the track list, allowing a large number of columns that exhibit a recurring pattern to be written in a more compact form.

#Formal definition

#Formal syntax

grid-template-columns =
  <track-list>

<track-list> =
   <track-size> | <track-repeat>

<track-size> =
  <track-breadth>                                   |
  minmax( <inflexible-breadth> , <track-breadth> )  |
  fit-content( <length-percentage [0,∞]> )

<track-repeat> =
  repeat([ <integer [1,∞]> ] , <track-size>)

<fixed-size> =
  <fixed-breadth>                                   |
  minmax( <fixed-breadth> , <track-breadth> )       |
  minmax( <inflexible-breadth> , <fixed-breadth> )

<fixed-repeat> =
  repeat( [ <integer [1,∞]> ] , <fixed-size>)

<track-breadth> =
  <length-percentage [0,∞]>  |
  <flex [0,∞]>               |
  max-content                |
  auto

<inflexible-breadth> =
  <length-percentage [0,∞]>  |
  max-content                |
  auto

<length-percentage> =
  <length>      |
  <percentage>

<fixed-breadth> =
  <length-percentage [0,∞]>

#Difference between web

• [line-names] is not supported.
• none is not supported.
• masonry and subgrid are not supported.

#Compatibility