Spacing

Use shorthand margin and padding utility classes to control spacing between elements.

Notation

Spacing utility classes can be defined using the format -{property}{sides}[-{breakpoint}]--{size}.

{property}

m - use to apply margin
p - use to apply padding

{sides}

t - use to apply margin-top or padding-top
b - use to apply margin-bottom or padding-bottom
l - use to apply margin-left or padding-left
r - use to apply margin-right or padding-right
x - use to apply margin-left and margin-right or padding-left and padding-right
y - use to apply margin-top and margin-bottom or padding-top and padding-bottom
blank - leave blank to apply margin or padding to all 4 sides.

{breakpoint}

Optionally, include -{breakpoint} to apply the utility behaviour to some breakpoints. As a mobile-first library, any applying to smaller breakpoints will also modify larger ones unless another class overrides this behaviour.

blank - leave blank to apply margin or padding to all breakpoints.
sm - use to apply margin or padding to sm and larger breakpoints.
md - use to apply margin or padding to md and larger breakpoints.
lg - use to apply margin or padding to lg and larger breakpoints.
xl - use to apply margin or padding to xl breakpoints.

{size}

0 - use to eliminate existing margin or padding and set to 0
1 - use to set margin or padding to $base-unit
2 - use to set margin or padding to $base-unit * 2
3 - use to set margin or padding to $base-unit * 3
4 - use to set margin or padding to $base-unit * 4
5 - use to set margin or padding to $base-unit * 5
6 - use to set margin or padding to $base-unit * 6
7 - use to set margin or padding to $base-unit * 7
8 - use to set margin or padding to $base-unit * 8
9 - use to set margin or padding to $base-unit * 9
10 - use to set margin or padding to $base-unit * 10
auto - use to set margin to auto value

Examples

Margins

In this example, various margin classes have been applied to render margin on all 4 sides of the blue squares. The margin can be visualized in blue.

<div class="-m--2"></div>
<div class="-m--4"></div>
<div class="-m--6"></div>

Side Margins

Apply margin to specific sides of an element by adding t, b, l, r, x or y to the class name.

<!-- margin-top -->
<div class="-mt--3"></div>
<!-- margin-bottom -->
<div class="-mb--3"></div>
<!-- margin-left -->
<div class="-ml--3"></div>
<!-- margin-right -->
<div class="-mr--3"></div>
<!-- margin-left and margin-right -->
<div class="-mx--3"></div>
<!-- margin-top and margin-bottom -->
<div class="-my--3"></div>

Padding

In this example, various padding classes have been applied to render padding on all 4 sides of the blue squares. The padding can be visualized in yellow.

<div class="-p--2"></div>
<div class="-p--4"></div>
<div class="-p--6"></div>

Side Paddings

Apply padding to specific sides of an element by adding t, b, l, r, x or y to the class name.

<!-- padding-top -->
<div class="-pt--3"></div>
<!-- padding-bottom -->
<div class="-pb--3"></div>
<!-- padding-left -->
<div class="-pl--3"></div>
<!-- padding-right -->
<div class="-pr--3"></div>
<!-- padding-left and padding-right -->
<div class="-px--3"></div>
<!-- padding-top and padding-bottom -->
<div class="-py--3"></div>

Margin + Padding

Apply both margin and padding to an element by adding both class names.

<div class="-m--3 -p--3"></div>

Auto margin

Apply margin auto to an element

<div class="-m--auto"></div>

Breakpoints

Target specific breakpoints with responsive classes.

<div class="-mx--0 -px--0 -mx-lg--6 -px-lg--6"></div>