Skip to content

Theme-Variablen ​

Diese Referenz ist die kompakte Lookup-Tabelle für SCSS-Variablen, ihre Quellen in theme.json und ihre Defaults. Für eine erläuterte Architektur-Übersicht siehe Variablen & Tokens.

Quellen ​

DateiZweck
abstract/variables/bootstrap.scssBootstrap-Overrides, bindet $sw-*-Tokens an Bootstrap-Defaults
abstract/variables/custom.scssGuppy-eigene Tokens (Lieferstatus, Produktbilder, Focus, Icons …)
theme.jsonAdmin-Konfiguration, befüllt $sw-*-Tokens

Variablen im Child-Theme setzen

Setze die Variablen in der eigenen Variablen-Datei des Child-Themes, eingebunden über dessen overrides.scss, die vor der von Guppy geladen wird. Guppys Variablen sind !default, daher gewinnt der Wert des Child-Themes, auch gegenüber einem Theme-Feld, das dieselbe Variable befüllt.

Brand-Farben ​

SCSStheme.jsonDefaultVerwendung
$sw-color-brand-primarysw-color-brand-primary#215AFFPrimärfarbe
$sw-color-brand-secondarysw-color-brand-secondary#0B1845Sekundärfarbe
$sw-background-colorsw-background-color#FFFFFFHintergrund
$sw-border-colorsw-border-color#CFD1D7Rahmen
$sw-text-colorsw-text-color#1B1F29Textfarbe
$sw-headline-colorsw-headline-color#1B1F29Überschriften

Graustufen ​

SCSSDefault
$sw-color-gray-100#F9F9F9
$sw-color-gray-200#EEEEEE
$sw-color-gray-300#BCC1C7
$sw-color-gray-400#CED4DA
$sw-color-gray-500#ADB5BD
$sw-color-gray-600#798490
$sw-color-gray-700#495057
$sw-color-gray-800#4A545B
$sw-color-gray-900#212529

Typografie ​

SCSStheme.jsonDefault
$sw-font-size-basesw-font-size-base1rem
$sw-h1-font-sizesw-h1-font-size32px
$sw-h2-font-sizesw-h2-font-size24px
$sw-h3-font-sizesw-h3-font-size20px
$sw-h4-font-sizesw-h4-font-size18px
$sw-h5-font-sizesw-h5-font-size16px
$sw-h6-font-sizesw-h6-font-size15px
$sw-h1-line-heightsw-h1-line-height44px
$sw-h2-line-heightsw-h2-line-height36px
$sw-h3-line-heightsw-h3-line-height32px
$sw-h4-line-heightsw-h4-line-height28px
$sw-h5-line-heightsw-h5-line-height24px
$sw-h6-line-heightsw-h6-line-height21px
$body-secondary-colorguppy-text-secondary-color$sw-text-color, solange das Feld leer ist
$headings-font-familysw-font-family-headline$sw-font-family-headline

$sw-h6-line-height wirkt seit 2.9.0 auf h6 / .h6 (vorher: Bootstraps 1.2), siehe Konfigurationsschema → Typografie.

$headings-font-family war vor 2.9.0 null und bekam denselben Wert aus dem Storefront-Skin, die Ausgabe ist also unverändert. Um die Schrift der Überschriften zu ändern, nutze das Feld "Schriftart Überschrift"; SCSS ist dafür nicht nötig. Nur eine Überschriften-Schrift, die vom Feld abweicht, braucht $headings-font-family in der eigenen abstract/variables/bootstrap.scss des Child-Themes, eingebunden über dessen overrides.scss vor der von Guppy.

$body-secondary-color (--bs-secondary-color) färbt .text-muted, .text-body-secondary, .form-text, Bildunterschriften, Trenner und aktuelles Element der Breadcrumb, deaktivierte Nav-Links, Action-/deaktivierte Elemente von List-Groups, den Toast-Header und den deaktivierten Range-Regler. Ein eigener Wert des Child-Themes gewinnt gegenüber dem Feld. Der dunkle Farbmodus ([data-bs-theme="dark"]) behält seinen eigenen Wert.

Container und Padding ​

SCSSDefault
$guppy-container-width-default1400px
$guppy-container-width-fluid100%
$guppy-container-width-sm1230px
$guppy-container-default-padding-x-mobile10px
$guppy-container-default-padding-x-sm24px
$guppy-container-default-padding-x-md48px
$guppy-container-default-padding-x-lg48px
$guppy-container-default-padding-x-xl48px
$guppy-container-default-padding-x-xxl48px

Container-Padding (.container*-Klassen) ​

Seit 2.9.0 hat das horizontale Padding der .container*-Klassen eigene Variablen in custom.scss:

SCSSDefault
$guppy-container-padding-x-mobile$guppy-block-padding-x-mobile (10px)
$guppy-container-padding-x-sm$guppy-block-padding-x-sm (24px)
$guppy-container-padding-x-md$guppy-block-padding-x-md (48px)
$guppy-container-padding-x-lg$guppy-block-padding-x-lg (48px)
$guppy-container-padding-x-xl$guppy-block-padding-x-xl (48px)
$guppy-container-padding-x-xxl$guppy-block-padding-x-xxl (48px)

Die Defaults entsprechen dem CMS-Block-Padding, die Ausgabe ist also unverändert. Setze sie, um das Container-Padding zu ändern, ohne das CMS-Block-Padding anzufassen; $guppy-block-padding-x-* bleibt verfügbar. Bootstraps $container-padding-x steuert das Container-Padding in Guppy nicht: Bootstraps make-container() nutzt es für das .container*-Padding, das Guppy überschreibt. Es setzt weiterhin den Toast-Abstand und in Guppy den negativen Margin von .cms-block-product-description-reviews unterhalb von sm. Grid-Gutter kommen aus $grid-gutter-width.

CMS-Section-Padding ​

SCSStheme.jsonDefault
$guppy-cms-section-padding-xguppy-cms-section-padding-x48px
$guppy-cms-section-padding-yguppy-cms-section-padding-y48px
$guppy-cms-section-padding-y-2xguppy-cms-section-padding-y-2x96px

Buttons und Inputs ​

SCSStheme.jsonDefault
$sw-input-btn-font-sizesw-input-btn-font-size16px
$sw-input-btn-border-radiussw-input-btn-border-radius4px
$sw-input-btn-font-weightsw-input-btn-font-weightnormal
$guppy-input-border-colorguppy-input-border-color$sw-border-color, solange das Feld leer ist

$guppy-input-border-color (seit 2.9.0) steuert $input-border-color, $form-check-input-border (1px solid) und $dropdown-border-color und darüber .form-control, .form-select, .form-check-input, .dropdown-menu, .input-group-text, die Buttons der Header-Suche und die Toggles des Filter-Panels. Bootstrap leitet $dropdown-divider-bg und $dropdown-dark-border-color (und darüber $dropdown-dark-divider-bg) aus $dropdown-border-color ab, daher folgen auch die Dropdown-Trenner und das dunkle Dropdown; $form-select-border-color folgt $input-border-color. Ein Child-Theme, das $input-border-color selbst setzt, behält seinen Wert. Formularelemente brauchen 3:1 Kontrast zum Hintergrund (WCAG 1.4.11).

Button-Größen ​

Seit 2.9.0, in custom.scss:

SCSSDefaultVerwendung
$guppy-btn-min-height48pxmin-height und min-width von .btn, Höhe und Mindestbreite der Pagination-Elemente, Höhe des Schließen-Buttons im Offcanvas, Größe der Optionen im Produkt-Konfigurator
$guppy-btn-min-height-sm40px.btn-sm
$guppy-btn-min-height-lg48px.btn-lg, .btn-group-lg > .btn und, über dessen @extend .btn-lg, .btn-buy; die .btn-lg-Regel wird nur ausgegeben, wenn der Wert von $guppy-btn-min-height abweicht
$guppy-btn-buy-padding-y$btn-padding-yKaufen-Button (.btn-buy)
$guppy-btn-buy-padding-x$btn-padding-xKaufen-Button
$guppy-btn-buy-font-size$btn-font-sizeKaufen-Button
$guppy-btn-buy-line-height$btn-line-heightKaufen-Button

Die Defaults entsprechen den bisherigen festen Werten, die Ausgabe ist also unverändert. Ein kleinerer $guppy-btn-min-height verkleinert alle oben genannten Bedienelemente. Die $guppy-btn-buy-*-Variablen bestimmen die Größe des Kaufen-Buttons, ohne die anderen Buttons zu ändern.

Eckenradius ​

Seit 2.9.0 wird der Satz an Radien aus einem Basiswert abgeleitet (bootstrap.scss, Abschnitt "Borders"):

SCSStheme.jsonDefault
$guppy-border-radius-baseguppy-border-radius0.25rem (Feld 4px)
$border-radius–$guppy-border-radius-base
$border-radius-sm–Basis × 0.6 (0.15rem)
$border-radius-lg–Basis × 1.5 (0.375rem)
$border-radius-xl–Basis × 3 (0.75rem)
$border-radius-2xl–Basis × 6 (1.5rem)
$guppy-logo-radius–$border-radius-lg (Footer-Logos)
$guppy-slider-arrow-radiusguppy-slider-arrows-round$border-radius * 2; $border-radius-pill, wenn der Switch aktiv ist

Das Feld rechnet px in rem um (/16), behält rem und liest einen Wert ohne Einheit als px; ein leeres Feld oder eine andere Einheit ergibt 0.25rem. Alle Variablen sind !default: Ein eigener $guppy-border-radius-base des Child-Themes gewinnt gegenüber dem Feld und skaliert den ganzen Satz; ein Child-Theme, das nur $border-radius setzt, behält seinen Wert, während die abgeleiteten Radien weiter dem Feld folgen. $border-radius-xxl (.rounded-5, 2rem) und $border-radius-pill setzt Guppy nicht. Text-Logos für Zahlungsarten tragen .rounded-2 (den Basisradius). $guppy-slider-arrow-radius gilt für .splide-slider .splide__arrow und .splide__toggle (Elemente Bild-Slider, Bildergalerie, Splide-Slider); die Produkt- und Cross-Selling-Slider des Cores (.base-slider-controls-*) sind nicht betroffen. Setze die Variable im Child-Theme auf 50% für runde Pfeile; ihr Wert gewinnt gegenüber dem Switch.

Icons ​

SCSSDefaultVerwendung
$icon-base-size22pxBasisgröße
$icon-base-colorcurrentColorVererbt Textfarbe
$icon-accessibility-touch-size44pxMin. Touch-Target (WCAG 2.5.5)

Phosphor-Glyphen für Bedienelemente ​

Ist der Switch guppy-ui-icons-phosphor aktiv (seit 2.9.0), bekommen diese Bootstrap-Variablen (bootstrap.scss, Abschnitt "Forms & Inputs") Phosphor-Glyphen in der Stärke Bold als Data-URIs:

SCSSGlypheWo
$btn-close-bgx.btn-close
$form-select-indicatorcaret-down.form-select
$form-check-input-checked-bg-imagecheckCheckbox-Haken
$accordion-button-icon, $accordion-button-active-iconcaret-down.accordion-button (kein Guppy- oder Core-Template rendert ihn)
$form-feedback-icon-validcheck-circleValidierungs-Icon, nur mit $enable-validation-icons: true (Guppy: false)
$form-feedback-icon-invalidwarning-circleValidierungs-Icon, wie oben

Jede viewBox beschneidet Phosphors 256er-Raster so, dass die Glyphe die Fläche der Bootstrap-Glyphe abdeckt (auf 10 % genau). Die Farben kommen aus Bootstraps eigenen Farbvariablen, und Bootstraps escape-svg() läuft an den Verwendungsstellen. Radio, unbestimmte Checkbox, Switch und die Varianten für den Dark Mode behalten die Bootstrap-Glyphen. Die Werte sind !default, daher gewinnt ein eigener Wert des Child-Themes für jede von ihnen (oder für ihre Farbvariablen). Ein Child-Theme erbt den Wert des Switches von Guppy, solange es keinen eigenen speichert. Mit inaktivem Switch ist die Ausgabe unverändert.

Produktbilder ​

SCSSDefaultVerwendung
$product-image-height240pxStandardhöhe
$product-image-height-lgfit-contentHöhe auf großen Bildschirmen
$product-image-aspect-ratio10/9Aspect-Ratio
$product-image-background$sw-color-product-imageHintergrund

Accessibility ​

SCSSDefaultVerwendung
$focus-outline-width2pxFocus-Rahmenbreite
$focus-outline-colorguppy-focus-color, sonst $sw-color-brand-primaryFocus-Rahmenfarbe (focus-style(), --bs-btn-focus-outline-color)
$focus-outline-offset2pxAbstand zum Element
$focus-outline-box-shadow0 0 0 2px #fffzusätzlicher Schatten
$focus-ring-colorguppy-focus-color, sonst $primary, mit $focus-ring-opacity (0.6)Bootstrap-Focus-Ring (--bs-focus-ring-color)
$input-btn-focus-box-shadow0 0 $focus-ring-blur $focus-ring-width, Farbe wie oben mit $guppy-input-btn-focus-opacityFocus-Schatten von Formularfeldern und Buttons
$guppy-input-btn-focus-opacity0.25Deckkraft dieses Focus-Schattens
$input-focus-border-colorguppy-focus-color, sonst $sw-color-brand-primaryFocus-Rahmen von Formularfeldern, dem Suchfeld im Header und seinem Button
$guppy-modal-close-sizenullfeste Größe des Schließen-Buttons im Modal

Das Theme-Feld guppy-focus-color (seit 2.9.0) befüllt die vier Focus-Variablen; leer bleibt es bei der Primärfarbe, die Ausgabe ist also unverändert. $input-focus-border-color befüllt außerdem $form-select-focus-border-color, $form-check-input-focus-border und $form-switch-focus-color. Bootstraps $input-btn-focus-color-opacity setzt Guppy nicht, und die Focus-Schatten der Validierungszustände behalten $focus-ring-opacity. Alle sind !default, daher gewinnt ein eigener Wert des Child-Themes. Der Fokusindikator braucht 3:1 Kontrast (WCAG 1.4.11).

Geändert in 2.9.0: Focus-Schatten und Focus der Header-Suche

$input-btn-focus-box-shadow war bisher ein fester Wert 0 0 0 0.2rem mit Deckkraft .25. Jetzt folgt er $focus-ring-width, $focus-ring-blur und $guppy-input-btn-focus-opacity; mit Guppys Werten ist die Ausgabe unverändert. Ein Child-Theme, das $focus-ring-width oder $focus-ring-blur setzt, ändert jetzt auch diesen Schatten, damit er zu seinem Focus-Ring passt. Um den bisherigen Schatten zu behalten, setze $input-btn-focus-box-shadow im Child-Theme. Der Focus-Rahmen des Suchfelds im Header und seines Buttons (.header-search-input:focus) folgt jetzt $input-focus-border-color statt der Primärfarbe, ein Child-Theme, das $input-focus-border-color setzt, ändert ihn also mit.

$guppy-modal-close-size (seit 2.9.0): Solange null, behält .modal-header .btn-close Bootstraps Größe aus $modal-header-padding-y/-x (10px). Wenn gesetzt, zum Beispiel auf 44px für ein größeres Touch-Target, bekommt der Button genau diese Breite und Höhe (box-sizing: border-box, kein Schrumpfen), und seine vertikalen Margins werden zu -$modal-header-padding-y (Bootstrap: die Hälfte davon); der horizontale Margin bleibt. Der Header wächst nur, wenn der Button höher ist als die Titelzeile plus beide Paddings: Mit 44px und 10px Padding ist er 44px statt 36px hoch.

Lieferstatus ​

SCSSDefault
$guppy-delivery-shipping-free-color#023B5A
$guppy-delivery-shipping-free-background#CEEDFE
$guppy-delivery-available-color#154634
$guppy-delivery-available-background#D3F2E7
$guppy-delivery-restock-color#5D3B00
$guppy-delivery-restock-background#FFEFD4
$guppy-delivery-soldout-color#303030
$guppy-delivery-soldout-background#EEEEEE

Badges ​

theme.jsonDefault
guppy-badges-new-background-color#22C087
guppy-badges-new-color#FFFFFF
guppy-badges-top-seller-background-color#F89C00
guppy-badges-top-seller-color#FFFFFF
guppy-badges-discount-background-color#E10036
guppy-badges-discount-color#FFFFFF
guppy-badges-out-of-stock-background-color#EEEEEE
guppy-badges-out-of-stock-color#303030

Alerts ​

theme.jsonDefault
guppy-alert-color-success#D3F2E7
guppy-alert-color-info#CEEDFE
guppy-alert-color-warning#FFEFD4
guppy-alert-color-danger#FDE2E7
SCSSDefaultVerwendung
$guppy-alert-outline-color#303030Outline von Alerts (guppy-alert-alert-outline-active), vor 2.9.0 ein fester Wert
$guppy-alert-success-text-colornullfeste Text- und Icon-Farbe von Success-Alerts
$guppy-alert-info-text-colornulldasselbe für Info-Alerts
$guppy-alert-warning-text-colornulldasselbe für Warning-Alerts
$guppy-alert-danger-text-colornulldasselbe für Danger-Alerts

Solange eine Textfarb-Variable null ist, behält der Alert den hellen oder dunklen Helligkeitsfilter aus dem Feld guppy-alert-color-<state>-text, die Ausgabe ist also unverändert. Wenn gesetzt, nutzen Icon und Text dieses Zustands die Farbe, und der Filter entfällt, unabhängig vom Feld hell/dunkel. Links im Alert behalten ihre Linkfarbe.

Mixins (Auswahl) ​

MixinZweck
focus-styleeinheitliche Focus-Rahmen
line-height($value)responsive Line-Heights
rlh($value, $property)RLH-Variante mit Property-Wahl
button-adaptive-hover($base-color)Hover nur bei (hover: hover)
text-ellipsiseinzeiliges Ellipsis
text-clamp($lines)mehrzeiliges Ellipsis
visually-hiddenScreen-Reader-only

Functions ​

FunctionZweck
px-to-rem($px)Pixel zu rem
strip-unit($value)Einheit entfernen
shade-color($color, $weight)Farbe abdunkeln (Bootstrap)
tint-color($color, $weight)Farbe aufhellen (Bootstrap)
shift-color($color, $weight)je nach Helligkeit (Bootstrap)

Verwandt ​