npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@input-output-hk/react-grid

v1.0.3

Published

Bootstrap inspired React responsive grid

Downloads

9

Readme

Contents

  1. Install
  2. Dependencies
  3. Quick start
  4. API
  5. Contributing

Install

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

or

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

Dependencies

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 |

Contributing

Contributions are welcome, see contributing for more info.