grid

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.

A propriedade grid do CSS é uma abreviação das propriedades que definem todas as propriedades da grade explícita (grid-template-rows, grid-template-columns, e grid-template-areas), e todas as propriedades implícitas da grade (grid-auto-rows, grid-auto-columns, e grid-auto-flow), em uma única declaração.

Experimente

Nota: Você pode especificar apenas as propriedades explícitas ou implícitas da grade em uma única declaração grid. As subpropriedades que você não especifica são definidas como seu valor inicial, como é normal para abreviações. Além disso, as propriedades da medianiz NÃO são redefinidas por essa abreviação.

Sintaxe

css
/* <'grid-template'> values */
grid: none;
grid: "a" 100px "b" 1fr;
grid: [linename1] "a" 100px [linename2];
grid: "a" 200px "b" min-content;
grid: "a" minmax(100px, max-content) "b" 20%;
grid: 100px / 200px;
grid: minmax(400px, min-content) / repeat(auto-fill, 50px);

/* <'grid-template-rows'> /
   [ auto-flow && dense? ] <'grid-auto-columns'>? values */
grid: 200px / auto-flow;
grid: 30% / auto-flow dense;
grid: repeat(3, [line1 line2 line3] 200px) / auto-flow 300px;
grid: [line1] minmax(20em, max-content) / auto-flow dense 40%;

/* [ auto-flow && dense? ] <'grid-auto-rows'>? /
   <'grid-template-columns'> values */
grid: auto-flow / 200px;
grid: auto-flow dense / 30%;
grid: auto-flow 300px / repeat(3, [line1 line2 line3] 200px);
grid: auto-flow dense 40% / [line1] minmax(20em, max-content);

/* Global values */
grid: inherit;
grid: initial;
grid: unset;

Valores

<'grid-template'>

Define o grid-template incluindo grid-template-columns, grid-template-rows e grid-template-areas.

<'grid-template-rows'> / [ auto-flow && dense? ] <'grid-auto-columns'>?

Configura um fluxo automático definindo as faixas de linha explicitamente por meio da propriedade grid-template-rows (e a propriedade grid-template-columns para none) e especificando como repetir automaticamente as faixas da coluna via grid-auto-columns (e setando grid-auto-rows para auto). grid-auto-flow também é definido para a column, de acordo com dense, se especificado.

Todas as outras subpropriedades grid são redefinidas para seus valores iniciais.

[ auto-flow && dense? ] <'grid-auto-rows'>? / <'grid-template-columns'>

Configura um fluxo automático definindo as faixas da coluna explicitamente por meio da propriedade grid-template-columns (e a propriedade grid-template-rows para none) e especificando como repetir automaticamente as faixas de linha via grid-auto-rows (e setando grid-auto-columns para auto). grid-auto-flow também é definido para row de acordo com dense, se especificado.

Todas as outras subpropriedades grid são redefinidas para seus valores iniciais.

Sintaxe formal

grid = 
  <'grid-template'>                                   |
  <'grid-template-rows'> / [ auto-flow && dense? ] <'grid-auto-columns'>?  |
  [ auto-flow && dense? ] <'grid-auto-rows'>? / <'grid-template-columns'>  

<grid-template> = 
  none                                                |
  [ <'grid-template-rows'> / <'grid-template-columns'> ]  |
  [ <line-names>? <string> <track-size>? <line-names>? ]+ [ / <explicit-track-list> ]?  

<grid-template-rows> = 
  none                       |
  <track-list>               |
  <auto-track-list>          |
  subgrid <line-name-list>?  

<grid-auto-columns> = 
  <track-size>+  

<grid-auto-rows> = 
  <track-size>+  

<grid-template-columns> = 
  none                       |
  <track-list>               |
  <auto-track-list>          |
  subgrid <line-name-list>?  

<line-names> = 
  '[' <custom-ident>* ']'  

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

<explicit-track-list> = 
  [ <line-names>? <track-size> ]+ <line-names>?  

<track-list> = 
  [ <line-names>? [ <track-size> | <track-repeat> ] ]+ <line-names>?  

<auto-track-list> = 
  [ <line-names>? [ <fixed-size> | <fixed-repeat> ] ]* <line-names>? <auto-repeat> [ <line-names>? [ <fixed-size> | <fixed-repeat> ] ]* <line-names>?  

<line-name-list> = 
  [ <line-names> | <name-repeat> ]+  

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

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

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

<track-repeat> = 
  repeat( [ <integer [1,∞]> ] , [ <line-names>? <track-size> ]+ <line-names>? )  

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

<fixed-repeat> = 
  repeat( [ <integer [1,∞]> ] , [ <line-names>? <fixed-size> ]+ <line-names>? )  

<auto-repeat> = 
  repeat( [ auto-fill | auto-fit ] , [ <line-names>? <fixed-size> ]+ <line-names>? )  

<name-repeat> = 
  repeat( [ <integer [1,∞]> | auto-fill ] , <line-names>+ )  

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

Exemplo

Conteúdo HTML

html
<div id="container">
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
  <div></div>
</div>

Conteúdo CSS

css
#container {
  display: grid;
  grid: repeat(2, 60px) / auto-flow 80px;
}

#container > div {
  background-color: #8ca0ff;
  width: 50px;
  height: 50px;
}

Resultado

Especificações

Specification
CSS Grid Layout Module Level 2
# grid-shorthand
Initial valueas each of the properties of the shorthand:
Aplica-se agrid containers
Inheritednão
Percentagesas each of the properties of the shorthand:
Computed valueas each of the properties of the shorthand:
  • grid-template-rows: as specified, but with relative lengths converted into absolute lengths
  • grid-template-columns: as specified, but with relative lengths converted into absolute lengths
  • grid-template-areas: as specified
  • grid-auto-rows: the percentage as specified or the absolute length
  • grid-auto-columns: the percentage as specified or the absolute length
  • grid-auto-flow: as specified
  • grid-column-gap: the percentage as specified or the absolute length
  • grid-row-gap: the percentage as specified or the absolute length
  • column-gap: as specified, with <length>s made absolute, and normal computing to zero except on multi-column elements
  • row-gap: as specified, with <length>s made absolute, and normal computing to zero except on multi-column elements
Animation typeas each of the properties of the shorthand:

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também

  1. CSS
  2. CSS Reference
  3. CSS Grid Layout
  4. Guias
    1. Basics concepts of grid layout
    2. Relationship to other layout methods
    3. Line-based placement
    4. Grid template areas
    5. Layout using named grid lines
    6. Auto-placement in grid layout
    7. Box alignment in grid layout
    8. Grids, logical values and writing modes
    9. CSS Grid Layout and Accessibility
    10. CSS Grid Layout and Progressive Enhancement
    11. Realizing common layouts using grids
  5. Propriedades
    1. grid
    2. grid-area
    3. grid-auto-columns
    4. grid-auto-flow
    5. grid-auto-rows
    6. grid-column
    7. grid-column-end
    8. grid-column-gap
    9. grid-column-start
    10. grid-gap
    11. grid-row
    12. grid-row-end
    13. grid-row-gap
    14. grid-row-start
    15. grid-template
    16. grid-template-areas
    17. grid-template-columns
    18. grid-template-rows
  6. Glossário
    1. Grid lines
    2. Grid tracks
    3. Grid cell
    4. Grid areas
    5. Gutters
    6. Grid row
    7. Grid column