Skip to content

CSS Grid

Quickly manage the layout, alignment, and sizing of grid columns, navigation, components, and more with a full suite of responsive grid utilities.

If you are new to or unfamiliar with grid, you're encourage to read this CSS-Tricks grid guide.

Properties for the Parent

display

To define a grid container, you must specify the display CSS property to have one of the values: grid or inline-grid.

I'm a grid container!
<Box sx={{ display: 'grid' }}></Box>
<Box sx={{ display: 'inline-grid' }}></Box>

grid-template-rows

The grid-template-rows property defines the line names and track sizing functions of the grid rows.

1
2
3
<Box sx={{ gridTemplateRows: 'repeat(3, 1fr)' }}>
  <div>1</div>
  <div>2</div>
  <div>3</div>
</Box>

grid-template-columns

The grid-template-columns property defines the line names and track sizing functions of the grid columns.

1
2
3
<Box sx={{ gridTemplateColumns: 'repeat(3, 1fr)' }}>
  <div>1</div>
  <div>2</div>
  <div>3</div>
</Box>

gap

The gap: size property specifies the gap between the different items inside the grid.

1
2
3
4
<Box sx={{ gap: 1, gridTemplateColumns: 'repeat(2, 0.5fr)' }}>
  <div>1</div>
  <div>2</div>
  <div>3</div>
  <div>4</div>
</Box>

row-gap & column-gap

The row-gap and column-gap gives the possibility for specifying the row and column gaps independently.

1
2
3
4
<Box sx={{ columnGap: 1, rowGap: 2, gridTemplateColumns: 'repeat(2, 0.5fr)' }}>
  <div>1</div>
  <div>2</div>
  <div>3</div>
  <div>4</div>
</Box>

grid-template-areas

The grid-template-area property defines a grid template by referencing the names of the grid areas which are specified with the grid-area property.

Header
Main
Sidebar
Footer
<Box
  sx={{
    gridTemplateAreas: `"header header header header"
   "main main . sidebar"
   "footer footer footer footer"`,
  }}
>
  <Box sx={{ gridArea: 'header' }} />
  <Box sx={{ gridArea: 'main' }} />
  <Box sx={{ gridArea: 'sidebar' }} />
  <Box sx={{ gridArea: 'footer' }} />
</Box>

grid-auto-columns

The grid-auto-column property specifies the size of an implicitly-created grid column track or pattern of tracks.

1 / 3
4 / 5
<Box sx={{ gridAutoColumns: '0.2fr' }}>
  <Box sx={{ gridRow: '1', gridColumn: '1 / 3' }}>1 / 3</GridItem>
  <Box sx={{ gridRow: '1', gridColumn: '4 / 5' }}>4 / 5</GridItem>
</Box>

You can see on the screenshot below that the third non-visible column have width of 0.2fr, which is approximately 20%.

grid-auto-column

grid-auto-rows

The grid-auto-rows property specifies the size of an implicitly-created grid row track or pattern of tracks.

1 / 3
4 / 5
<Box sx={{ gridAutoRows: '40px' }}>
  {/* The third non-visible row has height of 40px */}
  <Box sx={{ gridColumn: '1', gridRow: '1 / 3' }}>1 / 3</Box>
  <Box sx={{ gridColumn: '1', gridRow: '4 / 5' }}>4 / 5</Box>
</Box>

grid-auto-flow

The grid-auto-flow property controls how the auto-placement algorithm works, specifying exactly how auto-placed items get flowed into the grid.

1
2
3
4
5
<Box sx={{ gridAutoFlow: 'row' }}>
  <Box sx={{ gridColumn: '1', gridRow: '1 / 3' }}>1</Box>
  <Box>2</Box>
  <Box>3</Box>
  <Box>4</Box>
  <Box sx={{ gridColumn: '5', gridRow: '1 / 3' }}>5</Box>
</Box>

Properties for the Children

grid-column

The grid-column property is a shorthand for grid-column-start + grid-column-end. You can see how it's used in the grid-auto-columns example.

<Box sx={{ gridColumn: '1 / 3' }}>

grid-row

The grid-row property is a shorthand for grid-row-start + grid-row-end. You can see how it's used in the grid-auto-rows example.

<Box sx={{ gridRow: '1 / 3' }}>

grid-area

The grid-area property allows you to give an item a name so that it can be referenced by a template created with the grid-template-areas property. You can see how it's used in the grid-template-area example.

<Box sx={{ gridArea: 'header' }}>

API

import { flexbox } from '@material-ui/system';
Import name Prop CSS property Theme key
gap gap gap none
columnGap columnGap column-gap none
rowGap rowGap row-gap none
gridColumn gridColumn grid-column none
gridRow gridRow grid-row none
gridAutoFlow gridAutoFlow grid-auto-flow none
gridAutoColumns gridAutoColumns grid-auto-columns none
gridAutoRows gridAutoRows grid-auto-rows none
gridTemplateColumns gridTemplateColumns grid-template-columns none
gridTemplateRows gridTemplateRows grid-template-rows none
gridTemplateAreas gridTemplateAreas grid-template-areas none
gridArea gridArea grid-area none