Margin utilities module for Basscss

Downloads in past


5,741401.0.94 years ago7 years agoMinified + gzip package size for basscss-margin in KB


Immutable margin utilities are based on a global white space scale defined with custom properties. These can dramatically help reduce the size of large stylesheets and allow for greater flexibility and quicker iteration when designing in the browser.

Naming Convention

Due to the ubiquitous nature of setting margin, these utilities use a shorthand naming convention.
  <tr> <th>Shorthand</th> <th>Description</th> </tr>
  <tr> <td>m</td> <td>Margin</td> </tr>
  <tr> <td>t</td> <td>Top</td> </tr>
  <tr> <td>r</td> <td>Right</td> </tr>
  <tr> <td>b</td> <td>Bottom</td> </tr>
  <tr> <td>l</td> <td>Left</td> </tr>
  <tr> <td>x</td> <td>X-axis (left and right)</td> </tr>
  <tr> <td>y</td> <td>Y-axis (top and bottom)</td> </tr>
  <tr> <td>n</td> <td>Negative</td> </tr>
  <tr> <td>0</td> <td>0 reset</td> </tr>
  <tr> <td>1</td> <td>--space-1 (default .5rem)</td> </tr>
  <tr> <td>2</td> <td>--space-2 (default 1rem)</td> </tr>
  <tr> <td>3</td> <td>--space-3 (default 2rem)</td> </tr>
  <tr> <td>4</td> <td>--space-4 (default 4rem)</td> </tr>

Change or reset default margins using the white space scale. Negative x-axis margins are used to offset margins and padding of child elements. Margin auto is used to horizontally center block-level elements with a set width.
.m0  { margin:        0 }
.mt0 { margin-top:    0 }
.mr0 { margin-right:  0 }
.mb0 { margin-bottom: 0 }
.ml0 { margin-left:   0 }
.mx0 { margin-left:   0; margin-right:  0 }
.my0 { margin-top:    0; margin-bottom: 0 }

.m1  { margin:        var(--space-1) }
.mt1 { margin-top:    var(--space-1) }
.mr1 { margin-right:  var(--space-1) }
.mb1 { margin-bottom: var(--space-1) }
.ml1 { margin-left:   var(--space-1) }
.mx1 { margin-left:   var(--space-1); margin-right:  var(--space-1) }
.my1 { margin-top:    var(--space-1); margin-bottom: var(--space-1) }

.m2  { margin:        var(--space-2) }
.mt2 { margin-top:    var(--space-2) }
.mr2 { margin-right:  var(--space-2) }
.mb2 { margin-bottom: var(--space-2) }
.ml2 { margin-left:   var(--space-2) }
.mx2 { margin-left:   var(--space-2); margin-right:  var(--space-2) }
.my2 { margin-top:    var(--space-2); margin-bottom: var(--space-2) }

.m3  { margin:        var(--space-3) }
.mt3 { margin-top:    var(--space-3) }
.mr3 { margin-right:  var(--space-3) }
.mb3 { margin-bottom: var(--space-3) }
.ml3 { margin-left:   var(--space-3) }
.mx3 { margin-left:   var(--space-3); margin-right:  var(--space-3) }
.my3 { margin-top:    var(--space-3); margin-bottom: var(--space-3) }

.m4  { margin:        var(--space-4) }
.mt4 { margin-top:    var(--space-4) }
.mr4 { margin-right:  var(--space-4) }
.mb4 { margin-bottom: var(--space-4) }
.ml4 { margin-left:   var(--space-4) }
.mx4 { margin-left:   var(--space-4); margin-right:  var(--space-4) }
.my4 { margin-top:    var(--space-4); margin-bottom: var(--space-4) }

.mxn1 { margin-left: -var(--space-1); margin-right: -var(--space-1); }
.mxn2 { margin-left: -var(--space-2); margin-right: -var(--space-2); }
.mxn3 { margin-left: -var(--space-3); margin-right: -var(--space-3); }
.mxn4 { margin-left: -var(--space-4); margin-right: -var(--space-4); }

.ml-auto { margin-left: auto }
.mr-auto { margin-right: auto }
.mx-auto { margin-left: auto; margin-right: auto; }

Resetting Margins

To increase information density and to better align elements, remove default margins from typographic elements using the margin utilities.
<h1 class="m0">No margin</h1>
<h1 class="mt0">No margin top</h1>
<h1 class="mb0">No margin bottom</h1>

Add Spacing

Add spacing around elements using a combination of margin utilities.
<div class="mxn1">
  <div class="m1">Hamburger</div>
  <div class="m1">Hamburger</div>
  <div class="m1">Hamburger</div>

The negative margin utilities also work with padded children.
<div class="border">
  <div class="mxn2">
    <div class="px2 border">Padded div</div>

Center Elements

Block elements with a set width can be centered with .mx-auto.
<img src=""
  class="block mx-auto" />

Space Flexbox Items

The .ml-auto, .mr-auto, .mt-auto, and .mb-auto utilities can be used to add spacing around flexbox items.
<div class="flex">
  <div class="ml-auto">Hamburger</div>
  <div>Hot Dog</div>

<div class="flex">
  <div class="mr-auto">Hot Dog</div>

<div class="flex">
  <div class="mt-auto">Hamburger</div>
  <div class="mb-auto">Hot Dog</div>

Margins should never be declared outside of these utilities. This is meant to help create consistency and avoid magic numbers. If, for some reason, the default white space scale does not suit your design, customize and extend it before using it.