SimpleGrid

If you're like me, I tend to always check the MDN docs for anything css grid.

SimpleGrid provides a friendly interface to create responsive grid layouts with ease. It renders a div element with display: grid.

Import#

Usage#

Specifying the number of columns for the grid layout.

Editable Example

You can also make it responsive by passing array or object values into the columns prop.

Editable Example

Auto-responsive grid#

To make the grid responsive adjust automatically without passing columns, simply pass the minChildWidth prop to specify the min-width a child should have before adjusting the layout.

This uses css grid auto-fit and minmax() internally.

Editable Example

Changing the spacing for columns and rows#

Simply pass the spacing prop to change the row and column spacing between the grid items. SimpleGrid also allows you pass spacingX and spacingY to define the space between columns and rows respectively.

Editable Example

Props#

SimpleGrid composes Box so you can pass all the Box props and css grid props with addition of these:

NameTypeDefaultDescription
columnsnumberThe number of columns
spacingGridProps["gridGap"]The gap between the grid items
spacingXGridProps["gridGap"]The column gap between the grid items
spacingYGridProps["gridGap"]The row gap between the grid items
minChildWidthCSSProperties["minWidth"]The width at which child elements will break into columns. Pass a number for pixel values or a string for any other valid CSS length.

Proudly made in 🇳🇬

Released under the MIT License.

Copyright © 2020 Segun Adebayo