Flexr
React Flexbox grid made simple. 💪 Based on the "Solved-by-flexbox"-grid
Usage
Base example.
;; { return <Grid> <Cell>1/3</Cell> <Cell>1/3</Cell> <Cell>1/3</Cell> </Grid> ; }
If you don't use webpack with css-loader, make sure to include the react-flexr/styles.css
somewhere in your project. For more advanced use cases, the Stilr
stylesheet is also exposed.
Cell sizes can be controlled with fractions.
;; { return <Grid> <Cell size='6/12'> Fills Half </Cell> <Cell> Fills Rest Yay for Flexbox </Cell> <Cell size=200 lap=150> Fills 150px on lap and 200px everywhere else </Cell> <Cell size=05 lap=025> Fills a quarter on lap and half everywhere else </Cell> <Cell size='3/12'> Fills a quarter </Cell> <Cell palm='3/12' lap='1/2'> Fills a quarter on half on lap and dynamicly sized everywhere else </Cell> <Cell palm='hidden' size='1/2'> Hidden on palm half width otherwise </Cell> </Grid> ; }
Component API:
Grid
; <Grid align= string // Vertical Align Sub Cells: top, center, bottom hAlign= string // Horizontal Align Sub Cells: left, center, right gutter= string // Override default gutter: '1em', '5%', '10px', etc. // Propagates downwards. Cells inside this Grid component will use the same gutter. flexCells= bool // All sub cells will be full height/>
Cell
; <Cell align= string // Vertical Align This Cell: top, center, bottom gutter= string // Override default gutter: '1em', '5%', '10px', etc. flex= bool // Like flexCells above, but for a single cell. size= string | number // Takes a fraction. e.g. 1/6 palm= string | number // Like size, but only for palm devices.* lap= string | number // Like size, but only for lap devices.* portable= string | number // Like size, but only for ( palm + lap ) devices.* desk= string | number // Like size, but only for desk devices.*/>
* Ergonomic breakpoints accepts 'hidden' as well. This will prevent the component from being rendered in that state.
See the example folder for more examples.
Responsive Props
The responsive props are based on ergonomics.
We've used these breakpoints in a variety of apps and grids with success. So far the following breakpoints have beeen implemented:
- Palm
- Lap
- Portable
- Desk
See the breakpoint config object for sizes.
Flexr Helpers
Use these to get the most out of Flexr. Especially findMatch
is very useful when you need to add different behaviour based on window width outside of the grid/cell elements.
string|false findMatch(string arguments)
This is the internal function that Flexr uses to check which ergonomic state it's currently in. It's really useful if you have components outside the grid, that you want to show/hide/manipulate passed properties or stuff in your lifecycle hooks.
The function accepts multipe ergonomic breakpoints as strings and returns the first one matched or false if nothing matches.
Example
;; { const isPalm = ; if isPalm console; return <div> <h1>Only visible in palm:</h1> isPalm ? <h2>Palm</h2> : null <h1>Allows Multiple Matches</h1> ? <h2>Lap or Desk</h2> : null </div> ; }
setBreakpoints( array breakpoints )
It's posible to force flexr to be in a specific ergonomic state. This is primarily usefull when rendering on the server. E.g. looking at the user agent string on rendering the app in palm/portable if it's an iOS/iPhone or lap/portable if iOS/iPad.
Example
;;; const isMobile = /iP|Mobile/; { if isMobile else const html = React; res;}
array|false findBreakpoints()
Force flexr to find the current breakpoints. Returns an array of the current
breakpoints that flexr matches in. If they haven't changed since the last time
findBreakpoints()
was called, false will be returned.
Use in combination with optimizedResize
.
Example
; // First run. Window is sized to match lap. // => ['lap', 'portable']; // Second run. Window not resized. // => false;
optimizedResize.init( function )
Simple resize event throttler. Usefull for force updating when the app have been resized. For best performance, use it in your main app component in the componentDidMount life cycle.
Example
;; { optimizedResize; }
array getBreakpoints()
returns an array of current breakpoints.
Map stylesheet
The internal Stilr stylesheet used to handle basic flexbox styling for the components. Usefull if you need full controll of how the CSS is rendered. Reed the Stilr documentation on how to use Stilr if you need finegrained controll over you styling.
palm, lap, portable, desk
The ergonomic breakpoint media queries that flexr uses internally is also exposed. These are especially useful in combination with Stilr.
Example
;; console // => '@media screen and (max-width: 600px)'; // Stilr usage:const styles = Style;