react-flexbox-grid


react-flexbox-grid is a set of React components that implement flexboxgrid.css. It even has an optional support for CSS Modules with some extra configuration.

http://roylee0704.github.io/react-flexbox-grid/

Setup
-----

$3

react-flexbox-grid can be installed as an npm package:

``
npm install --save react-flexbox-grid
`

$3

The recommended way to use react-flexbox-grid is with a tool like webpack or Meteor, make sure you set it up to support requiring CSS files. For example, the minimum required loader configuration for webpack would look like this:

`js
{
test: /\.css$/,
loader: 'style-loader!css-loader',
include: /flexboxgrid/
}
`

react-flexbox-grid imports the styles from flexboxgrid, that's why we're configuring the loader for it.

$3

If you want to use CSS Modules (this is _mandatory_ for versions earlier than v1), webpack's css-loader supports this by passing modules param in the loader configuration.

First, install style-loader and css-loader as development dependencies:

`
npm install --save-dev style-loader css-loader
`

Next, add a loader for flexboxgrid with CSS Modules enabled:

`js
{
test: /\.css$/,
loader: 'style-loader!css-loader?modules',
include: /flexboxgrid/
}
`

Make sure you don't have another CSS loader which also affects flexboxgrid. In case you do, exclude flexboxgrid, for example:

`js
{
test: /\.css$/,
loader: 'style-loader!css-loader!postcss-loader',
include: path.join(__dirname, 'node_modules'), // oops, this also includes flexboxgrid
exclude: /flexboxgrid/ // so we have to exclude it
}
`

Otherwise you would end up with an obscure error because webpack stacks loaders together, it doesn't override them.

$3

See this comment.




$3

If you want to use react-flexbox-grid the old-fashioned way, you must generate a build with all the CSS and JavaScript and include it in your index.html. The components will then be exposed in the window object.


Usage
-----

Now you can import and use the components:

`jsx
import React from 'react';
import { Grid, Row, Col } from 'react-flexbox-grid';

class App extends React.Component {
render() {
return (



Hello, world!



);
}
}
`

$3

For the time being always use fluid for to prevent horizontal overflow issues.


Example
-------
Looking for a complete example? Head over to react-flexbox-grid-example.


Advanced composition
-------

We also export functions for generating Row and Column class names for use in other components.

For example, suppose you're using a third party component that accepts className and you would like it to be rendered as Col. You could do so by extracting the column sizing props that MyComponent uses and then pass the generated className on to SomeComponent


`jsx
import React from 'react';
import { Row, Col, getRowProps, getColumnProps } from 'react-flexbox-grid';
// a component that accepts a className
import SomeComponent from 'some-package';

export default function MyComponent(props) {
const colProps = getColumnProps(props);
const rowProps = getRowProps(props);

return (


);
}

MyComponent.propTypes = Object.assign({
onChange: React.PropTypes.func.isRequired,
value: React.PropTypes.string.isRequired,
}, Col.propTypes, Row.propTypes); // Re-use existing Row and Col propType validations

// Can now be rendered as:
``

Contributors
-----------
 |  | 
---|---|---
Roy Lee | Helder Santana | Matija Marohnić

License
-------
MIT