Margins

A set of commonly used margin spacing utilities with module mixins for responsive modifiers.

Utilities (anchor)

Margin utilities and property values
Utility name Property values
Margin
.m-auto margin: auto
.m-0 margin: 0
.m-1 margin: 0.25rem
.m-2 margin: 0.5rem
.m-3 margin: 1rem
.m-4 margin: 1.5rem
.m-5 margin: 2rem
Margin block
.my-auto margin-block: auto
.my-0 margin-block: 0
.my-1 margin-block: 0.25rem
.my-2 margin-block: 0.5rem
.my-3 margin-block: 1rem
.my-4 margin-block: 1.5rem
.my-5 margin-block: 2rem
Margin block start
.mt-auto margin-block-start: auto
.mt-0 margin-block-start: 0
.mt-1 margin-block-start: 0.25rem
.mt-2 margin-block-start: 0.5rem
.mt-3 margin-block-start: 1rem
.mt-4 margin-block-start: 1.5rem
.mt-5 margin-block-start: 2rem
Margin block end
.mb-auto margin-block-end: auto
.mb-0 margin-block-end: 0
.mb-1 margin-block-end: 0.25rem
.mb-2 margin-block-end: 0.5rem
.mb-3 margin-block-end: 1rem
.mb-4 margin-block-end: 1.5rem
.mb-5 margin-block-end: 2rem
Margin inline
.mx-auto margin-inline: auto
.mx-0 margin-inline: 0
.mx-1 margin-inline: 0.25rem
.mx-2 margin-inline: 0.5rem
.mx-3 margin-inline: 1rem
.mx-4 margin-inline: 1.5rem
.mx-5 margin-inline: 2rem
Margin inline start
.ms-auto margin-inline-start: auto
.ms-0 margin-inline-start: 0
.ms-1 margin-inline-start: 0.25rem
.ms-2 margin-inline-start: 0.5rem
.ms-3 margin-inline-start: 1rem
.ms-4 margin-inline-start: 1.5rem
.ms-5 margin-inline-start: 2rem
Margin inline end
.me-auto margin-inline-end: auto
.me-0 margin-inline-end: 0
.me-1 margin-inline-end: 0.25rem
.me-2 margin-inline-end: 0.5rem
.me-3 margin-inline-end: 1rem
.me-4 margin-inline-end: 1.5rem
.me-5 margin-inline-end: 2rem

Responsive mixins (anchor)

Responsive modifier mixins are provided to include where required in custom breakpoints, the utilities available use the following modifier class naming convention:

.m-auto
.m-auto-xxl
.m-auto-xl
.m-auto-lg
.m-auto-md
.m-auto-sm
.m-auto-xs
.m-auto-xxs

Using the module (anchor)

Load StyleMods as demonstrated (change file path as required) then include the Sass mixin anywhere below.

custom.scss
@use "stylemods/scss" as *;
@include margins-css;

// Example breakpoint
@media (width <= 480px) {
  @include margins-sm-css;
}

See the using modules page for more information including how to compile the modules in cascade layers and include and reuse them in multiple source files.

Using the framework (anchor)

Using the recommended custom setup enable the styles (and required breakpoints) in an overrides document:

overrides.scss
@use "stylemods/scss/configuration" as *;
$enable-margins:      true;
$enable-margins-sm:   true;

Include the overrides and the framework styles with your custom document for compiling the framework:

custom.scss
@use "overrides";
@use "stylemods/scss/stylemods";

See using the framework for more information including how the styles can also be compiled within cascade layers.

Source code (anchor)

The modules and framework use the same source code, see Sass variables and Sass maps on the customizing page to learn how to customize the default values and styles.

margins.scss
// ------------------------------------------------------------
// Margins
// ------------------------------------------------------------
$margin-auto:   auto;
$margin-0:      0;
$margin-1:      0.25rem !default;
$margin-2:      0.5rem !default;
$margin-3:      1rem !default;
$margin-4:      1.5rem !default;
$margin-5:      2rem !default;

$margins-sizes: (
  "auto": $margin-auto,
  "0": $margin-0,
  "1": $margin-1,
  "2": $margin-2,
  "3": $margin-3,
  "4": $margin-4,
  "5": $margin-5,
) !default;

@mixin margins-css {
  @each $name, $value in $margins-sizes {
    .m-#{$name} {
      margin: #{$value};        
    }
  }  
  
  @each $name, $value in $margins-sizes {
    .mt-#{$name} {
      margin-block-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .mb-#{$name} {
      margin-block-end: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .ms-#{$name} {
      margin-inline-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .me-#{$name} {
      margin-inline-end: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .my-#{$name} {
      margin-block: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .mx-#{$name} {
      margin-inline: #{$value};        
    }
  }
}

// Breakpoints
// XXL
@mixin margins-xxl-css {
  @each $name, $value in $margins-sizes {
    .m-#{$name}-xxl {
      margin: #{$value};        
    }
  }  
  
  @each $name, $value in $margins-sizes {
    .mt-#{$name}-xxl {
      margin-block-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .mb-#{$name}-xxl {
      margin-block-end: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .ms-#{$name}-xxl {
      margin-inline-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .me-#{$name}-xxl {
      margin-inline-end: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .my-#{$name}-xxl {
      margin-block: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .mx-#{$name}-xxl {
      margin-inline: #{$value};        
    }
  }
}

// XL
@mixin margins-xl-css {
  @each $name, $value in $margins-sizes {
    .m-#{$name}-xl {
      margin: #{$value};        
    }
  }  
  
  @each $name, $value in $margins-sizes {
    .mt-#{$name}-xl {
      margin-block-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .mb-#{$name}-xl {
      margin-block-end: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .ms-#{$name}-xl {
      margin-inline-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .me-#{$name}-xl {
      margin-inline-end: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .my-#{$name}-xl {
      margin-block: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .mx-#{$name}-xl {
      margin-inline: #{$value};        
    }
  }
}

// LG
@mixin margins-lg-css {
  @each $name, $value in $margins-sizes {
    .m-#{$name}-lg {
      margin: #{$value};        
    }
  }  
  
  @each $name, $value in $margins-sizes {
    .mt-#{$name}-lg {
      margin-block-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .mb-#{$name}-lg {
      margin-block-end: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .ms-#{$name}-lg {
      margin-inline-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .me-#{$name}-lg {
      margin-inline-end: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .my-#{$name}-lg {
      margin-block: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .mx-#{$name}-lg {
      margin-inline: #{$value};        
    }
  }
}

// MD
@mixin margins-md-css {
  @each $name, $value in $margins-sizes {
    .m-#{$name}-md {
      margin: #{$value};        
    }
  }  
  
  @each $name, $value in $margins-sizes {
    .mt-#{$name}-md {
      margin-block-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .mb-#{$name}-md {
      margin-block-end: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .ms-#{$name}-md {
      margin-inline-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .me-#{$name}-md {
      margin-inline-end: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .my-#{$name}-md {
      margin-block: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .mx-#{$name}-md {
      margin-inline: #{$value};        
    }
  }
}

// SM
@mixin margins-sm-css {
  @each $name, $value in $margins-sizes {
    .m-#{$name}-sm {
      margin: #{$value};        
    }
  }  
  
  @each $name, $value in $margins-sizes {
    .mt-#{$name}-sm {
      margin-block-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .mb-#{$name}-sm {
      margin-block-end: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .ms-#{$name}-sm {
      margin-inline-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .me-#{$name}-sm {
      margin-inline-end: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .my-#{$name}-sm {
      margin-block: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .mx-#{$name}-sm {
      margin-inline: #{$value};        
    }
  }
}


// XS
@mixin margins-xs-css {
  @each $name, $value in $margins-sizes {
    .m-#{$name}-xs {
      margin: #{$value};        
    }
  }  
  
  @each $name, $value in $margins-sizes {
    .mt-#{$name}-xs {
      margin-block-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .mb-#{$name}-xs {
      margin-block-end: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .ms-#{$name}-xs {
      margin-inline-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .me-#{$name}-xs {
      margin-inline-end: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .my-#{$name}-xs {
      margin-block: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .mx-#{$name}-xs {
      margin-inline: #{$value};        
    }
  }
}

// XXS
@mixin margins-xxs-css {
  @each $name, $value in $margins-sizes {
    .m-#{$name}-xxs {
      margin: #{$value};        
    }
  }  
  
  @each $name, $value in $margins-sizes {
    .mt-#{$name}-xxs {
      margin-block-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .mb-#{$name}-xxs {
      margin-block-end: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .ms-#{$name}-xxs {
      margin-inline-start: #{$value};        
    }
  }
  
  @each $name, $value in $margins-sizes {
    .me-#{$name}-xxs {
      margin-inline-end: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .my-#{$name}-xxs {
      margin-block: #{$value};        
    }
  }
    
  @each $name, $value in $margins-sizes {
    .mx-#{$name}-xxs {
      margin-inline: #{$value};        
    }
  }
}