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
| Datei | Zweck |
|---|---|
abstract/variables/bootstrap.scss | Bootstrap-Overrides, bindet $sw-*-Tokens an Bootstrap-Defaults |
abstract/variables/custom.scss | Guppy-eigene Tokens (Lieferstatus, Produktbilder, Focus, Icons …) |
theme.json | Admin-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
| SCSS | theme.json | Default | Verwendung |
|---|---|---|---|
$sw-color-brand-primary | sw-color-brand-primary | #215AFF | Primärfarbe |
$sw-color-brand-secondary | sw-color-brand-secondary | #0B1845 | Sekundärfarbe |
$sw-background-color | sw-background-color | #FFFFFF | Hintergrund |
$sw-border-color | sw-border-color | #CFD1D7 | Rahmen |
$sw-text-color | sw-text-color | #1B1F29 | Textfarbe |
$sw-headline-color | sw-headline-color | #1B1F29 | Überschriften |
Graustufen
| SCSS | Default |
|---|---|
$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
| SCSS | theme.json | Default |
|---|---|---|
$sw-font-size-base | sw-font-size-base | 1rem |
$sw-h1-font-size | sw-h1-font-size | 32px |
$sw-h2-font-size | sw-h2-font-size | 24px |
$sw-h3-font-size | sw-h3-font-size | 20px |
$sw-h4-font-size | sw-h4-font-size | 18px |
$sw-h5-font-size | sw-h5-font-size | 16px |
$sw-h6-font-size | sw-h6-font-size | 15px |
$sw-h1-line-height | sw-h1-line-height | 44px |
$sw-h2-line-height | sw-h2-line-height | 36px |
$sw-h3-line-height | sw-h3-line-height | 32px |
$sw-h4-line-height | sw-h4-line-height | 28px |
$sw-h5-line-height | sw-h5-line-height | 24px |
$sw-h6-line-height | sw-h6-line-height | 21px |
$body-secondary-color | guppy-text-secondary-color | $sw-text-color, solange das Feld leer ist |
$headings-font-family | sw-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
| SCSS | Default |
|---|---|
$guppy-container-width-default | 1400px |
$guppy-container-width-fluid | 100% |
$guppy-container-width-sm | 1230px |
$guppy-container-default-padding-x-mobile | 10px |
$guppy-container-default-padding-x-sm | 24px |
$guppy-container-default-padding-x-md | 48px |
$guppy-container-default-padding-x-lg | 48px |
$guppy-container-default-padding-x-xl | 48px |
$guppy-container-default-padding-x-xxl | 48px |
Container-Padding (.container*-Klassen)
Seit 2.9.0 hat das horizontale Padding der .container*-Klassen eigene Variablen in custom.scss:
| SCSS | Default |
|---|---|
$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
| SCSS | theme.json | Default |
|---|---|---|
$guppy-cms-section-padding-x | guppy-cms-section-padding-x | 48px |
$guppy-cms-section-padding-y | guppy-cms-section-padding-y | 48px |
$guppy-cms-section-padding-y-2x | guppy-cms-section-padding-y-2x | 96px |
Buttons und Inputs
| SCSS | theme.json | Default |
|---|---|---|
$sw-input-btn-font-size | sw-input-btn-font-size | 16px |
$sw-input-btn-border-radius | sw-input-btn-border-radius | 4px |
$sw-input-btn-font-weight | sw-input-btn-font-weight | normal |
$guppy-input-border-color | guppy-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:
| SCSS | Default | Verwendung |
|---|---|---|
$guppy-btn-min-height | 48px | min-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-sm | 40px | .btn-sm |
$guppy-btn-min-height-lg | 48px | .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-y | Kaufen-Button (.btn-buy) |
$guppy-btn-buy-padding-x | $btn-padding-x | Kaufen-Button |
$guppy-btn-buy-font-size | $btn-font-size | Kaufen-Button |
$guppy-btn-buy-line-height | $btn-line-height | Kaufen-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"):
| SCSS | theme.json | Default |
|---|---|---|
$guppy-border-radius-base | guppy-border-radius | 0.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-radius | guppy-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
| SCSS | Default | Verwendung |
|---|---|---|
$icon-base-size | 22px | Basisgröße |
$icon-base-color | currentColor | Vererbt Textfarbe |
$icon-accessibility-touch-size | 44px | Min. 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:
| SCSS | Glyphe | Wo |
|---|---|---|
$btn-close-bg | x | .btn-close |
$form-select-indicator | caret-down | .form-select |
$form-check-input-checked-bg-image | check | Checkbox-Haken |
$accordion-button-icon, $accordion-button-active-icon | caret-down | .accordion-button (kein Guppy- oder Core-Template rendert ihn) |
$form-feedback-icon-valid | check-circle | Validierungs-Icon, nur mit $enable-validation-icons: true (Guppy: false) |
$form-feedback-icon-invalid | warning-circle | Validierungs-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
| SCSS | Default | Verwendung |
|---|---|---|
$product-image-height | 240px | Standardhöhe |
$product-image-height-lg | fit-content | Höhe auf großen Bildschirmen |
$product-image-aspect-ratio | 10/9 | Aspect-Ratio |
$product-image-background | $sw-color-product-image | Hintergrund |
Accessibility
| SCSS | Default | Verwendung |
|---|---|---|
$focus-outline-width | 2px | Focus-Rahmenbreite |
$focus-outline-color | guppy-focus-color, sonst $sw-color-brand-primary | Focus-Rahmenfarbe (focus-style(), --bs-btn-focus-outline-color) |
$focus-outline-offset | 2px | Abstand zum Element |
$focus-outline-box-shadow | 0 0 0 2px #fff | zusätzlicher Schatten |
$focus-ring-color | guppy-focus-color, sonst $primary, mit $focus-ring-opacity (0.6) | Bootstrap-Focus-Ring (--bs-focus-ring-color) |
$input-btn-focus-box-shadow | 0 0 $focus-ring-blur $focus-ring-width, Farbe wie oben mit $guppy-input-btn-focus-opacity | Focus-Schatten von Formularfeldern und Buttons |
$guppy-input-btn-focus-opacity | 0.25 | Deckkraft dieses Focus-Schattens |
$input-focus-border-color | guppy-focus-color, sonst $sw-color-brand-primary | Focus-Rahmen von Formularfeldern, dem Suchfeld im Header und seinem Button |
$guppy-modal-close-size | null | feste 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
| SCSS | Default |
|---|---|
$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.json | Default |
|---|---|
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.json | Default |
|---|---|
guppy-alert-color-success | #D3F2E7 |
guppy-alert-color-info | #CEEDFE |
guppy-alert-color-warning | #FFEFD4 |
guppy-alert-color-danger | #FDE2E7 |
| SCSS | Default | Verwendung |
|---|---|---|
$guppy-alert-outline-color | #303030 | Outline von Alerts (guppy-alert-alert-outline-active), vor 2.9.0 ein fester Wert |
$guppy-alert-success-text-color | null | feste Text- und Icon-Farbe von Success-Alerts |
$guppy-alert-info-text-color | null | dasselbe für Info-Alerts |
$guppy-alert-warning-text-color | null | dasselbe für Warning-Alerts |
$guppy-alert-danger-text-color | null | dasselbe 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)
| Mixin | Zweck |
|---|---|
focus-style | einheitliche 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-ellipsis | einzeiliges Ellipsis |
text-clamp($lines) | mehrzeiliges Ellipsis |
visually-hidden | Screen-Reader-only |
Functions
| Function | Zweck |
|---|---|
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
- Variablen & Tokens: erläuterte Architektur-Übersicht.
- Konfigurationsschema: vollständige
theme.json-Feldreferenz. - Twig-Blöcke: Templates, die diese Variablen konsumieren.