Griss cells

Cells module for Griss.

Overview

Extends Griss by adding a set of cell classes based on fractions —from halves to sixths— with three available breakpoints to adjust the size at different screen widths.

Key features:

Fluid cells based on fractions.
Responsive and mobile-first.
Lightweight (~350 bytes minified and gzipped).
Extensible using the different available modules or your own code.

Installation

Install it using npm:

npm install griss-cells

Or simply download the minified file and include it into your project:

<link href="griss-cells.min.css" rel="stylesheet" />

You will also need to install Griss core module.

Usage

Make sure you have read Griss core documentation first.

Combine the base cell class —gs-Grid-cell— with the class that defines the cell size that you need for your content —i.e. gs-Grid-cell--size(1/2).

To define the size of each cell you can choose any fraction from halves to sixths or use only the base cell class if you want it to be as wide as its container.

If you need to make adjustments at different screen widths use any of the available breakpoint suffixes: @s, @m and @l —i.e. gs-Grid-cell--size(1/2)@m.

Examples

Some basic examples:

A grid using halves:

<div class="gs-Grid">
  <div class="gs-Grid-cell gs-Grid-cell--size(1/2)"> ... </div>
  <div class="gs-Grid-cell gs-Grid-cell--size(1/2)"> ... </div>
</div>

A grid using fifths:

<ul class="gs-Grid">
  <li class="gs-Grid-cell gs-Grid-cell--size(3/5)"> ... </li>
  <li class="gs-Grid-cell gs-Grid-cell--size(1/5)"> ... </li>
  <li class="gs-Grid-cell gs-Grid-cell--size(1/5)"> ... </li>
</ul>

A grid using halves and fifths at different breakpoints:

<div class="gs-Grid">
  <div class="gs-Grid-cell gs-Grid-cell--size(1/2)@s Grid-cell--size(3/5)@m"> ... </div>
  <div class="gs-Grid-cell gs-Grid-cell--size(1/2)@s Grid-cell--size(2/5)@m"> ... </div>
</div>

For more examples, please check out the test page.

Available classes

Base

gs-Grid-cell--size(1/2)
gs-Grid-cell--size(1/3)
gs-Grid-cell--size(2/3)
gs-Grid-cell--size(1/4)
gs-Grid-cell--size(2/4)
gs-Grid-cell--size(3/4)
gs-Grid-cell--size(1/5)
gs-Grid-cell--size(2/5)
gs-Grid-cell--size(3/5)
gs-Grid-cell--size(4/5)
gs-Grid-cell--size(1/6)
gs-Grid-cell--size(2/6)
gs-Grid-cell--size(3/6)
gs-Grid-cell--size(4/6)
gs-Grid-cell--size(5/6)

Breakpoints

gs-Grid-cell--size(n/n)@s
gs-Grid-cell--size(n/n)@m
gs-Grid-cell--size(n/n)@l

n/n should be replaced with an available fraction.

Browser support

The following browsers are supported:

Chrome latest 5
Firefox latest 5
Internet Explorer 8+
Edge latest 5
Opera latest 5
Safari latest 5
iOS Safari latest 5
Android Browser 2.1+

IE8 does not support media queries.

Contributing

Contributions are welcome! Please, read the contribution guidelines first.

License

Released under the MIT license.

battaglr/griss-cells