Files
laraundfelix/docs/architektur/designsystem.md
T
Lars 2d54d39c24
Deploy Test / test (push) Successful in 2m26s
Deploy Test / deploy (push) Successful in 41s
Merge remote-tracking branch 'origin/develop' into feature/kopfzeile-desktop-menue-merge
2026-11-22 18:04:37 +01:00

229 lines
25 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Gemeinsames Designsystem (ADR-36) – umgesetzter Stand
Stand: 22.11.2026 (Größenskala, ADR-44, Abschnitt 15); davor 18.11.2026, Designiteration 1 (Branch `feature/design-iteration-1`; Vorstand 17.11.2026 `feature/cms-sections`). Gilt für öffentliche Website, Anmeldung, Mitgliederbereich und Mitgliederbibliothek; später für Warenkorb und Checkout. Die Verwaltung nutzt dieselben Markenfarben und Schriftrollen. Ihre Maße und der Arbeitsplatzrahmen stehen in [Verwaltungstokens](../ux/verwaltung/tokens.md) und folgen dem [Verwaltungsstandard](../ux/verwaltung/14-verwaltungsstandard.md). Öffentliche Website und fachliche Verträge bleiben davon unberührt.
**Status der Werte:** Alle Markenwerte, Schriften und die Wortmarke sind **vorläufig**. Sie stammen aus `docs/Brand-UI-Kit/02_design_tokens` (Entwurf vom 15.11.2026, aus den Originalmotiven abgeleitet, laut Kit nicht freigegeben) und aus der Empfehlung im Website-Zielkonzept §7.2. Diese Datei ist keine Markenfreigabe. Eine Freigabe ändert ausschließlich `resources/css/tokens.css` (und für die Wortmarke `resources/views/components/site/brand.blade.php`, für die Markenakzente `resources/views/components/brand/`).
## 1. Dateien
| Datei | Inhalt |
|---|---|
| `resources/css/tokens.css` | Ebene 1 Markenwerte (`--lf-*`), Ebene 2 Bedeutungswerte (`--color-*`), **Größenskala** (zehn Basiswerte `--ds-*` und alle abgeleiteten Größen, Abschnitt 15), Rundungen, Layoutmaße, Flächen-Gültigkeitsbereiche `.scope-dark`, `.scope-accent`, `.scope-light` |
| `app/Domain/Design/` | `DesignScale` (Basiswerte, Wertebereiche, Prüfung), `DesignSettings` (Lesen, Speichern, Zurücksetzen, Inline-Stylesheet), `SiteSetting` (Tabelle `site_settings`) |
| `app/Filament/Pages/DesignGroessen.php` | Verwaltungsseite „Website → Design → Größen“ |
| `resources/css/base.css` | Grundelemente, Überschriften, Links, Fokus, Sprunglink, `prefers-reduced-motion` |
| `resources/css/components.css` | Grundkomponenten: Container, Schaltflächen, Formulare, Statusanzeigen, Karte, Dialog, Kennzeile, Themensignatur, Redaktionshinweise |
| `resources/css/site.css` | Website-Gerüst: Wortmarke, Kopfzeile (zwei Zustände), Hauptnavigation, Menümodus, Inhaltsfläche, Fußbereich, Markenakzente |
| `resources/views/components/brand/` | Markenakzente als Blade-Komponenten: `underline` (Unterstreichung), `rays` (Signalstrahlen), `arc` (grüner Bogen); dekorativ, `aria-hidden`, Farbe über Tokens |
| `resources/js/site-nav.js` | Menü, Fokusfalle, Untermenüs, kompakter Zustand, Wiederholung der Breitenmessung (die Messung selbst steht inline in `components/site/header.blade.php`) |
| `resources/css/sections.css` | Abschnitte, Raster, Flächen, Hintergrundbilder, Trenner |
| `resources/css/widgets.css` | Widget-Ansichten (Container-Abfragen) |
| `resources/css/app.css` | bindet alles ein; Mitgliederbereich über seine bisherigen Variablennamen, die auf die gemeinsamen Tokens zeigen |
| `vite.config.js` | Schriften Nunito (700, 800) und Source Sans 3 (400, 600), beim Build lokal abgelegt; keine Anfrage an Fremdserver zur Laufzeit |
## 2. Markenwerte (Ebene 1, vorläufig)
| Token | Wert | Herkunft | Verwendung |
|---|---|---|---|
| `--lf-navy` | `#032551` | Brand-UI-Kit, Titelmotiv | Überschriften, Navigation, dunkle Flächen, Fußbereich |
| `--lf-navy-deep` | `#01244c` | Brand-UI-Kit | Reserve |
| `--lf-green` | `#5b8625` | Brand-UI-Kit | nur Flächen ohne Text (Weiß darauf nur 4,3:1) |
| `--lf-green-deep` | `#3b7b09` | Brand-UI-Kit | Aktionsfläche, Markenakzent, Link-Hover |
| `--lf-yellow` | `#fcd10a` | Brand-UI-Kit | Akzentlinien, Trenner, aktive Navigation, Fokus auf dunklen Flächen; nie Textfarbe auf hellem Grund |
| `--lf-cream` | `#f7f6f2` | Brand-UI-Kit | helle Markenfläche |
| `--lf-white` | `#ffffff` | Brand-UI-Kit | Seitenfläche, Karten |
| `--lf-ink` | `#15243a` | Brand-UI-Kit | Fließtext |
| `--lf-ink-muted` | `#3e4c5c` | bisheriger Mitgliederbereich | leiser Text |
| `--lf-line` | `#d5ddd6` | bisheriger Mitgliederbereich | Linien |
| `--lf-focus` | `#1769aa` | Brand-UI-Kit | Fokusrahmen auf hellem Grund |
Nicht übernommen: Farbwerte der KI-Konzeptgrafiken (`04_visuelle_entwuerfe`) und die nur in der HTML-Vorschau verwendeten Zwischentöne.
## 3. Bedeutungswerte (Ebene 2)
`--color-text`, `--color-text-muted`, `--color-heading`, `--color-link`, `--color-link-hover`, `--color-surface`, `--color-surface-subtle`, `--color-surface-raised`, `--color-border`, `--color-border-strong`, `--color-focus`, `--color-accent`, `--color-action`, `--color-action-hover`, `--color-action-text`, `--color-action-secondary-text`, `--color-success(-surface)`, `--color-warning(-surface)`, `--color-danger(-surface)`, `--color-info(-surface)`, `--color-disabled(-surface)`, `--color-theme-1` bis `--color-theme-5`.
Komponenten und Widgets verwenden nur diese Werte. Dunkle Flächen, Markenakzent und Hintergrundbilder setzen sie über `.scope-dark`, `.scope-accent` und `.scope-light` neu; Karten mit eigener heller Fläche setzen sie lokal zurück. Dadurch funktionieren alle Widgets auf allen Abschnittsflächen ohne Sonderregeln.
## 4. Kontraste (berechnet nach WCAG-Formel)
| Paar | Kontrast | Anforderung |
|---|---|---|
| Fließtext `#15243a` auf Weiß / Creme | 15,61 / 14,43 : 1 | Text 4,5 |
| Leiser Text `#3e4c5c` auf Weiß / Creme | 8,78 / 8,11 : 1 | Text 4,5 |
| Navy (Überschrift, Link) auf Weiß | 15,14 : 1 | Text 4,5 |
| Weiß auf Aktionsgrün `#3b7b09` (Schaltfläche, Markenakzent, Wortmarken-Schild, Programmtafel auf dunkler Fläche) | 5,22 : 1 | Text 4,5 |
| Grün dunkel auf Weiß (Art „Programm“/„Modul“ in Listen) | 5,22 : 1 | Text 4,5 |
| Navy auf Gelb (Markenschaltfläche `.button-brand`) / Hover `#ffe05c` | 10,28 / 11,58 : 1 | Text 4,5 |
| Navy auf Creme (Tafel der Markenbühne) | 14,00 : 1 | Text 4,5 |
| Fußbereich Grundzeile `#f4f6f8` auf Grün dunkel (falls der Bogen Links berührt) | 4,82 : 1 | Text 4,5 |
| Text `#f4f6f8` / leise `#d3dde8` auf Navy | 13,97 / 11,01 : 1 | Text 4,5 |
| Navy auf Gelb (Schaltfläche auf dunkler Fläche) | 10,28 : 1 | Text 4,5 |
| Leiser Text `#eef4e8` auf Aktionsgrün | 4,66 : 1 | Text 4,5 |
| Fokus `#1769aa` auf Weiß; Gelb auf Navy; Gelb auf Grün | 5,77 / 10,28 / 3,55 : 1 | Nicht-Text 3 |
| Warnung, Fehler, Erfolg auf ihrer Fläche | 7,36 / 7,69 / 6,86 : 1 | Text 4,5 |
| Deaktiviert `#6b7682` auf `#eceeec` | 3,97 : 1 | deaktivierte Bedienelemente sind ausgenommen |
| Text auf heller Bildüberlagerung (ungünstigster Bildpunkt schwarz) | 10,74 : 1 | Text 4,5 |
| Text auf dunkler Bildüberlagerung (ungünstigster Bildpunkt weiß) | 7,06 : 1 | Text 4,5 |
Die Werte sind gerechnet; eine Messung mit Prüfwerkzeug an der gerenderten Seite steht vor der Farbfreigabe aus (Website-Zielkonzept §5.3).
## 5. Typografie, Abstände, Maße
| Bereich | Wert |
|---|---|
| Auszeichnung (H1–H3, Wortmarke) | Nunito 700/800, vorläufig |
| Lesen und Bedienen | Source Sans 3 400/600 (bereits bisher verwendet) |
| Skala | Seit ADR-44 aus Basiswerten abgeleitet (Abschnitt 15). Standard bei Desktop: Fließtext 17 px (Smartphone 16), Zeilenhöhe 1,55; H3 20; H2 28; H1 40; Display bis 52; kleine Schrift 14; Schaltflächen 15; Lesebreite 70 Zeichen |
| Abstände | Basisabstand 8 px (einstellbar): halber bis zwölffacher Wert = 4, 8, 12, 16, 24, 32, 48, 64, 96 px |
| Rundungen | 8 (klein), 14 (Karte), 22 (Fläche), Pille |
| Breiten | Lesebereich 44 rem, Standard 1312 px (einstellbar), Breit 117 % davon, Vollbreite; Randabstand 16–40 px (siehe Abschnitt 12) |
| Abschnittsabstände | `--section-space-{none,compact,normal,large}` (oben/unten) und `--section-gap-{none,compact,normal,large}` (Widget-Abstand), abgeleitet aus Abschnittsabstand und Basisabstand (Abschnitt 15); Bedeutung in `cms-widget-registry.md` §11 |
| Trefferfläche | mindestens 44 × 44 px |
| Fokus | 3 px Rahmen in `--color-focus`, 3 px Abstand, auf jeder Fläche sichtbar |
Source Serif 4 wird nicht mehr ausgeliefert; die interne Redaktionsvorschau der Bibliothek fällt dort auf Georgia zurück.
## 6. Grundkomponenten
| Komponente | Klassen | Hinweis |
|---|---|---|
| Container | `.ui-container`, `.ui-container-wide` | Standard- bzw. breite Inhaltsbreite mit Randabstand |
| Schaltfläche | `.button` / `.ui-button`, `-secondary`, `-quiet`, `[disabled]`; `.button-brand` | Haupt-, Neben-, Textaktion; Farben aus der jeweiligen Fläche. `.button-brand` (Gelb, Navy-Schrift) nur für die erste Handlung im Seiteneinstieg |
| Formular | `.form`, `.ui-field`, `.ui-input`, `.ui-field-error`, `.check` | sichtbare Beschriftung, Fehlerzustand über `aria-invalid` |
| Statusanzeige | `.status`, `.errors`, `.ui-notice-{success,warning,danger,info}` | Farbe, Randlinie und Text, nie Farbe allein |
| Karte | `.ui-card`, `.empty` | helle Fläche mit Linie |
| Dialog | `.ui-dialog` (natives `dialog`) | Hintergrund abgedunkelt |
| Kennzeile | `.ui-flag` | gelbe Linie vor Großbuchstaben-Kennzeile |
| Themensignatur | `.ui-theme-signature[data-theme=1…5]`, `.ui-theme-signature-mark` | siehe Abschnitt 8 |
Die bestehenden Klassen des Mitgliederbereichs (`body.member …`) bleiben; ihre Variablen (`--text`, `--aktion`, `--fokus`, …) zeigen jetzt auf die gemeinsamen Tokens. Werte sind gleich geblieben, nur die Auszeichnungsschrift wechselt von Source Serif 4 zu Nunito.
## 7. Wortmarke und Markenassets
| Asset | Status | Verwendung |
|---|---|---|
| Wortmarke als Weblogo | **freigegebene Gestaltung** (Brand-UI-Kit `08_freigegebene_logovarianten`, 18.11.2026), als Rasterbild mit transparentem Hintergrund; eine Vektorfassung fehlt | Website-Kopfzeile und Fußbereich (`<x-site.brand variant="logo">`, `data-brand-status="freigegeben"`): Kompaktfassung, zugeschnitten als `public/images/brand/lara-felix-logo-kompakt-128.webp` und `-256.webp` (1x/2x); Originaldatei unverändert. Höhe: Kopfzeile 60 px (Ausgangszustand 1,32-fach ≈ 80 px, kompakt 60 px), Smartphone 48 px, Fußbereich 72 px. Mitgliederbereich weiterhin mit Schriftzug (`variant="plain"`) |
| Titel-, Denkpause-, Outro-Motiv (`01_originale`) | Original vorhanden, **öffentliche Nutzung nicht freigegeben** (Quellenmanifest) | nicht verwendet; nicht in `public/` oder den Medienbestand kopiert |
| Figurenreferenzen Lara, Felix, Oma | nur interne Referenz | nicht verwendet |
| SVG-Entwürfe Unterstreichung und Signalstrahlen (`03_svg_entwuerfe`) | neue, nicht freigegebene Vorschläge | **seit Designiteration 1 verwendet** als Akzente: Unterstreichung unter Einstiegs- und Abschnittsüberschriften, Strahlen an Bild- und Tafelecken; nie an der Wortmarke |
| Grüner Bogen | eigene Ableitung nach dem Homepage-Entwurf des Kits | Abschluss des Fußbereichs |
| SVG-Entwürfe Denkblase und Hand | didaktische Symbole der Denkpause | bewusst nicht als Dekor verwendet; gehören in Kursplayer und Lernansichten |
| SVG-Entwurf Monogramm | kein freigegebenes Logo | nicht verwendet, auch nicht als Favicon |
| KI-Konzeptgrafiken (`04_visuelle_entwuerfe`) | erfundene Inhalte, nicht freigegeben | nicht verwendet |
| Themensymbole der fünf Bereiche | nicht entworfen | nicht verwendet; Platz vorbereitet |
Austausch nach Freigabe: Logodatei unter `public/` ablegen und ausschließlich in `components/site/brand.blade.php` einsetzen; Kopfzeile, Fußbereich und Mitgliederbereich verwenden diese eine Komponente.
## 8. Themensignaturen (vorbereitet)
`.ui-theme-signature` trägt Nummer (1–5) und Name des Themenbereichs; `--color-theme-1` bis `--color-theme-5` sind Platzhalter, die bis zur Freigabe alle auf die neutrale helle Fläche zeigen. Unterscheidung erfolgt damit ohne Farbe (Design-Prinzipien §3). Nach Freigabe werden Tönungen in `tokens.css` und Symbole als SVG je Säule ergänzt; Mehrfachzuordnung ist als Reihe von Marken vorgesehen.
## 9. Website-Gerüst (Designiteration 1)
- **Wortmarke**: freigegebene Lara-&-Felix-Wortmarke (Kompaktfassung) als Bild mit festen Maßen im Markup; die Breitenmessung der Navigation stimmt dadurch schon vor dem Laden des Bildes.
- **Kopfzeile, zwei Zustände ohne Layoutsprung.** (Maße seit ADR-44 aus dem Basiswert „Höhe der Kopfzeile“, Standard 80: Box 80 px ab 75 rem, sonst 64 px, kompakte Leiste 64 px, Wortmarke im Ausgangszustand 1,25-fach; die folgenden Pixelangaben nennen den Stand vor ADR-44.) Die Box ist immer `--header-height-initial` hoch (104 px ab 75 rem, sonst 64 px) und klebt mit negativem Abstand (`top: kompakt − initial`). Die innere Leiste (`.site-header-bar`, 72 px) klebt oben. Beim Scrollen wandert sie 16 px nach oben und bleibt dann stehen; der Seitenfluss ändert sich nie. Ein Beobachter (`data-site-header-sentinel`) setzt `.is-compact`: Wortmarke von 1,16-facher auf normale Größe (nur `transform`) und Schatten. Unter `prefers-reduced-motion` ohne Übergang. Ohne JavaScript klebt die Kopfzeile genauso; nur die Wortmarke bleibt groß.
- **Breitenstufen der Navigation** (`site-nav.js`, Messung des echten Platzbedarfs der Einträge): 1. Navigation und Kontozugang mit Beschriftung in einer Zeile; 2. sonst Kontozugang und Warenkorb nur als Symbol (`.is-account-compact`); 3. sonst zusätzlich engere Navigation mit kleinerem Abstand und Schrift (`.is-nav-tight`); 4. sonst und immer unter 75 rem Menümodus (`.is-menu-mode`). Auf dem Desktop steht die Navigation damit offen, der Burger ist dort nur die letzte Stufe (Stand 2026-11-22: luf-test mit 8 Einträgen offen ab 1280 px, bei 1200 px Menümodus). Die Navigation bricht nie um; deshalb ist die Kopfzeile auf allen Seiten gleich hoch, unabhängig von Anzahl und Länge der CMS-Einträge. Die Messung steht inline direkt nach der Kopfzeile (`window.lufHeaderMode`) und setzt die Stufe vor dem ersten Zeichnen; `site-nav.js` wiederholt sie bei Größenänderungen und nach dem Laden der Schriften.
- **Hauptnavigation**: aus `navigation_items` (`header`), aktiver Eintrag mit gelber Markenunterstreichung und `aria-current`, eine Ebene Untermenü als Aufklappliste (Schaltfläche mit `aria-expanded`, Escape schließt, Klick außerhalb schließt).
- **Menümodus**: Menü-Schaltfläche (Symbol und Text) öffnet eine Fläche direkt unter dem sichtbaren Teil der Kopfzeile, 48 px hohe Einträge, Untermenüs eingerückt; Fokus springt in das Menü, Tabulator läuft im Kreis zwischen Schaltfläche und Einträgen, Escape schließt und gibt den Fokus zurück. Keine untere Navigationsleiste auf der Website. Ohne JavaScript bleibt die Navigation unter 75 rem als umbrechende Liste sichtbar.
- **Kontozugang** „Mitgliederbereich“ (für alle Besucher gleich; Gäste werden zur Anmeldung geleitet) und vorbereiteter Warenkorbzugang (`config/cms.php` → `cart.enabled`, Vorgabe aus: es wird nichts ausgegeben).
- **Fußbereich** (dunkle Fläche): Wortmarke, „Themenbereiche“ aus den veröffentlichten Säulen, Gruppen „Service“ und „Kontakt“ aus der CMS-Navigation; „Rechtliches“ in einer eigenen Grundzeile. Grüner Bogen als Abschluss. Leere Gruppen entfallen; es werden keine Kontakt- oder Rechtstexte erfunden.
- **Stabile Geometrie**: `scrollbar-gutter: stable` auf `html` (kurze und lange Seiten gleich breit), `scroll-padding-top` für Sprungziele. Wortmarke, Navigation und Seiteninhalt fluchten im Standardraster.
## 10. Schnittstellen zum Mitgliederbereich
Gemeinsam: Tokens, Schriften, Fokusregeln, Wortmarke (`<x-site.brand>` mit Zusatz „Mitgliederbereich“), Schaltflächen-, Formular- und Statusklassen. Nicht verändert: Layout, Seitenleiste, Bibliotheksnavigation, die bestehende untere Leiste `member-dock` (fünf Einträge, bereits vor dieser Iteration vorhanden), Berechtigungs- und Suchlogik, Kursplayer. Eine Überarbeitung der mobilen Mitgliedernavigation (höchstens vier bis fünf Funktionen) braucht eine eigene UX-Abnahme; die Tokens und Komponenten sind dafür vorbereitet.
## 11. Veredelung mit Design-Skills (Empfehlung)
1. Erst Freigaben einholen (Wortmarke als SVG, Farbwerte, Schriften, Bildmotive mit Rechten); dann nur `tokens.css` und `brand.blade.php` anpassen.
2. Widgets einzeln veredeln: nur `resources/views/widgets/<typ>.blade.php` und `widgets.css`, Klassen und Daten bleiben stabil; Container-Abfragen beibehalten.
3. Themensignaturen als Symbolfamilie entwerfen (Design-Prinzipien §3, Zielkonzept §7.4), dann `--color-theme-*` und Symbole je Säule ergänzen.
4. Hintergrundbilder: textfreie Zuschnitte der Originalmotive mit Fokuspunkt erzeugen (Hintergrundverarbeitung, `srcset`), sobald freigegeben.
5. Sichtprüfung 390/768/1440 px und Kontrastmessung mit Prüfwerkzeug nach jeder Änderung an Markenwerten.
## 12. Breitenmodell (Designiteration 1)
| Stufe | Token | Wert | Abschnittsbreite im Editor | Einsatz |
|---|---|---|---|---|
| Lesebereich | `--width-reading` | 44 rem | `narrow` | lange Texte, Formulare |
| Standard | `--width-standard` | 82 rem | `standard` | Grundraster; Kopfzeile, Fußbereich und Inhalt fluchten hier |
| Breit | `--width-wide` | 96 rem | `wide` | bildstarke Kompositionen |
| Vollbreite | – | 100 % abzüglich Randabstand | `full` | Inhalt bis an den Rand |
Hintergründe reichen immer über die ganze Fensterbreite. `--frame-inset` = `max(Randabstand, (100 % − Standard) / 2)` steht für Inhalte in fensterbreiten Flächen bereit, ohne `100vw` (kein Scrollbalkenfehler). Die randlose Markenbühne der Designiteration 1 ist mit Kit v1.6 entfallen; der Premium-Einstieg ist eine Karte im Abschnitt. Die Schlüssel der Abschnittsbreiten sind gespeicherte Daten und bleiben unverändert; nur die Werte wurden angepasst (vorher 45/75/90 rem).
## 13. Premium-Widgets (Brand-UI-Kit v1.6, ADR-38)
Einstieg und Bild und Text verwenden die Komponenten aus `docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6`, übernommen nach `resources/css/components/lf-hero.css` und `lf-bild-text.css` (über `app.css` geladen; das frühere Hero- und Bild-und-Text-CSS ist entfernt). Die Kit-Variablen `--lf-font-display`, `--lf-font-ui` und `--lf-muted` zeigen in `tokens.css` auf die gemeinsamen Werte. Nunito wird zusätzlich in Stärke 900 lokal ausgeliefert (Überschrift des Einstiegs).
| Paar | Kontrast |
|---|---|
| Label `#17370b` auf `#dff0c0` (Einstieg) | 10,9 : 1 |
| Weiß auf Grün dunkel (Schaltflächen) | 5,22 : 1 |
| Navy auf Creme / Weiß auf Navy (Flächen) | 14,0 / 15,1 : 1 |
| Fließtext `#46556b` auf Creme (Bild und Text) | 7,0 : 1 |
| Label `#295b08` auf Creme; `#fff2b0` auf Navy | 7,5 / 13,4 : 1 |
Bildmotive des Kits (`09_hero_widget/assets`, `10_bild_text_widget/assets`) sind für die öffentliche Verwendung nicht freigegeben; sie wurden nur lokal für die Sichtprüfung verwendet.
## 14. Premium-Karten (Brand-UI-Kit v1.7, Entwurf, ADR-39)
- Komponente `lf-pc` mit Varianten `lf-pc--editorial` (ruhige Textaktion mit gelber Unterstreichung), `lf-pc--media` (Metadatenband, grüne Aktion `--lf-green-deep`), `lf-pc--catalog` (Navy-Tafel ohne Foto, Navy-Aktion).
- Eigene helle Fläche (`--lf-white`, Rand `--lf-line`, Radius `--radius-panel`, Schatten `--shadow-raised`), auch in dunklen Abschnitten; Bildradius `--radius-card`.
- Schriften: Titel `--font-display` 800, Text `--font-reading`; keine neuen Schriften.
- Ab 520 px Platzbreite Bild 42 % neben Text 58 %; Bildformat 16:9, 1:1 oder 3:4 bleibt erhalten; kein line-clamp.
- Status: Entwurf zur visuellen Freigabe; auf der Testinstanz nur mit gekennzeichneten Platzhalterbildern.
## 15. Größenskala (ADR-44, 22.11.2026)
**Ziel.** Eine einzige, zentral steuerbare Größenskala für Website, CMS-Vorschau und gemeinsam genutzte Komponenten; kompakte Darstellung bei 100 % Browserzoom, ohne `zoom`, `transform: scale()` oder globale Prozentskalierung.
### 15.1 Basiswerte (einstellbar)
Pixel als ganze Zahl. Standard und zulässiger Bereich stehen in `App\Domain\Design\DesignScale::PARAMETERS` und (Standard) in `tokens.css` (`--ds-*`).
| Basiswert | Variable | Standard | Bereich | Wirkung |
|---|---|---:|---:|---|
| Fließtext | `--ds-body` | 17 | 16–20 | Desktop; Smartphone 1 px weniger, nie unter 16; leitet kleine Schrift, Einleitung, Überschrift 3, Schaltflächentext ab |
| Überschrift 1 | `--ds-h1` | 40 | 30–56 | Seitentitel Desktop; Smartphone ≈ 70 % |
| Überschrift 2 | `--ds-h2` | 28 | 22–40 | Abschnittstitel; auch Titel in Bild und Text, Handlungsaufruf, breite Karten |
| Display-Überschrift (Höchstwert) | `--ds-display` | 52 | 36–80 | Titel des Einstiegs, wächst mit der Platzbreite bis zu diesem Wert |
| Basisabstand | `--ds-space` | 8 | 6–12 | `--space-1…9` (0,5- bis 12-fach) und `--section-gap-*` |
| Abschnittsabstand (Desktop) | `--ds-section` | 48 | 24–96 | Stufe Normal; Kompakt ⅔, Großzügig 1,5-fach; Smartphone kleiner |
| Karten-Innenabstand | `--ds-card-pad` | 20 | 12–32 | `--pad-card` (Smartphone 80 %), `--pad-surface` (2,4-fach) für große Flächen |
| Höhe der Kopfzeile | `--ds-header` | 80 | 56–112 | Ausgangszustand Desktop; beim Scrollen und mobil 80 %; Anzeigegröße der Wortmarke folgt |
| Maximale Inhaltsbreite | `--ds-width` | 1312 | 960–1600 | Standardraster; Breit = 1,17-fach; Lesebereich bleibt 44 rem |
| Bildhöhe Bild und Text (Desktop) | `--ds-media` | 320 | 200–480 | Bildhöhe Variante Standard; Mindesthöhe des Einstiegs = 1,2-fach |
Prüfregeln (Verwaltung und Lesen): Fließtext + 6 ≤ Überschrift 2; Überschrift 2 + 4 ≤ Überschrift 1 ≤ Display. Nicht einstellbar: Trefferflächen (44 px), Untergrenze 16 px für Fließtext, Fokusdarstellung.
### 15.2 Ableitung und Verwendung
- **Alle Regeln stehen in `tokens.css`.** Fließende Werte zwischen 360 und 1200 px Fensterbreite (`--fl`), Minimum auf kleinen Bildschirmen, Maximum ab 75 rem; Umrechnung in rem, damit die Browser-Textgröße wirkt. Überschriften bleiben auf jeder Breite größer als der Text.
- **Abgeleitete Tokens:** `--text-small|body|lede|h3|h2|h1|display|button`, `--space-1…9`, `--pad-card`, `--pad-surface`, `--section-space-{compact,normal,large}`, `--section-gap-{compact,normal,large}`, `--grid-gap`, `--width-standard|wide`, `--header-height(-initial)`, `--media-h`.
- **Komponenten** (Einstieg, Bild und Text, Premium-Karten, redaktionelle und Katalogkarten, Handlungsaufruf, FAQ, Kopf, Fuß, Schaltflächen) verwenden nur diese Tokens. `cqi` bleibt als Zwischenwert in engen Plätzen, nach oben begrenzt durch das Token (z. B. `clamp(1.4rem, 3.6cqi, var(--text-h2))`). Neue Komponenten definieren keine eigenen Größen.
- **Dichtestufen** der Größenvarianten über `--dens` (kompakt 0,75, standard 1, großzügig 1,3): Einstieg (`compact`, `normal`, `large`) und Bild und Text (`compact`, `normal`, `spacious`) skalieren Bildhöhe, Mindesthöhe, Abstand und Innenabstand einheitlich. Die Mindesthöhen des Einstiegs gelten wie bisher nur ab 860 px Containerbreite; die Regel des Sicherheitsumbruchs steht in `lf-hero.css` nach den Höhenregeln und muss dort bleiben.
- **Bild und Text:** Ab 900 px Containerbreite füllt das Bild seine Spalte und hat die Zielhöhe `--ds-media × --dens` (Standard 320 px, kompakt 240, großzügig 416), unabhängig vom Seitenverhältnis der Datei; es wächst nur, wenn der Text höher ist. Spalten 1,1 : 0,9. Im Streifen (540–899 px) und gestapelt (< 540 px) ist die Bildhöhe auf dieselbe Zielhöhe begrenzt. Der Bildausschnitt folgt weiter dem Fokuspunkt (`--bt-focus-x/y`).
### 15.3 Konfiguration in der Verwaltung
- **Fundstelle:** „Website → Design → Größen“ (`/verwaltung/design/groessen`, Navigationsgruppe „Design“, Kopfzeile „Website / Design / Größen“). Zugriff nur für den Systemverwalter.
- **Ablauf:** Arbeitsstand mit Statuszeile („Änderungen nicht gespeichert“ / „Eigene Werte gespeichert“ / „Standardwerte aktiv“); „Größen speichern“ prüft Wertebereiche und Reihenfolge, schreibt in `site_settings` (Schlüssel `design.scale`) und wirkt **sofort**, ohne Deployment, auf die Website und alle CMS-Vorschauen. „Standardwerte wiederherstellen …“ (mit Bestätigung) löscht die Zeile. „Website ansehen“ zeigt den gespeicherten Stand. Strg+S speichert.
- **Auslieferung:** Abweichende Werte kommen als `<style id="lf-design-scale">` nach dem Stylesheet in `layouts/site`, `layouts/member` und in die Vorschau-Iframes; bei Standardwerten entfällt der Block. Zwischenspeicher `design.scale.v1` wird beim Speichern geleert. Fehlt die Tabelle oder sind die Daten beschädigt, gelten die Standardwerte ohne Fehlerseite.
### 15.4 Gemeinsam genutzt und nur Website
| Wert | Website | Mitgliederbereich (heute) |
|---|---|---|
| Fließtext, Überschrift 3, kleine Schrift, Schaltflächentext, Basisabstand | ja | folgt (gleiche Tokens) |
| Überschrift 1 und 2, Display | ja | ja (seit ADR-45): H1 `--text-h1`, Abschnittstitel `--text-h2`, Kartentitel `--text-h3` |
| Kopfzeile, Inhaltsbreite, Karten-Innenabstand | ja | ja: `--header-height`, `--width-standard`, `--pad-card` |
| Abschnittsabstände, Bildhöhen (Widgets) | ja | Abstände über `--space-*`; Kartenbreite über das abgeleitete Token `--card-min` (80 % von `--ds-media`) |
Der Mitgliederbereich (`resources/css/components/lf-member.css`, ADR-45) verwendet ausschließlich diese Tokens; Karten- und Listentext sind `--text-small`, Trefferflächen `--touch-target`. Er hat keine eigenen Basiswerte.
### 15.5 Abweichung vom Brand-UI-Kit
`lf-hero`, `lf-bild-text` und `lf-premium-card` (Kit v1.6/v1.7) verwenden die Größen der Skala statt eigener `rem`-/`px`-Werte; Aufbau, Varianten, Farben und Schriften sind unverändert. Das Kit bleibt Gestaltungsgrundlage; Größenentscheidungen fallen in der Größenskala.