bolser-am-strap v3.2.0

AM Strap

A DRY modular styling framework built with SCSS using attribute modules. It is recommended to normalize your project before importing AM Strap. Ensure required browser support by using autoprefixer.

Contents

1. Install
2. Grid
3. Buttons
4. Forms
5. Float
6. Align

Install

bower install bolser-am-strap

Import at the start of your SCSS

@import "./bower_components/bolser-am-strap/all";

Alternatively you can import individual modules. To customise a module, add it's config map with your settings before the import. All dimension keys accept rem, em and px while color keys accept rgba, rgb, hex and named values.

Grid

The grid system is based on Bootstrap but uses attribute modules. Reference their documentation for more details on how to use it - just remember to convert to the relevant attribute module values.

Config

$am-columns: 12;

$am-breakpoints: (
  "xs": (
    "container": fluid,
    "padding": 1rem,
    "width": 0px
  ),
  "sm": (
    "container": fluid,
    "padding": 1rem,
    "width": 420px
  ),
  "md": (
    "container": set,
    "padding": 1rem,
    "width": 768px
  ),
  "lg": (
    "container": set,
    "padding": 2rem,
    "width": 992px
  ),
  "xl": (
    "container": set,
    "padding": 2rem,
    "width": 1200px
  )
);

HTML Usage

Grid layout

<div am-container>
  <div am-row>
    <div am-col="md-6 xs-12"></div>
    <div am-col="md-3 xs-6"></div>
    <div am-col="md-3 xs-6"></div>
  </div>
</div>

Push & pull

<div am-col="sm-6" am-push="sm-6"></div>
<div am-col="sm-6" am-pull="sm-6"></div>

Offset

<div am-col="md-6" am-offset="md-3"></div>

Hidden & visible

<div am-col="md-6" am-hidden="xs sm"></div>
<div am-col="xs-12" am-visible="xs sm"></div>

CSS Usage

Target specific breakpoint

@media #{$only-sm} {
  // Styles for sm only
}

Target screens above breakpoint

@media #{$above-md} {
  // Styles for above md
}

Target screens below breakpoint

@media #{$below-lg} {
  // Styles for below lg
}

Buttons

Config

$am-btn: (
  "fill-color": #ffffff,
  "fill-background": #333333,
  "ghost-color": #111111,
  "ghost-border-color": #111111,
  "ghost-border-width": 2px,
  "height": 3rem,
  "loading-background": #333333
);

Usage

Values include: ghost and fill. Additional hover state values include: tick and arrow.

<a href="" am-btn="ghost">Read more</a>
<a href="" am-btn="fill">Read more</a>
<a href="" am-btn="ghost tick">Submit</a>
<a href="" am-btn="fill arrow">Next</a>

Forms

Config

$am-form: (
  "background-color": transparent,
  "border-color": #cccccc,
  "border-width": 2px,
  "checkbox-height": 2rem,
  "color": #111111,
  "input-height": 3rem,
  "padding": 1rem,
  "placeholder-color": #888888,
  "response-negative-color": #ed9696,
  "response-positive-color": #9bd49b
);

Usage

Input

<input type="text" am-form="input" />

Textarea

<textarea am-form="textarea"></textarea>

Select box

<div am-form="select">
  <select>
    <option selected="true" disabled="disabled">--Select--</option>
    <option value="Option 1">Option 1</option>
   <option value="Option 2">Option 2</option>
  </select>
</div>

Checkbox

<div am-form="checkbox">
  <input type="checkbox" id="checkbox1" />
  <label for="checkbox1"></label>
  <label for="checkbox1">Accept our terms and conditions</label>
</div>

Float

Usage

Values include: clear, left, right, none, initial and inherit.

<div am-float="clear">
  <div am-float="left">
    Element floated left
  </div>
  <div am-float="right">
    Element floated right
  </div>
</div>

Align

Usage

Values include: left, right, center, justify, initial and inherit.

<div am-align="left">
  Text is left aligned
</div>