web/bootstrap5
4
Fork 0
Code Issues Pull requests Projects Releases Activity

Contrast fixes

Browse source
This commit is contained in:
ThePetrovich 2026-09-19 16:49:53 +08:00
parent be164cfe0a
commit 25ade09b0c
31 changed files with 471 additions and 378 deletions
Download patch file Download diff file Expand all files Collapse all files

86
scss/mixins/_buttons.scss
View file

@ -36,62 +36,82 @@
// scss-docs-end btn-variant-mixin
// Tinted "outline" button variant.
// The resting state uses a translucent tint of the color plus a slightly
// darker border of the same hue. Hover deepens both the tint and the border;
// active fills solid.
//
// This fork replaces Bootstrap's transparent outline buttons with a tinted
// style. The tints are the opaque color-mode custom properties from
// `_root.scss` (`-bg-subtle` / `-border-subtle` / `-text-emphasis`) rather
// than `rgba()` of the theme color, for two reasons: translucent fills
// composite over the parent element, so the button changes appearance on any
// non-white background, and the raw theme color as text fails WCAG on light
// fills (`$warning` is ~1.6:1 against white). The subtle/emphasis pair is
// opaque and pre-darkened, and it swaps under `[data-bs-theme="dark"]`.
//
// Intensity ladder: rest is the subtle fill, hover fills solid, active deepens
// the solid fill by the same shade/tint amounts the solid `.btn-*` variants
// use. Hover deliberately jumps to solid rather than to `-border-subtle`: that
// variable is a *border* color, not a background, and pairing it with
// `-text-emphasis` lands around 4.1:1 in dark mode where both are mid-tone.
//
// `$name` is the `$theme-colors` key (e.g. "primary") used to build the custom
// property names; `$color` is still needed for the focus ring and for
// `color-contrast()` on the solid active state.
// scss-docs-start btn-outline-variant-mixin
@mixin button-outline-variant(
$name,
$color,
$color-hover: $color,
$active-background: $color,
$active-color: color-contrast($active-background),
$tint-amount: .1,
$hover-tint-amount: .2,
$disabled-tint-amount: .1,
$border-tint-amount: .15,
$hover-border-tint-amount: .3
$hover-background: $color,
$color-hover: color-contrast($hover-background),
$active-background: if(color-contrast($color) == $color-contrast-light, shade-color($color, $btn-active-bg-shade-amount), tint-color($color, $btn-active-bg-tint-amount)),
$active-border: $active-background,
$active-color: color-contrast($active-background)
) {
--#{$prefix}btn-color: #{$color};
--#{$prefix}btn-bg: #{rgba($color, $tint-amount)};
--#{$prefix}btn-border-color: #{rgba($color, $border-tint-amount)};
--#{$prefix}btn-color: var(--#{$prefix}#{$name}-text-emphasis);
--#{$prefix}btn-bg: var(--#{$prefix}#{$name}-bg-subtle);
--#{$prefix}btn-border-color: var(--#{$prefix}#{$name}-border-subtle);
--#{$prefix}btn-hover-color: #{$color-hover};
--#{$prefix}btn-hover-bg: #{rgba($color, $hover-tint-amount)};
--#{$prefix}btn-hover-border-color: #{rgba($color, $hover-border-tint-amount)};
--#{$prefix}btn-hover-bg: #{$hover-background};
--#{$prefix}btn-hover-border-color: #{$hover-background};
--#{$prefix}btn-focus-shadow-rgb: #{to-rgb($color)};
--#{$prefix}btn-active-color: #{$active-color};
--#{$prefix}btn-active-bg: #{$active-background};
--#{$prefix}btn-active-border-color: #{$active-background};
--#{$prefix}btn-active-border-color: #{$active-border};
--#{$prefix}btn-active-shadow: #{$btn-active-box-shadow};
--#{$prefix}btn-disabled-color: #{$color};
--#{$prefix}btn-disabled-bg: #{rgba($color, $disabled-tint-amount)};
--#{$prefix}btn-disabled-border-color: #{rgba($color, $border-tint-amount)};
--#{$prefix}btn-disabled-color: var(--#{$prefix}#{$name}-text-emphasis);
--#{$prefix}btn-disabled-bg: var(--#{$prefix}#{$name}-bg-subtle);
--#{$prefix}btn-disabled-border-color: var(--#{$prefix}#{$name}-border-subtle);
--#{$prefix}gradient: none;
}
// scss-docs-end btn-outline-variant-mixin
// Borderless, tinted button variant (`.btn-tint-*`).
// Same tinted fill as the outline variant but with no border at all — every
// border variable is left as its `.btn` default of transparent.
// Same fill ladder as the outline variant with no border at all. Every border
// variable is declared explicitly as `transparent`: `.btn` only defaults
// `--#{$prefix}btn-border-color` and `--#{$prefix}btn-hover-border-color`, so
// leaving the active and disabled ones undeclared makes `border-color:
// var(…)` fall back to `currentColor` and draw a ring on `:active`.
// scss-docs-start btn-tint-variant-mixin
@mixin button-tint-variant(
$name,
$color,
$color-hover: $color,
$active-background: $color,
$active-color: color-contrast($active-background),
$tint-amount: .1,
$hover-tint-amount: .2,
$disabled-tint-amount: .1
$hover-background: $color,
$color-hover: color-contrast($hover-background),
$active-background: if(color-contrast($color) == $color-contrast-light, shade-color($color, $btn-active-bg-shade-amount), tint-color($color, $btn-active-bg-tint-amount)),
$active-color: color-contrast($active-background)
) {
--#{$prefix}btn-color: #{$color};
--#{$prefix}btn-bg: #{rgba($color, $tint-amount)};
--#{$prefix}btn-color: var(--#{$prefix}#{$name}-text-emphasis);
--#{$prefix}btn-bg: var(--#{$prefix}#{$name}-bg-subtle);
--#{$prefix}btn-border-color: transparent;
--#{$prefix}btn-hover-color: #{$color-hover};
--#{$prefix}btn-hover-bg: #{rgba($color, $hover-tint-amount)};
--#{$prefix}btn-hover-bg: #{$hover-background};
--#{$prefix}btn-hover-border-color: transparent;
--#{$prefix}btn-focus-shadow-rgb: #{to-rgb($color)};
--#{$prefix}btn-active-color: #{$active-color};
--#{$prefix}btn-active-bg: #{$active-background};
--#{$prefix}btn-active-border-color: transparent;
--#{$prefix}btn-active-shadow: #{$btn-active-box-shadow};
--#{$prefix}btn-disabled-color: #{$color};
--#{$prefix}btn-disabled-bg: #{rgba($color, $disabled-tint-amount)};
--#{$prefix}btn-disabled-color: var(--#{$prefix}#{$name}-text-emphasis);
--#{$prefix}btn-disabled-bg: var(--#{$prefix}#{$name}-bg-subtle);
--#{$prefix}btn-disabled-border-color: transparent;
--#{$prefix}gradient: none;
}
// scss-docs-end btn-tint-variant-mixin