@input-output-hk/react-grid NPM

Install

npm i --save @input-output-hk/react-grid

yarn add @input-output-hk/react-grid

Dependencies

React

Quick start

Add the provider to your top level component (See React context API docs for more info)

import { Provider } from '@input-output-hk/react-grid'

...

export default () => (
  <Provider>
    ...
    <MyApp />
    ...
  </Provider>
)

Use the grid under the Provider tree

import { Grid, Row, Column } from '@input-output-hk/react-grid'

...

export default () => (
  <Grid>
    <Row sm={1}>
      <Column>Column 1 content</Column>
      <Column>Column 2 content</Column>
    </Row>
  </Grid>
)

The example above will render a grid with 2 columns of equal width, when the screen width reaches the sm breakpoint there will be two rows with a single column

API

Grid

Each grid layout starts with the Grid component. The Grid must contain at least one child Row component. No other component types should be child components of a Grid.

PROP	TYPE	DEFAULT VALUE	REQUIRED	DESCRIPTION
fillRows	boolean	false	false	When a maximum amount of columns is specified on a row, but there are not enough columns to fill that row, enabling `fillRows` will add empty columns.
spacing	number	0	false	Adds vertical padding to the grid component in `rem` units
style	object	null	false	React style object
className	string	null	false	React className
children	ReactNode	null	true	Child components, either a single node or array of nodes. Each node must be a `Row` component

Row

Each Row component must be a direct child of a Grid. Each Row should have at least one Column child component. No other component types should be child components of a Row.

PROP	TYPE	DEFAULT VALUE	REQUIRED	DESCRIPTION
spacing	number	0	false	Vertical padding applied to the row, in `rem` units.
columnSpacing	number	0	false	Horizontal padding applied to each column, in `rem` units. Columns can individually override this value.
xl	number	null	false	The amount of columns per row on `xl` screen widths.
lg	number	null	false	The amount of columns per row on `lg` screen widths. Inherits from `xl`.
md	number	null	false	The amount of columns per row on `md` screen widths. Inherits from `lg`.
sm	number	null	false	The amount of columns per row on `sm` screen widths. Inherits from `md`.
xs	number	null	false	The amount of columns per row on `xs` screen widths. Inherits from `sm`.

Any props not listed in the table are automatically added.

Column

Each Column component must be a direct child of a Row. Columns can contain anything, even more grids.

PROP	TYPE	DEFAULT VALUE	REQUIRED	DESCRIPTION
size	number	1	false	The size value applied as `flex`
spacing	number	0	false	Horizontal padding applied to the column, in `rem` units.
verticalAlign	string	null	false	One of `top`, `center` or `bottom`. How to vertically align content within column relative to the row
xlOffset	number	0	false	How many columns to offset on `xl` screen widths.
lgOffset	number	0	false	How many columns to offset on `lg` screen widths. Inherits from `xl`.
mdOffset	number	0	false	How many columns to offset on `md` screen widths. Inherits from `lg`.
smOffset	number	0	false	How many columns to offset on `sm` screen widths. Inherits from `md`.
xsOffset	number	0	false	How many columns to offset on `xs` screen widths. Inherits from `sm`.

Any props not listed in the table are automatically added.

Provider

The provider state component comes from the React context API and is used to set the screen width breakpoints.

PROP	TYPE	DEFAULT VALUE	REQUIRED	DESCRIPTION
children	ReactNode	null	true	Children to render under the provider tree
screenSizes	object	null	false	Object containing the screen sizes. See the screen sizes schema for details.

Screen sizes schema

KEY	TYPE	DEFAULT VALUE	REQUIRED	DESCRIPTION
xl	number	1200	false	Anything greater than this number (included) is an `xl` screen
lg	number	992	false	Anything between this number (included) and `xl` is an `lg` screen
md	number	768	false	Anything between this number (included) and `lg` is an `md` screen
sm	number	576	false	Anything less than this is `xs`, anything between this number (included) and `md` is an `sm` screen