react-xy-grid v1.0.0
react-xy-grid
React component that wraps Foundation's XY Grid.
Table of Contents
Installation
Begin by installing the package as a dependency.
npm i -S react-xy-gridStart utilizing the components where needed.
import * as React from "react";
import { Cell, Grid, GridContainer } from "react-xy-grid";
const Home = () => {
return (
<GridContainer>
<Grid gridX valign="middle">
<Cell sm={12} lg={6}>
<span>Lorem ipsum dolor sit, amet consectetur adipisicing elit.</span>
</Cell>
<Cell sm={12} lg={6}>
<a href="/explicabo">Explicabo!</a>
</Cell>
</Grid>
</GridContainer>
);
};
export default Home;Cell
| Name | Type | Required | Default Value |
|---|---|---|---|
auto | boolean | false | false |
children | ReactNode | true | undefined |
className | string | false | undefined |
component | string | false | "div" |
lg | "auto", "shrink", 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12 | false | undefined |
lgOffset | 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12 | false | undefined |
md | "auto", "shrink", 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12 | false | undefined |
mdOffset | 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12 | false | undefined |
shrink | boolean | false | false |
sm | "auto", "shrink", 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12 | false | undefined |
smOffset | 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12 | false | undefined |
valign | "bottom", "middle", "stretch", or "top" | false | undefined |
Grid
| Name | Type | Required | Default Value |
|---|---|---|---|
align | "center", "justify", "right", or "spaced" | false | undefined |
children | ReactNode | true | undefined |
className | string | false | undefined |
component | string | false | "div" |
gridX | boolean | false | false |
gridY | boolean | false | false |
height | number or string | false | undefined |
lgCollapse | "margin" or "padding" | false | undefined |
lgUp | 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12 | false | undefined |
marginX | boolean | false | false |
marginY | boolean | false | false |
mdCollapse | "margin" or "padding" | false | undefined |
mdUp | 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12 | false | undefined |
paddingX | boolean | false | false |
paddingY | boolean | false | false |
smCollapse | "margin" or "padding" | false | undefined |
smUp | 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12 | false | undefined |
valign | "bottom", "middle", "stretch", or "top" | false | undefined |
Grid Container
| Name | Type | Required | Default Value |
|---|---|---|---|
children | ReactNode | true | undefined |
className | string | false | undefined |
component | string | false | "div" |
fluid | boolean | false | false |
full | boolean | false | false |
Notes
If you import the components for use via the module namespace like so:
import { Cell, Grid, GridContainer } from "react-xy-grid";Using this syntax, you will not have to manually import the CSS file as the module's index file import's a compiled CSS version of the Foundation styles.
This assumes that your build system is configured to handle importing
.cssfiles in your scripts.
However, there is a .scss in the module's directory that can be used to generate the Foundation styles at compile time. If this is the desired result, you will need to adjust the above import statement, to avoid importing the .css file.
import Cell from "react-xy-grid/Cell/Cell";
import Grid from "react-xy-grid/Grid/Grid";
import GridContainer from "react-xy-grid/GridContainer/GridContainer";This may be valuable if your build system is not configured to handle importing
.cssfiles in your scripts.
Additionally, you will have to import the module's .scss file.
@import "~react-xy-grid/index.scss";
// or
@import "../../node_modules/react-xy-grid/index.scss";The first import example assumes your sass compiler supports the
~syntax to import fromnode_modules