tabler/core/scss/ui/_buttons.scss

@use 'sass:list';
@use 'sass:map';

//
// Button
//
@use '../config' as *;

.btn {
  --btn-icon-size: #{$input-btn-icon-size};
  --btn-icon-color: inherit;
  --btn-bg: var(--bg-surface);
  --btn-color: var(--body-color);
  --btn-border-color: #{$btn-border-color};
  --btn-hover-bg: var(--hover-bg);
  --btn-hover-border-color: var(--border-active-color);
  --btn-active-color: #{$active-color};
  --btn-active-bg: var(--active-bg);
  --btn-active-border-color: #{$active-border-color};
  position: relative;

  display: inline-flex;
  align-items: center;
  justify-content: center;
  min-width: calc((var(--btn-line-height) * 1) + (var(--btn-padding-y) * 2) + (var(--btn-border-width) * 2));
  min-height: calc((var(--btn-line-height) * 1) + (var(--btn-padding-y) * 2) + (var(--btn-border-width) * 2));
  white-space: nowrap;
  box-shadow: var(--btn-box-shadow);

  @include border-radius(var(--btn-border-radius));

  .icon {
    width: var(--btn-icon-size);
    min-width: var(--btn-icon-size);
    height: var(--btn-icon-size);
    margin: 0 calc(var(--btn-padding-x) / 2) 0 calc(var(--btn-padding-x) / -4);
    font-size: var(--btn-icon-size);
    color: var(--btn-icon-color);
    vertical-align: bottom;
  }

  .avatar {
    width: var(--btn-icon-size);
    height: var(--btn-icon-size);
    margin: 0 calc(var(--btn-padding-x) / 2) 0 calc(var(--btn-padding-x) / -4);
  }

  .icon-right,
  .icon-end {
    margin: 0 calc(var(--btn-padding-x) / -4) 0 calc(var(--btn-padding-x) / 2);
  }

  .badge {
    top: auto;
  }

  .btn-check + &:hover {
    color: var(--btn-hover-color);
    background-color: var(--btn-hover-bg);
    border-color: var(--btn-hover-border-color);
  }
}

.btn-link {
  // Tokens, not just the plain properties below: the disabled state reads
  // `--btn-bg` and `--btn-border-color`, so setting only `background-color`
  // here would leave a disabled link button with the default surface and border.
  --btn-bg: transparent;
  --btn-border-color: transparent;
  color: #{adjust-lightness-css(var(--primary), 5%)};
  background-color: transparent;
  border-color: transparent;
  box-shadow: none;

  .icon {
    color: inherit;
  }

  &:hover {
    color: #{$btn-link-hover-color};
    border-color: transparent;
  }
}

//
// Button color variations
//
.btn-ghost {
  --btn-bg: transparent;
  --btn-border-color: transparent;
  --btn-box-shadow: none;
  --btn-hover-bg: var(--hover-bg);
  --btn-hover-border-color: transparent;
  --btn-hover-color: var(--body-color);
}

// Each color class only points the --btn-variant* tokens at its palette
// colors; the shared rules below turn them into the button tokens. The rules
// are grouped by variant (solid, outline, ghost) rather than by color, so each
// token list is written once instead of once per color.
$btn-colors: map.keys(map.merge($theme-colors, $social-colors));

@function btn-color-selectors($patterns...) {
  $selectors: ();
  @each $pattern in $patterns {
    @each $color in $btn-colors {
      $selectors: list.append($selectors, str-replace($pattern, '{c}', '#{$color}'), $separator: comma);
    }
  }
  @return $selectors;
}

@each $color in $btn-colors {
  .btn-#{$color},
  .btn-outline-#{$color},
  .btn-ghost-#{$color} {
    --btn-variant: var(--#{$color});
    --btn-variant-fg: var(--#{$color}-fg);
    --btn-variant-darken: var(--#{$color}-darken);
  }
}

#{btn-color-selectors('.btn-{c}')} {
  --btn-border-color: transparent;
  --btn-hover-border-color: transparent;
  --btn-active-border-color: transparent;
  --btn-color: var(--btn-variant-fg, #{$white});
  --btn-bg: var(--btn-variant);
  --btn-hover-color: var(--btn-variant-fg);
  --btn-hover-bg: var(--btn-variant-darken);
  --btn-active-color: var(--btn-variant-fg);
  --btn-active-bg: var(--btn-variant-darken);
  --btn-disabled-bg: var(--btn-variant);
  --btn-disabled-color: var(--btn-variant-fg);
  --btn-box-shadow: var(--shadow-input);
}

@if map.has-key($theme-colors, 'dark') {
  .btn-dark {
    --btn-border-color: var(--dark-mode-border-color);
    --btn-hover-border-color: var(--dark-mode-border-active-color);
    --btn-active-border-color: var(--dark-mode-border-active-color);
  }
}

#{btn-color-selectors('.btn-outline-{c}', '.btn-outline.btn-{c}')} {
  --btn-color: var(--btn-variant);
  --btn-bg: transparent;
  --btn-border-color: var(--btn-variant);
  --btn-hover-color: var(--btn-variant-fg);
  --btn-hover-border-color: transparent;
  --btn-hover-bg: var(--btn-variant);
  --btn-active-color: var(--btn-variant-fg);
  --btn-active-bg: var(--btn-variant);
  --btn-active-border-color: var(--btn-variant);
  --btn-disabled-color: var(--btn-variant);
  --btn-disabled-border-color: var(--btn-variant);
}

#{btn-color-selectors('.btn-ghost-{c}', '.btn-ghost.btn-{c}')} {
  --btn-color: var(--btn-variant);
  --btn-bg: transparent;
  --btn-border-color: transparent;
  --btn-hover-color: var(--btn-variant-fg);
  --btn-hover-bg: var(--btn-variant);
  --btn-hover-border-color: var(--btn-variant);
  --btn-active-color: var(--btn-variant-fg);
  --btn-active-bg: var(--btn-variant);
  --btn-active-border-color: transparent;
  --btn-active-shadow: #{$btn-active-box-shadow};
  --btn-disabled-color: var(--btn-variant);
  --btn-disabled-bg: transparent;
  --btn-disabled-border-color: transparent;
  --gradient: none;
  --btn-box-shadow: none;
}

// Gradient ring: a surface-colored layer clipped to the padding box sits on a
// gradient layer that fills the border box, so only the border shows the
// gradient — the same trick as `.card-gradient`. Presets share the `.btn-outline-gradient`
// base through one selector list, so a preset class works on its own.
$btn-gradient-names: list.join(map.keys($theme-colors), map.keys($gradients));

@function btn-gradient-selectors() {
  $selectors: '.btn-outline-gradient';
  @each $name in $btn-gradient-names {
    $selectors: list.append($selectors, '.btn-outline-gradient-#{$name}', $separator: comma);
  }
  @return $selectors;
}

$btn-gradient-selectors: btn-gradient-selectors();

#{$btn-gradient-selectors} {
  // scss-docs-start btn-gradient-css-vars
  --btn-gradient: var(--primary), var(--primary);
  --btn-gradient-direction: 135deg;
  // scss-docs-end btn-gradient-css-vars
  --btn-border-color: transparent;
  --btn-hover-border-color: transparent;
  --btn-active-border-color: transparent;
  --btn-disabled-border-color: transparent;
  --btn-box-shadow: none;
  // The hover and active fills are translucent tints, so a solid surface layer
  // sits under them — otherwise the gradient would bleed through on hover.
  background:
    linear-gradient(var(--btn-bg), var(--btn-bg)) padding-box,
    linear-gradient(var(--bg-surface), var(--bg-surface)) padding-box,
    linear-gradient(var(--btn-gradient-direction), var(--btn-gradient)) border-box;
}

// `.btn:hover` only sets `background-color`, which sits under the two opaque
// image layers, so the hover and active fills go through the token instead.
// `:is()` keeps the state rules to one selector list each.
:is(#{$btn-gradient-selectors}):hover,
.btn-check + :is(#{$btn-gradient-selectors}):hover {
  --btn-bg: var(--btn-hover-bg);
}

:is(#{$btn-gradient-selectors}):active,
:is(#{$btn-gradient-selectors}).active,
.btn-check:checked + :is(#{$btn-gradient-selectors}) {
  --btn-bg: var(--btn-active-bg);
}

@each $color in map.keys($theme-colors) {
  .btn-outline-gradient-#{$color} {
    --btn-gradient: var(--#{$color}), var(--#{$color}-darken);
  }
}

@each $name, $stops in $gradients {
  .btn-outline-gradient-#{$name} {
    --btn-gradient: #{$stops};
  }
}

//
// Button sizes
//
.btn-sm,
.btn-group-sm > .btn {
  --btn-line-height: #{$input-btn-line-height-sm};
  --btn-icon-size: #{$input-btn-icon-size-sm};
}

.btn-lg,
.btn-group-lg > .btn {
  --btn-line-height: #{$input-btn-line-height-lg};
  --btn-icon-size: #{$input-btn-icon-size-lg};
}

.btn-xl,
.btn-group-xl > .btn {
  --btn-line-height: #{$input-btn-line-height-xl};
  --btn-icon-size: #{$input-btn-icon-size-xl};
  --btn-padding-y: #{$input-btn-padding-y-xl};
  --btn-padding-x: #{$input-btn-padding-x-xl};
  --btn-font-size: #{$input-btn-font-size-xl};
}

//
// Button shapes
//
.btn-pill {
  padding-inline-start: 1.5em;
  padding-inline-end: 1.5em;
  @include border-radius(var(--border-radius-pill));

  &[class*='btn-icon'] {
    --btn-pill-icon-padding-y: #{$btn-pill-icon-padding-y};
    --btn-pill-icon-padding-x: #{$btn-pill-icon-padding-x};
    padding: var(--btn-pill-icon-padding-y) var(--btn-pill-icon-padding-x);
  }
}

.btn-square {
  border-radius: 0;
}

//
// Icon button
//
.btn-icon,
.btn-action {
  @include focus-ring-transition();
  //[BUG] btn-sm and btn-xl with an icon looks broken
  //issue #2470 fixed
  min-width: calc(var(--btn-line-height) + (var(--btn-padding-y) * 2) + (var(--btn-border-width) * 2));
  padding-inline-start: 0;
  padding-inline-end: 0;

  .icon {
    margin: calc(-1 * var(--btn-padding-x));
  }
}

//
// Button list
//
.btn-list {
  @include elements-list();
}

.btn-list-center {
  justify-content: center;
}

//
// Button floating
//
.btn-floating {
  --btn-floating-offset: #{$btn-floating-offset};
  position: fixed;
  // End side, Material-FAB style — the start side belongs to the sidebar.
  inset-inline-end: var(--btn-floating-offset);
  bottom: var(--btn-floating-offset);
  z-index: $zindex-fixed;
  box-shadow: var(--shadow-dropdown);

  @include media-print() {
    display: none;
  }
}

//
// Button loading
//
.btn-loading {
  position: relative;
  color: transparent !important;
  text-shadow: none !important;
  pointer-events: none;

  > * {
    opacity: 0;
  }

  &::after {
    position: absolute;
    inset-inline-start: calc(50% - var(--btn-icon-size) / 2);
    top: calc(50% - var(--btn-icon-size) / 2);
    display: inline-block;
    width: var(--btn-icon-size);
    height: var(--btn-icon-size);
    color: var(--btn-color);
    vertical-align: text-bottom;
    content: '';
    border: $spinner-border-width var(--border-style) currentColor;
    border-inline-end-color: transparent;
    animation: spinner-border 0.75s linear infinite;
    @include border-radius(var(--border-radius-pill));
  }
}

//
// Action button
//
.btn-action {
  --border-color: transparent;
  --btn-bg: transparent;
  --btn-disabled-color: var(--secondary);
  color: var(--secondary);
  @include border-radius(var(--border-radius));
  background: transparent;
  box-shadow: none;

  &::after {
    content: none;
  }

  &:focus:not(:focus-visible) {
    outline: none;
    box-shadow: none;
  }

  &:focus-visible {
    @include focus-ring();
    outline-offset: calc(var(--focus-ring-width) * -1);
    box-shadow: none;
  }

  &:hover,
  &.show {
    color: var(--body-color);
    background: var(--active-bg);
    border-color: transparent;
  }

  &.show {
    color: var(--primary);
  }

  @include media-print() {
    display: none;
  }
}

.btn-actions {
  display: flex;

  @include media-print() {
    display: none;
  }
}

.btn-animate-icon {
  .icon {
    transition: transform 0.3s ease;
  }

  &:hover,
  &:focus-visible {
    .icon {
      /* rtl:ignore */
      transform: translateX(calc(var(--dir) * 4px));
    }
  }

  &.btn-animate-icon-rotate {
    &:hover,
    &:focus-visible {
      .icon {
        transform: rotate(90deg);
      }
    }
  }

  &.btn-animate-icon-move-start {
    &:hover,
    &:focus-visible {
      .icon {
        /* rtl:ignore */
        transform: translateX(calc(var(--dir) * -4px));
      }
    }
  }

  &.btn-animate-icon-pulse {
    &:hover,
    &:focus-visible {
      .icon {
        transform: none;
        animation: pulse 0.9s;
      }
    }
  }

  &.btn-animate-icon-shake {
    &:hover,
    &:focus-visible {
      .icon {
        transform: none;
        animation: shake 0.9s;
      }
    }
  }

  &.btn-animate-icon-tada {
    &:hover,
    &:focus-visible {
      .icon {
        transform: none;
        animation: tada 0.9s;
      }
    }
  }
}