Buttons

A basic button utility including size modifier classes and button groups container utilities.

Examples (anchor)

The button utility .btn replicates the styles and variables included with the forms and buttons to enable combining them if both are used. Base values for default font properties are expected via reset styles so are not included, the typography provides these if required but the styles should work with any reset/normalize document used.

Button utility (anchor)

Link

<a href="#" class="btn">Link</a>
<button class="btn">Button</button>

Outline buttons (anchor)

Link

<a href="#" class="btn btn-outline">Link</a>
<button class="btn btn-outline">Button</button>

Button sizes (anchor)

<button class="btn btn-xs">Extra small</button>
<button class="btn btn-sm">Small</button>
<button class="btn btn">Normal</button>
<button class="btn btn-lg">Large</button>
<button class="btn btn-xl">Extra large</button>

Button groups (anchor)

<div class="btn-group">
  <button class="btn">One</button>
  <button class="btn">Two</button>
  <button class="btn">Three</button>
</div>
<div class="btn-group-column">
  <button class="btn">One</button>
  <button class="btn">Two</button>
  <button class="btn">Three</button>
</div>

Fixed light and dark (anchor)

Link button light Link button dark

<a href="#" class="btn btn-light">Link button light</a>
<a href="#" class="btn btn-dark">Link button dark</a>
<button class="btn btn-light">HTML button light</button> 
<button class="btn btn-dark">HTML button dark</button>

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.

custom.scss

@use "stylemods/scss" as *;
@include buttons-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.

buttons.scss

// ---------------------------------------------------------- 
// Buttons
// ----------------------------------------------------------
$btn-text-color:          var(--btn-text, CanvasText) !default;
$btn-font-size:           var(--btn-fs, inherit) !default;
$btn-line-height:         var(--btn-lh, inherit) !default;
$btn-padding-block:       var(--btn-py, 0.313rem) !default;
$btn-padding-inline:      var(--btn-px, 0.75rem) !default;  
$btn-border-color:        var(--btn-bd-color, color-mix(in srgb, CanvasText 22%, Canvas)) !default;
$btn-radius:              var(--btn-radius, 0.188rem) !default;
$btn-background-color:    var(--btn-bg, color-mix(in srgb, CanvasText 4%, Canvas)) !default;
$btn-background-hover:    var(--btn-hover, color-mix(in srgb, CanvasText 8%, Canvas)) !default;
$btn-focus-shadow:        var(--focus-shadow, 0 0 0 0.12rem) !default;
$btn-focus-shadow-color:  var(--focus-color, color-mix(in srgb, CanvasText 22%, Canvas)) !default;

@mixin buttons-css {

.btn {
  color: $btn-text-color;
  font-size: $btn-font-size;
  line-height: $btn-line-height;
  text-align: center;
  text-decoration: none;
  display: var(--btn-d, inline-block); 
  padding-block: $btn-padding-block;
  padding-inline: $btn-padding-inline;  
  border: 1px solid $btn-border-color;
  border-radius: $btn-radius;
  background-color: $btn-background-color;
  cursor: pointer;
  -webkit-appearance: button;
}

.btn:is(:hover, :focus, :active) {
  color: $btn-text-color;
  background-color: $btn-background-hover;
}

.btn:focus {
  outline: none;
  box-shadow: $btn-focus-shadow $btn-focus-shadow-color;
}

.btn:focus:not(:focus-visible) {  
  box-shadow: none;
  background-color: $btn-background-color;
}
  
.btn:focus:not(:focus-visible):hover {
  background-color: $btn-background-hover;
}

.btn-outline {
  --btn-bg: transparent;
}

.btn-xs {
  --btn-fs: 0.75em;
  --btn-py: .15rem;
  --btn-px: .35rem;
}

.btn-sm {
  --btn-fs: 0.88em;
  --btn-py: .25rem;
  --btn-px: .5rem;
}

.btn-lg {
  --btn-fs: 1.1em;
  --btn-py: .35rem;
  --btn-px: .85rem;
}

.btn-xl {
  --btn-fs: 1.25em;
  --btn-py: .5rem;
  --btn-px: 1rem;
}

.btn-group, .btn-group-column {
  display: flex;
}

.btn-group *, .btn-group-column * {
  border-radius: 0;
}

.btn-group *:not(:first-child) {
  margin-inline-start: -1px;
}

.btn-group *:first-child {
  border-start-start-radius: $btn-radius;
  border-end-start-radius: $btn-radius;
}

.btn-group *:last-child {
  border-start-end-radius: $btn-radius;
  border-end-end-radius: $btn-radius;
}

.btn-group *:is(:focus), .btn-group-column *:is(:focus) {
  box-shadow: none;
}

.btn-group-column {
  flex-direction: column;
  inline-size: fit-content;
}

.btn-group-column *:not(:first-child) {
  margin-block-start: -1px;
}

.btn-group-column *:first-child {
  border-start-start-radius: $btn-radius;
  border-start-end-radius: $btn-radius;
}

.btn-group-column *:last-child {
  border-end-start-radius: $btn-radius;
  border-end-end-radius: $btn-radius;
}

.btn-group-column *:is(:focus) {
 // box-shadow: none;
}

.btn-light {
  color-scheme: light;
}

.btn-dark {
  color-scheme: dark;
}

} // end buttons-css