Backgrounds

A variable utility for to provide custom background and text colors inline.

Examples (anchor)

The background color utility is a variable class with no preset values designed to be used to create custom background colors inline, it includes variables for text and background colors as demonstrated below.

<div class="bg" style="--bg-col:RoyalBlue; --bg-text:white;">RoyalBlue</div>
<div class="bg" style="--bg-col:Indigo; --bg-text:white;">Indigo</div>
<div class="bg" style="--bg-col:Maroon; --bg-text:white;">Maroon</div>
<div class="bg" style="--bg-col:Moccasin; --bg-text:black;">Moccasin</div>
<div class="bg" style="--bg-col:Thistle; --bg-text:black;">Thistle</div>
<div class="bg" style="--bg-col:PaleGreen; --bg-text:black;">PaleGreen</div>

The color utilities use the variables to provide optional modifier classes for the .bg utility using the preset color values included with the color variables tokens.

See the gradients utilities for background image gradient styles, and the images utilities for specific background image related styles and variable utilities.

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 anywhere below.

@use "stylemods/scss" as *;
@include background-css;

Source code (anchor)

See customizing for information about using the Sass and CSS variables in the source code to customize the styles, and Sass functionality (on the using StyleMods page) for other ways to use the variables to create custom styles.

// ---------------------------------------------------------- 
// Backgrounds
// ----------------------------------------------------------
$background-utility:              bg !default;
$background-text-variable:        var(--bg-text) !default;
$background-color-variable:       var(--bg-col) !default;

@mixin background-css {
  .#{$background-utility} {
    color: $background-text-variable;
    background-color: $background-color-variable;
  }
}