Align

Align utilities for grid and flex display with module mixins for responsive modifiers.

Utilities (anchor)

Align utility names and property values
Utility name Property values
Align content
.align-content-flex-start align-content: flex-start
.align-content-flex-end align-content: flex-end
.align-content-start align-content: start
.align-content-end align-content: end
.align-content-center align-content: center
.align-content-around align-content: space-around
.align-content-between align-content: space-between
.align-content-evenly align-content: space-evenly
Align items
.align-items-flex-start align-items: flex-start
.align-items-flex-end align-items: flex-end
.align-items-start align-items: start
.align-items-end align-items: end
.align-items-center align-items: center
Align self
.align-self-flex-start align-self: flex-start
.align-self-flex-end align-self: flex-end
.align-self-start align-self: start
.align-self-end align-self: end
.align-self-center align-self: center

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:

.align-items-start
.align-items-start-xxl
.align-items-start-xl
.align-items-start-lg
.align-items-start-md
.align-items-start-sm
.align-items-start-xs
.align-items-start-xxs

The optional justify and place utility styles can also be used with the align utilities if included.

Using the module (anchor)

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

Each set of utilities can be included individually:

custom.scss
@use "stylemods/scss" as *;
@include align-content-css;
@include align-items-css;
@include align-self-css;

// Example breakpoint
@media (width <= 480px) {
  @include align-content-sm-css;
  @include align-items-sm-css;
  @include align-self-sm-css;
}

Or included grouped in a single mixin:

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

// Example breakpoint
@media (width <= 480px) {
  @include alignment-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-align:      true;
$enable-align-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 maps to learn how to customize the values below.

align.scss
//  ------------------------------------------------------------
//  Align
//  ------------------------------------------------------------
$align-content-values: (
  "flex-start": flex-start,
  "flex-end": flex-end,
  "start": start,
  "end": end,
  "center": center,
  "around": space-around,
  "between": space-between,
  "evenly": space-evenly,
) !default;

$align-items-self-values: (
  "flex-start": flex-start,
  "flex-end": flex-end,
  "start": start,
  "end": end,
  "center": center,
) !default;

@mixin align-content-css {  
  @each $name, $value in $align-content-values {
    .align-content-#{$name} {
      align-content: #{$value};
    }
  }
}

@mixin align-items-css {  
  @each $name, $value in $align-items-self-values {
    .align-items-#{$name} {
      align-items: #{$value};
    }
  }
}

@mixin align-self-css { 
  @each $name, $value in $align-items-self-values {
    .align-self-#{$name} {
      align-self: #{$value};
    }
  }
}

// Breakpoint XXL
@mixin align-content-xxl-css {  
  @each $name, $value in $align-content-values {
    .align-content-#{$name}-xxl {
      align-content: #{$value};
    }
  }
}

@mixin align-items-xxl-css {  
  @each $name, $value in $align-items-self-values {
    .align-items-#{$name}-xxl {
      align-items: #{$value};
    }
  }
}

@mixin align-self-xxl-css { 
  @each $name, $value in $align-items-self-values {
    .align-self-#{$name}-xxl {
      align-self: #{$value};
    }
  }
}

// Breakpoint XL
@mixin align-content-xl-css {  
  @each $name, $value in $align-content-values {
    .align-content-#{$name}-xl {
      align-content: #{$value};
    }
  }
}

@mixin align-items-xl-css {  
  @each $name, $value in $align-items-self-values {
    .align-items-#{$name}-xl {
      align-items: #{$value};
    }
  }
}

@mixin align-self-xl-css { 
  @each $name, $value in $align-items-self-values {
    .align-self-#{$name}-xl {
      align-self: #{$value};
    }
  }
}

// Breakpoint LG
@mixin align-content-lg-css {  
  @each $name, $value in $align-content-values {
    .align-content-#{$name}-lg {
      align-content: #{$value};
    }
  }
}

@mixin align-items-lg-css {  
  @each $name, $value in $align-items-self-values {
    .align-items-#{$name}-lg {
      align-items: #{$value};
    }
  }
}

@mixin align-self-lg-css { 
  @each $name, $value in $align-items-self-values {
    .align-self-#{$name}-lg {
      align-self: #{$value};
    }
  }
}

// Breakpoint MD
@mixin align-content-md-css {  
  @each $name, $value in $align-content-values {
    .align-content-#{$name}-md {
      align-content: #{$value};
    }
  }
}

@mixin align-items-md-css {  
  @each $name, $value in $align-items-self-values {
    .align-items-#{$name}-md {
      align-items: #{$value};
    }
  }
}

@mixin align-self-md-css { 
  @each $name, $value in $align-items-self-values {
    .align-self-#{$name}-md {
      align-self: #{$value};
    }
  }
}

// Breakpoint SM
@mixin align-content-sm-css {  
  @each $name, $value in $align-content-values {
    .align-content-#{$name}-sm {
      align-content: #{$value};
    }
  }
}

@mixin align-items-sm-css {  
  @each $name, $value in $align-items-self-values {
    .align-items-#{$name}-sm {
      align-items: #{$value};
    }
  }
}

@mixin align-self-sm-css { 
  @each $name, $value in $align-items-self-values {
    .align-self-#{$name}-sm {
      align-self: #{$value};
    }
  }
}

// Breakpoint XS
@mixin align-content-xs-css {  
  @each $name, $value in $align-content-values {
    .align-content-#{$name}-xs {
      align-content: #{$value};
    }
  }
}

@mixin align-items-xs-css {  
  @each $name, $value in $align-items-self-values {
    .align-items-#{$name}-xs {
      align-items: #{$value};
    }
  }
}

@mixin align-self-xs-css { 
  @each $name, $value in $align-items-self-values {
    .align-self-#{$name}-xs {
      align-self: #{$value};
    }
  }
}

// Breakpoint XXS
@mixin align-content-xxs-css {  
  @each $name, $value in $align-content-values {
    .align-content-#{$name}-xxs {
      align-content: #{$value};
    }
  }
}

@mixin align-items-xxs-css {  
  @each $name, $value in $align-items-self-values {
    .align-items-#{$name}-xxs {
      align-items: #{$value};
    }
  }
}

@mixin align-self-xxs-css { 
  @each $name, $value in $align-items-self-values {
    .align-self-#{$name}-xxs {
      align-self: #{$value};
    }
  }
}

// Grouped mixins
@mixin align-css {
  @include align-content-css;
  @include align-items-css;
  @include align-self-css;
}

@mixin align-xxl-css {
  @include align-content-xxl-css;
  @include align-items-xxl-css;
  @include align-self-xxl-css;
}

@mixin align-xl-css {
  @include align-content-xl-css;
  @include align-items-xl-css;
  @include align-self-xl-css;
}

@mixin align-lg-css {
  @include align-content-lg-css;
  @include align-items-lg-css;
  @include align-self-lg-css;
}

@mixin align-md-css {
  @include align-content-md-css;
  @include align-items-md-css;
  @include align-self-md-css;
}

@mixin align-sm-css {
  @include align-content-sm-css;
  @include align-items-sm-css;
  @include align-self-sm-css;
}

@mixin align-xs-css {
  @include align-content-xs-css;
  @include align-items-xs-css;
  @include align-self-xs-css;
}

@mixin align-xxs-css {
  @include align-content-xxs-css;
  @include align-items-xxs-css;
  @include align-self-xxs-css;
}