Grid layouts

Grid column and row page layout utilities with module mixins for responsive modifiers.

Examples (anchor)

The grid is based on 12 columns by default but can be customized before compiling and/or after using variable styles.

1
2
3
<div class="grid-col gap-2">
<div class="col-3">1</div>
<div class="col-6">2</div>
<div class="col-3">3</div>
</div>

The columns and rows can be combined for simple content layouts:

1
2
3
4
<div class="grid-col gap-2">
<div class="col-3 row-2">1</div>
<div class="col-6">2</div>
<div class="col-3 row-2">3</div>
<div class="col-6">4</div>
</div>

Use the grid start and end modifiers to rearrange content flow:

1
2
3
4
<div class="grid-col gap-2">
<div class="col-3 row-2">1</div>
<div class="col-6">2</div>
<div class="col-start-4 col-6">3</div>
<div class="col-3 col-start-10 row-start-1 row-end-3">4</div>
</div>

All the utilities are shown in the following table, combine these with the selected responsive modifiers included (see below) to resize the columns and rows and rearrange content at custom breakpoints.

Utilities (anchor)

Grid column utilities
Utility class Property values
Grid columns utility
.grid-cols display: grid;
grid-template-columns: repeat(var(--columns, 12), minmax(0, 1fr));
grid-template-rows: repeat(var(--rows, 1), minmax(0, 1fr));
Grid columns
.col-1 grid-column: auto/span 1
.col-2 grid-column: auto/span 2
.col-3 grid-column: auto/span 3
.col-4 grid-column: auto/span 4
.col-5 grid-column: auto/span 5
.col-6 grid-column: auto/span 6
.col-7 grid-column: auto/span 7
.col-8 grid-column: auto/span 8
.col-9 grid-column: auto/span 9
.col-10 grid-column: auto/span 10
.col-11 grid-column: auto/span 11
.col-12 grid-column: auto/span 12
Grid column start
.col-start-1 grid-column-start: 1
.col-start-2 grid-column-start: 2
.col-start-3 grid-column-start: 3
.col-start-4 grid-column-start: 4
.col-start-5 grid-column-start: 5
.col-start-6 grid-column-start: 6
.col-start-7 grid-column-start: 7
.col-start-8 grid-column-start: 8
.col-start-9 grid-column-start: 9
.col-start-10 grid-column-start: 10
.col-start-11 grid-column-start: 11
Grid column end
.col-end-1 grid-column-end: 1
.col-end-2 grid-column-end: 2
.col-end-3 grid-column-end: 3
.col-end-4 grid-column-end: 4
.col-end-5 grid-column-end: 5
.col-end-6 grid-column-end: 6
.col-end-7 grid-column-end: 7
.col-end-8 grid-column-end: 8
.col-end-9 grid-column-end: 9
.col-end-10 grid-column-end: 10
.col-end-11 grid-column-end: 11
.col-end-12 grid-column-end: 12
Grid row utilities
Utility class Property values
.row-1 grid-row: auto/span 1
.row-2 grid-row: auto/span 2
.row-3 grid-row: auto/span 3
.row-4 grid-row: auto/span 4
.row-5 grid-row: auto/span 5
.row-6 grid-row: auto/span 6
Grid row start
.row-start-1 grid-row-start: 1
.row-start-2 grid-row-start: 2
.row-start-3 grid-row-start: 3
.row-start-4 grid-row-start: 4
.row-start-5 grid-row-start: 5
Grid row end
.row-end-1 grid-row-end: 1
.row-end-2 grid-row-end: 2
.row-end-3 grid-row-end: 3
.row-end-4 grid-row-end: 4
.row-end-5 grid-row-end: 5
.row-end-6 grid-row-end: 6

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:

.col-1
.col-1-xxl
.col-1-xl
.col-1-lg
.col-1-md
.col-1-sm
.col-1-xs
.col-1-xxs

Using the module (anchor)

To use the module load the StyleMods scss directory as follows (changing the path to suit the source files location as required) then include the Sass mixin as shown below.

To include all the utilities:

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

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

Include the columns and rows individually:

custom.scss
@use "stylemods/scss" as *;
@include grid-columns-css;
@include grid-rows-css;

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

Include everything individually:

custom.scss
@use "stylemods/scss" as *;
@include grid-column-utility-css;
@include grid-column-span-css;
@include grid-column-start-css;
@include grid-column-end-css;
@include grid-row-span-css;
@include grid-row-start-css;
@include grid-row-end-css;

// Example breakpoint
@media (width <= 480px) {
  @include grid-column-utility-sm-css;
  @include grid-column-span-sm-css;
  @include grid-column-start-sm-css;
  @include grid-column-end-sm-css;
  @include grid-row-span-sm-css;
  @include grid-row-start-sm-css;
  @include grid-row-end-sm-css;
}

Customizing (anchor)

The default 12 columns and 6 rows can be customized with variable overrides. See Sass variables on the customizing page for more information about including overrides.

custom.scss
@use 'stylemods/scss' with (
  $grid-column-values: 6,
  $grid-row-values: 3,
);
@use "stylemods/scss" as *;
@include grid-layouts-css;

The column count can also be customized inline:

<div class="grid-cols" style="--columns:8;">
  <div class="col-2">1</div>
  <div class="col-4">2</div>
  <div class="col-2">3</div>
</div>

Source code (anchor)

grid-layouts.scss
// ---------------------------------------------------------- 
// Grid layouts
// ----------------------------------------------------------
$grid-column-values:    12 !default;
$grid-row-values:       6 !default;

$grid-column-utility-values: (
  "display": grid,
  "grid-template-columns": repeat(var(--columns, $grid-column-values), minmax(0, 1fr)),
  "grid-template-rows": repeat(var(--rows, 1), minmax(0, 1fr)),
) !default;

// ---------------------------------------------------------- 
// Grid columns
// ----------------------------------------------------------
@mixin grid-column-utility-css {
  .grid-col {
    @each $name, $value in $grid-column-utility-values {
      #{$name}: #{$value};        
    }
  }
}

@mixin grid-column-span-css {
  @for $value from 1 through $grid-column-values {
    .col-#{$value} {
      grid-column: auto / span $value;
    }
  }
}

@mixin grid-column-start-css {
  @for $value from 1 through $grid-column-values {    
    .col-start-#{$value} {
      grid-column-start: $value;
    }
  }
}

@mixin grid-column-end-css {
  @for $value from 1 through $grid-column-values {     
    .col-end-#{$value} {
      grid-column-end: $value;
    }  
  }
}

// XXL
@mixin grid-column-utility-xxl-css {
  .grid-col-xxl {
    @each $name, $value in $grid-column-utility-values {
      #{$name}: #{$value};        
    }
  }
}

@mixin grid-column-span-xxl-css {
  @for $value from 1 through $grid-column-values {
    .col-#{$value}-xxl {
      grid-column: auto / span $value;
    }
  }
}

@mixin grid-column-start-xxl-css {
  @for $value from 1 through $grid-column-values {    
    .col-start-#{$value}-xxl {
      grid-column-start: $value;
    }
  }
}

@mixin grid-column-end-xxl-css {
  @for $value from 1 through $grid-column-values {     
    .col-end-#{$value}-xxl {
      grid-column-end: $value;
    }  
  }
} 

// XL
@mixin grid-column-utility-xl-css {
  .grid-col-xl {
    @each $name, $value in $grid-column-utility-values {
      #{$name}: #{$value};        
    }
  }
}

@mixin grid-column-span-xl-css {
  @for $value from 1 through $grid-column-values {
    .col-#{$value}-xl {
      grid-column: auto / span $value;
    }
  }
}

@mixin grid-column-start-xl-css {
  @for $value from 1 through $grid-column-values {    
    .col-start-#{$value}-xl {
      grid-column-start: $value;
    }
  }
}

@mixin grid-column-end-xl-css {
  @for $value from 1 through $grid-column-values {     
    .col-end-#{$value}-xl {
      grid-column-end: $value;
    }  
  }
} 

// LG
@mixin grid-column-utility-lg-css {
  .grid-col-lg {
    @each $name, $value in $grid-column-utility-values {
      #{$name}: #{$value};        
    }
  }
}

@mixin grid-column-span-lg-css {
  @for $value from 1 through $grid-column-values {
    .col-#{$value}-lg {
      grid-column: auto / span $value;
    }
  }
}

@mixin grid-column-start-lg-css {
  @for $value from 1 through $grid-column-values {    
    .col-start-#{$value}-lg {
      grid-column-start: $value;
    }
  }
}

@mixin grid-column-end-lg-css {
  @for $value from 1 through $grid-column-values {     
    .col-end-#{$value}-lg {
      grid-column-end: $value;
    }  
  }
} 

// MD
@mixin grid-column-utility-md-css {
  .grid-col-md {
    @each $name, $value in $grid-column-utility-values {
      #{$name}: #{$value};        
    }
  }
}

@mixin grid-column-span-md-css {
  @for $value from 1 through $grid-column-values {
    .col-#{$value}-md {
      grid-column: auto / span $value;
    }
  }
}

@mixin grid-column-start-md-css {
  @for $value from 1 through $grid-column-values {    
    .col-start-#{$value}-md {
      grid-column-start: $value;
    }
  }
}

@mixin grid-column-end-md-css {
  @for $value from 1 through $grid-column-values {     
    .col-end-#{$value}-md {
      grid-column-end: $value;
    }  
  }
} 

// SM
@mixin grid-column-utility-sm-css {
  .grid-col-sm {
    @each $name, $value in $grid-column-utility-values {
      #{$name}: #{$value};        
    }
  }
}

@mixin grid-column-span-sm-css {
  @for $value from 1 through $grid-column-values {
    .col-#{$value}-sm {
      grid-column: auto / span $value;
    }
  }
}

@mixin grid-column-start-sm-css {
  @for $value from 1 through $grid-column-values {    
    .col-start-#{$value}-sm {
      grid-column-start: $value;
    }
  }
}

@mixin grid-column-end-sm-css {
  @for $value from 1 through $grid-column-values {     
    .col-end-#{$value}-sm {
      grid-column-end: $value;
    }  
  }
} 

// XS
@mixin grid-column-utility-xs-css {
  .grid-col-xs {
    @each $name, $value in $grid-column-utility-values {
      #{$name}: #{$value};        
    }
  }
}

@mixin grid-column-span-xs-css {
  @for $value from 1 through $grid-column-values {
    .col-#{$value}-xs {
      grid-column: auto / span $value;
    }
  }
}

@mixin grid-column-start-xs-css {
  @for $value from 1 through $grid-column-values {    
    .col-start-#{$value}-xs {
      grid-column-start: $value;
    }
  }
}

@mixin grid-column-end-xs-css {
  @for $value from 1 through $grid-column-values {     
    .col-end-#{$value}-xs {
      grid-column-end: $value;
    }  
  }
} 

// XXS
@mixin grid-column-utility-xxs-css {
  .grid-col-xxs {
    @each $name, $value in $grid-column-utility-values {
      #{$name}: #{$value};        
    }
  }
}

@mixin grid-column-span-xxs-css {
  @for $value from 1 through $grid-column-values {
    .col-#{$value}-xxs {
      grid-column: auto / span $value;
    }
  }
}

@mixin grid-column-start-xxs-css {
  @for $value from 1 through $grid-column-values {    
    .col-start-#{$value}-xxs {
      grid-column-start: $value;
    }
  }
}

@mixin grid-column-end-xxs-css {
  @for $value from 1 through $grid-column-values {     
    .col-end-#{$value}-xxs {
      grid-column-end: $value;
    }  
  }
}

// ---------------------------------------------------------- 
// Grid rows
// ----------------------------------------------------------
@mixin grid-row-span-css {
  @for $value from 1 through $grid-row-values {
    .row-#{$value} {
      grid-row: auto / span $value;
    }
  }
}

@mixin grid-row-start-css {
  @for $value from 1 through $grid-row-values {    
    .row-start-#{$value} {
      grid-row-start: $value;
    }
  }
}

@mixin grid-row-end-css {
  @for $value from 1 through $grid-row-values {     
    .row-end-#{$value} {
      grid-row-end: $value;
    }  
  }
}

// XXL
@mixin grid-row-span-xxl-css {
  @for $value from 1 through $grid-row-values {
    .row-#{$value}-xxl {
      grid-row: auto / span $value;
    }
  }
}

@mixin grid-row-start-xxl-css {
  @for $value from 1 through $grid-row-values {    
    .row-start-#{$value}-xxl {
      grid-row-start: $value;
    }
  }
}

@mixin grid-row-end-xxl-css {
  @for $value from 1 through $grid-row-values {     
    .row-end-#{$value}-xxl {
      grid-row-end: $value;
    }  
  }
} 

// XL
@mixin grid-row-span-xl-css {
  @for $value from 1 through $grid-row-values {
    .row-#{$value}-xl {
      grid-row: auto / span $value;
    }
  }
}

@mixin grid-row-start-xl-css {
  @for $value from 1 through $grid-row-values {    
    .row-start-#{$value}-xl {
      grid-row-start: $value;
    }
  }
}

@mixin grid-row-end-xl-css {
  @for $value from 1 through $grid-row-values {     
    .row-end-#{$value}-xl {
      grid-row-end: $value;
    }  
  }
} 

// LG
@mixin grid-row-span-lg-css {
  @for $value from 1 through $grid-row-values {
    .row-#{$value}-lg {
      grid-row: auto / span $value;
    }
  }
}

@mixin grid-row-start-lg-css {
  @for $value from 1 through $grid-row-values {    
    .row-start-#{$value}-lg {
      grid-row-start: $value;
    }
  }
}

@mixin grid-row-end-lg-css {
  @for $value from 1 through $grid-row-values {     
    .row-end-#{$value}-lg {
      grid-row-end: $value;
    }  
  }
} 

// MD
@mixin grid-row-span-md-css {
  @for $value from 1 through $grid-row-values {
    .row-#{$value}-md {
      grid-row: auto / span $value;
    }
  }
}

@mixin grid-row-start-md-css {
  @for $value from 1 through $grid-row-values {    
    .row-start-#{$value}-md {
      grid-row-start: $value;
    }
  }
}

@mixin grid-row-end-md-css {
  @for $value from 1 through $grid-row-values {     
    .row-end-#{$value}-md {
      grid-row-end: $value;
    }  
  }
} 

// SM
@mixin grid-row-span-sm-css {
  @for $value from 1 through $grid-row-values {
    .row-#{$value}-sm {
      grid-row: auto / span $value;
    }
  }
}

@mixin grid-row-start-sm-css {
  @for $value from 1 through $grid-row-values {    
    .row-start-#{$value}-sm {
      grid-row-start: $value;
    }
  }
}

@mixin grid-row-end-sm-css {
  @for $value from 1 through $grid-row-values {     
    .row-end-#{$value}-sm {
      grid-row-end: $value;
    }  
  }
} 

// XS
@mixin grid-row-span-xs-css {
  @for $value from 1 through $grid-row-values {
    .row-#{$value}-xs {
      grid-row: auto / span $value;
    }
  }
}

@mixin grid-row-start-xs-css {
  @for $value from 1 through $grid-row-values {    
    .row-start-#{$value}-xs {
      grid-row-start: $value;
    }
  }
}

@mixin grid-row-end-xs-css {
  @for $value from 1 through $grid-row-values {     
    .row-end-#{$value}-xs {
      grid-row-end: $value;
    }  
  }
} 

// XXS
@mixin grid-row-span-xxs-css {
  @for $value from 1 through $grid-row-values {
    .row-#{$value}-xxs {
      grid-row: auto / span $value;
    }
  }
}

@mixin grid-row-start-xxs-css {
  @for $value from 1 through $grid-row-values {    
    .row-start-#{$value}-xxs {
      grid-row-start: $value;
    }
  }
}

@mixin grid-row-end-xxs-css {
  @for $value from 1 through $grid-row-values {     
    .row-end-#{$value}-xxs {
      grid-row-end: $value;
    }  
  }
}

// Grouped mixins
// Grid columns
@mixin grid-columns-css {
  @include grid-column-utility-css;
  @include grid-column-span-css;
  @include grid-column-start-css;
  @include grid-column-end-css;
}

@mixin grid-columns-xxl-css {
  @include grid-column-utility-xxl-css;
  @include grid-column-span-xxl-css;
  @include grid-column-start-xxl-css;
  @include grid-column-end-xxl-css;
}

@mixin grid-columns-xl-css {
  @include grid-column-utility-xl-css;
  @include grid-column-span-xl-css;
  @include grid-column-start-xl-css;
  @include grid-column-end-xl-css;
}

@mixin grid-columns-lg-css {
  @include grid-column-utility-lg-css;
  @include grid-column-span-lg-css;
  @include grid-column-start-lg-css;
  @include grid-column-end-lg-css;
}

@mixin grid-columns-md-css {
  @include grid-column-utility-md-css;
  @include grid-column-span-md-css;
  @include grid-column-start-md-css;
  @include grid-column-end-md-css;
}

@mixin grid-columns-sm-css {
  @include grid-column-utility-sm-css;
  @include grid-column-span-sm-css;
  @include grid-column-start-sm-css;
  @include grid-column-end-sm-css;
}

@mixin grid-columns-xs-css {
  @include grid-column-utility-xs-css;
  @include grid-column-span-xs-css;
  @include grid-column-start-xs-css;
  @include grid-column-end-xs-css;
}

@mixin grid-columns-xxs-css {
  @include grid-column-utility-xxs-css;
  @include grid-column-span-xxs-css;
  @include grid-column-start-xxs-css;
  @include grid-column-end-xxs-css;
}

// Grid rows
@mixin grid-rows-css {
  @include grid-row-span-css;
  @include grid-row-start-css;
  @include grid-row-end-css;
}

@mixin grid-rows-xxl-css {
  @include grid-row-span-xxl-css;
  @include grid-row-start-xxl-css;
  @include grid-row-end-xxl-css;
}

@mixin grid-rows-xl-css {
  @include grid-row-span-xl-css;
  @include grid-row-start-xl-css;
  @include grid-row-end-xl-css;
}

@mixin grid-rows-lg-css {
  @include grid-row-span-lg-css;
  @include grid-row-start-lg-css;
  @include grid-row-end-lg-css;
}

@mixin grid-rows-md-css {
  @include grid-row-span-md-css;
  @include grid-row-start-md-css;
  @include grid-row-end-md-css;
}

@mixin grid-rows-sm-css {
  @include grid-row-span-sm-css;
  @include grid-row-start-sm-css;
  @include grid-row-end-sm-css;
}

@mixin grid-rows-xs-css {
  @include grid-row-span-xs-css;
  @include grid-row-start-xs-css;
  @include grid-row-end-xs-css;
}

@mixin grid-rows-xxs-css {
  @include grid-row-span-xxs-css;
  @include grid-row-start-xxs-css;
  @include grid-row-end-xxs-css;
}

// Both
@mixin grid-layouts-css {
  @include grid-columns-css;
  @include grid-rows-css;
}

@mixin grid-layouts-xxl-css {
  @include grid-columns-xxl-css;
  @include grid-rows-xxl-css;
}

@mixin grid-layouts-xl-css {
  @include grid-columns-xl-css;
  @include grid-rows-xl-css;
}

@mixin grid-layouts-lg-css {
  @include grid-columns-lg-css;
  @include grid-rows-lg-css;
}

@mixin grid-layouts-md-css {
  @include grid-columns-md-css;
  @include grid-rows-md-css;
}

@mixin grid-layouts-sm-css {
  @include grid-columns-sm-css;
  @include grid-rows-sm-css;
}

@mixin grid-layouts-xs-css {
  @include grid-columns-xs-css;
  @include grid-rows-xs-css;
}

@mixin grid-layouts-xxs-css {
  @include grid-columns-xxs-css;
  @include grid-rows-xxs-css;
}