Führe einen gemeinsamen Layoutvertrag ein und integriere die Premium-Widgets.
Layoutvertrag (ADR-38) in der bestehenden Registry: Jede Widget-Art erklärt zulässige Rasterbreiten (supportedUnits), Höhen aus einem gemeinsamen Vokabular (heights, gespeichert als settings.height), Darstellungsmodi und Verhalten bei wenig Platz. Unzulässige Breiten werden beim Speichern verständlich abgewiesen; Höhe „fill“ streckt den Handlungsaufruf auf die Abschnittszeile. Premium-Widgets nach Brand-UI-Kit v1.6: - hero Version 2: photo_split/editorial_solid, Höhen compact/normal/ large, Label, Überschriftenebene, Akzent, Bildfokus in Prozent, zwei Schaltflächen; nur 3 oder 4 Einheiten. Upgrade aus Version 1. - image_text Version 3: Fläche cream/clear/navy, Höhen compact/normal/ spacious, Label, zwei Schaltflächen, Bildfokus; 1 bis 4 Einheiten. Upgrade aus Version 2 (format entfällt, Fokus in Prozent). - Kit-CSS ersetzt das bisherige Hero- und Bild-und-Text-CSS; der Randlos-Mechanismus der Designiteration 1 entfällt. Editor: Reiter Inhalt/Medien/Darstellung aus der Registry, Auswahl- knöpfe mit Symbolen, Schieberegler für den Bildfokus und eine Live- Vorschau im Dialog mit demselben Renderer in wählbarer Platzbreite. Tests bewusst angepasst: Einstieg braucht jetzt 3 oder 4 Einheiten (vorher Mindestbreite 2), image_text ist Version 3, Klassen der neuen Ansichten; die Hero-/Bild-Tests der Designiteration 1 sind durch CmsPremiumWidgetsTest ersetzt. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
3cdb36e7a3
commit
0bfb53463a
38 files changed
+1755
-856
No files matched your search
@@ -58,6 +58,7 @@ ## Übersicht der Architekturentscheidungen
|
||||
| ADR-35 | Messung | Entwurf / Rechtsprüfung offen | Reichweitenmessung ohne Cookies als Vorschlag; Prüfung offen |
|
||||
| ADR-36 | Designsystem | Designprinzip fest; Tokens offen | Gemeinsame Design-Tokens für Website und Mitgliederbereich |
|
||||
| ADR-37 | n8n-Anbindung | Option / nicht beschlossen | n8n allenfalls für externe Kanäle, ohne direkten Datenbankzugang |
|
||||
| ADR-38 | Layoutvertrag der Widgets | Umgesetzt auf Test (18.11.2026); UX-Abnahme offen | Zulässige Rasterbreiten, Höhen und Verhalten bei wenig Platz je Widget-Art in der bestehenden Registry; Darstellung nach realer Containerbreite |
|
||||
|
||||
---
|
||||
|
||||
@@ -485,3 +486,16 @@ ## ADR-37 – Optionale externe Workflow-Anbindung
|
||||
**Alternativen.** Keine externe Workflow-Engine; n8n als allgemeine Produktsteuerung.
|
||||
**Folgen und offene Prüfung.** Umsetzung erst bei konkret nachgewiesenem Kanalbedarf.
|
||||
**Quelle.** Website-Zielkonzept §12; Website-CMS-Zielarchitektur §9, ADR-37-Tabelle.
|
||||
|
||||
## ADR-38 – Gemeinsamer Layoutvertrag für Widget-Arten
|
||||
|
||||
**Status am 18.11.2026:** Umgesetzt auf `develop`/Testinstanz (Branch `feature/adaptive-widgets`); **UX-Abnahme durch den Betreiber offen**. Ergänzt ADR-30, ersetzt es nicht.
|
||||
**Kontext.** Das Abschnittsraster (vier logische Einheiten, ein Widget je Platz) verteilte Widgets bisher nur mit einer Mindestbreite. Das Brand-UI-Kit v1.6 (`12_premium_widgets_adaptiv_v1.6`) verlangt für die Premium-Widgets bestimmte Rasterbreiten (Einstieg 3–4, Bild und Text 1–4), Höhenvarianten und eine Darstellung nach realer Containerbreite.
|
||||
**Entscheidung.** Jede Widget-Art erklärt in der bestehenden Registry (`WidgetType`) einen gemeinsamen Layoutvertrag:
|
||||
- `supportedUnits()`: zulässige Platzbreiten aus 1–4; ein Platz mit anderer Breite wird beim Speichern mit verständlicher Meldung abgewiesen; `minUnits()` ist daraus abgeleitet.
|
||||
- `heights()`: angebotene Höhen aus einem gemeinsamen Vokabular (`auto`, `compact`, `normal`, `large`, `spacious`, `fill`), gespeichert als `settings.height`, geprüft wie jede Einstellung; Höhen sind Mindestwerte oder Proportionen, nie Begrenzungen.
|
||||
- `stages()` und `narrowBehavior()`: Darstellungsmodi und Verhalten bei reduziertem Platz, im Editor angezeigt.
|
||||
Die Widget-Ansichten entscheiden über Container-Abfragen nach der tatsächlichen Breite, nicht nach der Einheitenzahl. Keine zweite Registry, kein zweites Abschnittsmodell, keine freien CSS-Werte.
|
||||
**Alternativen.** Je Widget eigene Breitenlogik im Editor; feste Pixelhöhen; Höhe als Abschnittseinstellung (verworfen: doppelte, widersprüchliche Einstellmöglichkeit neben Abstand und Raster).
|
||||
**Folgen und offene Prüfung.** Premium-Einstieg (`hero` Version 2) und Bild und Text (`image_text` Version 3) heben ältere Instanzen beim Lesen an; gespeicherte Revisionen bleiben unverändert. Ein Einstieg in einem Platz mit 2 Einheiten ist nicht mehr zulässig (vorher Mindestbreite 2; auf der Testinstanz kein Bestand betroffen). Bewusste Abweichungen vom Kit: Bildfokus als `data.focus_x/focus_y` (Einstellungen tragen nur Aufzählungswerte), Überschriftenebene „Automatisch/H2/H3“ statt freier H1 (genau eine H1 je Seite), Linkziele über die bestehende `SafeUrl`-Regel. Praktische Redaktionsabnahme (Bedienung, Bildzuschnitte mit freigegebenen Motiven) steht aus.
|
||||
**Quelle.** Brand-UI-Kit v1.6 (`docs/Brand-UI-Kit/12_premium_widgets_adaptiv_v1.6`, `docs/layout-profiles.json`); `docs/architektur/cms-widget-registry.md` §§2, 4, 12; ADR-30, ADR-36.
|
||||
@@ -46,7 +46,7 @@ ## 2. Widget-Vertrag
|
||||
| `type` | Typkennung aus dem Register; ändert sich nie |
|
||||
| `v` | Schemaversion der Art |
|
||||
| `variant` | eine der für die Art registrierten Varianten |
|
||||
| `settings` | nur registrierte Aufzählungswerte; freie Werte werden abgewiesen. Seit Designiteration 1: `hero` (`focus`, `text_side`), `image_text` (`format`, `focus`). Fehlt ein Wert, gilt die Vorgabe der Darstellung |
|
||||
| `settings` | nur registrierte Aufzählungswerte (`WidgetType::settingOptions()`, einschließlich der gemeinsamen Höhe `height`); freie Werte werden abgewiesen. Fehlt ein Wert, gilt die Vorgabe der Darstellung |
|
||||
| `data` | redaktionelle Inhalte |
|
||||
| `refs` | Verweise auf Fachobjekte oder Medien, nur Kennungen bzw. Pfade im öffentlichen Bereich `cms/` |
|
||||
|
||||
@@ -62,39 +62,52 @@ ## 3. Versionierung und Altbestand
|
||||
- Unbekannte Widget-Arten werden ausgelassen; unbekannte Raster- oder Gestaltungswerte fallen beim Lesen auf Vorgaben zurück. Eine Hülle mit höherer Version als im Code wird bestmöglich dargestellt, aber nicht gespeichert.
|
||||
- Regel: Optionale neue Felder brauchen keine neue Version. Umbenennen, Umdeuten oder Verschieben von Feldern braucht eine neue Version mit `upgrade()` und einen Test. Gleiches gilt für die Abschnittshülle (`PageSections::VERSION`).
|
||||
|
||||
Beispiel: `image_text` Version 1 `{image, alt, body (Klartext)}` → Version 2 `data {title, body (bereinigtes HTML), alt}`, `refs {image}`, Variante `image_left`.
|
||||
Beispiele:
|
||||
- `image_text` Version 1 `{image, alt, body (Klartext)}` → Version 2 `data {title, body (bereinigtes HTML), alt}`, `refs {image}`, Variante `image_left` → Version 3 (Kit v1.6): `settings.format` entfällt, `settings.focus` wird zu `data.focus_x/focus_y` (Prozent).
|
||||
- `hero` Version 1 → Version 2 (Kit v1.6): Varianten `standard`/`stage` → `photo_split`, `highlight`/`editorial` → `editorial_solid`; `settings.focus` wird zu `data.focus_x/focus_y`, `settings.text_side` entfällt. Die data-Schlüssel (`heading`, `text`, `cta_*`, `alt`) bleiben, damit ein Code-Rollback darstellbar bleibt.
|
||||
|
||||
## 4. Registrierte Widget-Arten
|
||||
|
||||
| Kennung | Name | Version | Varianten | Verweise | Mindestbreite |
|
||||
|---|---|---|---|---|---|
|
||||
| `hero` | Einstieg (Hero) | 1 | `standard` (Bild neben dem Text), `highlight` (Markenfläche), `stage` (Markenbühne, randlos), `editorial` (textbetont) | `refs.image` | 2 |
|
||||
| `heading` | Überschrift und Einleitung | 1 | `standard` | – | 1 |
|
||||
| `prose` | Fließtext | 1 | `standard` | – | 1 |
|
||||
| `image_text` | Bild und Text | 2 | `image_left`, `image_right` | `refs.image` | 2 |
|
||||
| `cards` | Redaktionelle Karten | 1 | `standard` (Raster), `compact` (kompakte Liste), `featured` (erste Karte hervorgehoben) | Bild je Karte in `data.items[].image` | 1 |
|
||||
| `catalog_cards` | Programm- und Modulkarten | 1 | `standard` (Karten mit Kurzbeschreibung), `compact` (Liste) | `refs.items[] = {type: composition, id}` | 1 |
|
||||
| `call_to_action` | Handlungsaufruf | 1 | `standard` | – | 1 |
|
||||
| `faq` | FAQ | 1 | `standard` | – | 2 |
|
||||
| Kennung | Name | Version | Varianten | Breiten (Einheiten) | Höhen | Verweise |
|
||||
|---|---|---|---|---|---|---|
|
||||
| `hero` | Einstieg (Hero), Premium nach Kit v1.6 | 2 | `photo_split` (Foto mit Textfläche), `editorial_solid` (Navy-Markenfläche) | 3, 4 | `compact` (mind. 400 px), `normal` (512 px, Vorgabe), `large` (640 px) | `refs.image` |
|
||||
| `heading` | Überschrift und Einleitung | 1 | `standard` | 1–4 | – | – |
|
||||
| `prose` | Fließtext | 1 | `standard` | 1–4 | – | – |
|
||||
| `image_text` | Bild und Text, Premium nach Kit v1.6 | 3 | `image_left`, `image_right` (Bildseite) | 1–4 | `compact`, `normal` (Vorgabe), `spacious` | `refs.image` |
|
||||
| `cards` | Redaktionelle Karten | 1 | `standard` (Raster), `compact` (Liste), `featured` (erste Karte hervorgehoben) | 1–4 | – | Bild je Karte in `data.items[].image` |
|
||||
| `catalog_cards` | Programm- und Modulkarten | 1 | `standard`, `compact` | 1–4 | – | `refs.items[] = {type: composition, id}` |
|
||||
| `call_to_action` | Handlungsaufruf | 1 | `standard` | 1–4 | `auto` (Vorgabe), `fill` (Abschnittshöhe füllen) | – |
|
||||
| `faq` | FAQ | 1 | `standard` | 2–4 | – | – |
|
||||
|
||||
Darstellungsklassen: `widget widget-<typ> widget-variant-<variante>` an der Widget-Hülle; je Ansicht eigene Klassen (`hero-highlight`, `hero-stage`, `image-text-right`, `image-format-portrait`, `cards-compact`, `cards-featured`, `catalog-cards-compact`). Die visuelle Veredelung verändert nur `resources/views/widgets/*` und `resources/css/widgets.css`, nicht Daten, Register oder Editor.
|
||||
Darstellungsklassen an der Widget-Hülle: `widget widget-<typ> widget-variant-<variante>` und, wenn die Art Höhen anbietet, `widget-height-<höhe>`. Premium-Ansichten: `lf-hero lf-hero--{photo-split|editorial-solid} lf-hero--height-<höhe> lf-hero--accent-<akzent>` und `lf-bt lf-bt--{cream|clear|navy} lf-bt--image-{left|right} lf-bt--height-<höhe>`.
|
||||
|
||||
**Designiteration 1 (additiv, keine neue Version):**
|
||||
**Premium-Widgets (Kit v1.6).** Ansichten `resources/views/widgets/hero.blade.php` und `image_text.blade.php`, Stylesheets `resources/css/components/lf-hero.css` und `lf-bild-text.css` (aus `12_premium_widgets_adaptiv_v1.6/components/*.v1.6.css` übernommen und angepasst; sie ersetzen das frühere Hero- und Bild-und-Text-CSS und werden nicht parallel geladen). Gemeinsame Felder in `App\Domain\Cms\Widgets\Support\PremiumFields`:
|
||||
|
||||
| Art | Neu | Gespeichert als |
|
||||
| Feld | Gespeichert als | Hinweis |
|
||||
|---|---|---|
|
||||
| `hero` | Varianten `stage`, `editorial`; zweite Schaltfläche; Bildausschnitt; Textseite der Markenbühne | `variant`; `data.cta2_label`, `data.cta2_url` (sicheres Linkziel wie `cta_url`); `settings.focus` (Werte wie Abschnittsfokus), `settings.text_side` (`left`, `right`) |
|
||||
| `image_text` | Bildformat und Bildausschnitt | `settings.format` (`landscape`, `portrait`, `square`, `original`), `settings.focus` |
|
||||
| `cards` | Variante `featured`; ganze Karte über den Titellink klickbar | `variant` |
|
||||
| `catalog_cards` | Markentafel statt Bild, eine Karte breit mit Tafel daneben | keine Datenänderung |
|
||||
| Label | `data.eyebrow` | höchstens 80 Zeichen |
|
||||
| Überschrift | `data.heading` (Einstieg), `data.title` (Bild und Text) | |
|
||||
| Beschreibung | `data.text` (Klartext, Einstieg), `data.body` (bereinigter formatierter Text, Bild und Text) | |
|
||||
| Schaltflächen | `data.cta_label/cta_url`, `data.cta2_label/cta2_url` | Linkziele über `SafeUrl` |
|
||||
| Bild, Alternativtext | `refs.image`, `data.alt` | öffentlicher Bereich `cms/`; Alternativtext Pflicht bei Bild |
|
||||
| Bildfokus | `data.focus_x`, `data.focus_y` | ganze Zahlen 0–100; Vorgabe Einstieg 68/50, Bild und Text 64/43 |
|
||||
| Überschriftenebene | `settings.heading_level` | `auto` (Vorgabe), `h2`, `h3`; das erste Widget der Seite ist immer H1 |
|
||||
| Akzent (Einstieg) | `settings.accent` | `underline` (Vorgabe), `rays`, `none` |
|
||||
| Fläche (Bild und Text) | `settings.surface` | `cream` (Vorgabe), `clear` (übernimmt den Abschnitt), `navy` |
|
||||
| Höhe | `settings.height` | gemeinsamer Layoutvertrag (§12) |
|
||||
|
||||
Ältere Instanzen enthalten die neuen Schlüssel nicht und werden mit den Vorgaben dargestellt (Test `CmsDesignIterationTest`). Die erste Schaltfläche des Einstiegs ist jetzt die gelbe Markenschaltfläche (`button button-brand`).
|
||||
|
||||
**Randlos (`WidgetType::bleeds`).** Eine Markenbühne mit Bild, die allein in ihrem Abschnitt steht, setzt am Abschnitt `section-bleed`: kein Innenabstand, keine Breitenbegrenzung, das Bild reicht über die ganze Fensterbreite; die Texttafel richtet sich am Standardraster aus. In mehrspaltigen Abschnitten erscheint dieselbe Bühne als Bild mit runden Ecken und überlappender Tafel.
|
||||
**Abweichungen vom Kit (bewusst):**
|
||||
- Kennungen bleiben `hero` und `image_text`, nicht `lf-brand-hero`/`lf-editorial-bild-text`; Varianten `photo_split`/`editorial_solid` mit Unterstrich, weil Variantenkennungen `^[a-z][a-z0-9_]*$` folgen.
|
||||
- Bildseite von Bild und Text bleibt die Variante (`image_left/right`), nicht zusätzlich `settings.image_side`, damit es keine doppelte Einstellung gibt.
|
||||
- Bildfokus in `data` statt `settings.image_focus`, weil Einstellungen nur Aufzählungswerte tragen.
|
||||
- Überschriftenebene ohne frei wählbare H1 (Regel: genau eine H1 je Seite, erstes Widget).
|
||||
- Linkziele: Seitenpfad, `#Anker`, `http` und `https` (bestehende `SafeUrl`-Regel); das Kit erlaubt nur `https`.
|
||||
- Das Kit lädt das Einstiegsbild immer sofort; hier nur beim ersten Widget der Seite, alle anderen verzögert.
|
||||
- Kit-CSS ergänzt: Überschriften erben Farbe (globale h1–h3-Regeln), Unterstreichung als Block, Fläche `clear` übernimmt die Farben dunkler Abschnitte, Strahlen-Akzent aus `components/brand/rays.blade.php`, Fokusfarbe aus den Tokens.
|
||||
|
||||
## 5. Neues Widget hinzufügen
|
||||
|
||||
1. Klasse unter `app/Domain/Cms/Widgets/Types/` anlegen, von `WidgetType` ableiten. Pflicht: `key()`, `label()`, `description()`, `dataRules()`, `dataFields()`. Je nach Bedarf: `variants()`, `minUnits()`/`preferredUnits()`/`stages()` (Abschnitt 12), `refRules()`, `refFields()`, `clean()` (Links mit `SafeUrl`, Text mit `RichText::sanitize`, Bilder mit `ImageRefFields::clean`), `resolve()`, `mediaPaths()`, `summary()`, `schematic()`, `icon()`.
|
||||
1. Klasse unter `app/Domain/Cms/Widgets/Types/` anlegen, von `WidgetType` ableiten. Pflicht: `key()`, `label()`, `description()`, `dataRules()`, `dataFields()`. Je nach Bedarf: `variants()`, Layoutvertrag `supportedUnits()`/`preferredUnits()`/`heights()`/`stages()`/`narrowBehavior()` (Abschnitt 12), `settings()`/`settingLabels()`/`optionIcons()`, `mediaSchema()` für den Reiter „Medien“, `refRules()`, `refFields()`, `clean()` (Links mit `SafeUrl`, Text mit `RichText::sanitize`, Bilder mit `ImageRefFields::clean`), `resolve()`, `mediaPaths()`, `summary()`, `schematic()`, `icon()`.
|
||||
2. Ansicht `resources/views/widgets/<kennung>.blade.php` anlegen. Verfügbar: `$data`, `$refs`, `$variant`, `$settings`, `$first`, `$context` (Vorschau ja/nein) und die Rückgabe von `resolve()`. Kein `{!! !!}` außer für mit `RichText::sanitize` bereinigten Text. Breitenabhängige Regeln als Container-Abfrage `@container slot (…)`, nicht als Fenster-Medienabfrage; Farben nur über Bedeutungs-Tokens.
|
||||
3. Klasse in `config/cms.php` unter `widgets` eintragen.
|
||||
4. Tests ergänzen (Registrierung und Prüfregeln in `tests/Unit/WidgetRegistryTest.php`, Darstellung in `tests/Feature/CmsWidgetRenderingTest.php` bzw. `CmsSectionRenderingTest.php`).
|
||||
@@ -130,7 +143,9 @@ ## 8. Editor und Vorschau
|
||||
- **Raster**: grafische Auswahl mit sechs Kacheln. Raster mit weniger Plätzen als eingesetzten Widgets sind gesperrt. Beim Wechsel entfallen zuerst leere Plätze; Widgets behalten ihre Reihenfolge (`SectionEditor::arrangeSlots`). Kein Wechsel entfernt ein Widget.
|
||||
- **Gestaltung des Abschnitts** (eingeklappt, Zusammenfassung im Kopf): Hintergrund, Breite, Abstand, Trenner; bei Hintergrundbild zusätzlich Bild (Auswahl oder Upload), Fokuspunkt und Überlagerung. Abschnitts- und Widget-Einstellungen sind getrennt.
|
||||
- **Plätze** stehen im Verhältnis des Desktop-Rasters nebeneinander; Widgets lassen sich per Ziehen zwischen Plätzen tauschen. Der Platzkopf nennt Breite und warnt, wenn das Widget breiter sein müsste. Ein freier Platz bietet „Widget einsetzen“ (Auswahl mit Name, Beschreibung, Symbolbild, Mindestbreite), danach öffnet der Widget-Dialog. Ein Klick auf die Vorschau öffnet denselben Dialog: eine Dialogebene.
|
||||
- **Widget-Vorschau**: dieselbe Ansicht wie öffentlich, im isolierten `iframe` mit dem Website-Stylesheet, in der tatsächlichen Platzbreite (Container-Abfragen greifen). Keine eigene Bildlaufleiste; über 22 rem wird gekürzt mit Hinweis „vollständig in der Seitenvorschau“. Die Abschnittsfläche zeigt erst die Seitenvorschau.
|
||||
- **Widget-Dialog**: Arten mit Darstellungsoptionen oder Medien gliedern den Dialog in die Reiter **Inhalt**, **Medien** und **Darstellung** (generisch aus der Registry: `editorSchema()`, `mediaSchema()`, Varianten und `settingOptions()`); andere Arten zeigen ihre Felder direkt. Varianten und Höhen sind sichtbare Auswahlknöpfe mit Symbol, Bildfokus zwei Schieberegler (0–100). „Darstellung“ nennt die zulässigen Platzbreiten und das Verhalten bei wenig Platz.
|
||||
- **Live-Vorschau im Dialog**: rendert den ungespeicherten Zustand mit derselben Ansicht wie die Website (`WidgetEditor::renderPreview`) in einer wählbaren logischen Platzbreite (Smartphone 390 px und die zulässigen Einheiten: 310/640/960/1300 px, entsprechend dem Standardabschnitt bei 1440 px Fensterbreite) und verkleinert sie auf die Dialogbreite. Die Breitenwahl wird nicht gespeichert.
|
||||
- **Widget-Vorschau im Platz**: dieselbe Ansicht im isolierten `iframe` in der Breite des Platzes im Editor; über 28 rem gekürzt mit Hinweis „vollständig in der Seitenvorschau“.
|
||||
- „Entwurf speichern“ erzeugt eine Revision (bei unverändertem Stand keine weitere). „Veröffentlichen“ speichert zuerst den aktuellen Stand im Editor und veröffentlicht genau diesen; enthält er Fehler, wird nichts veröffentlicht. Vorher veröffentlichte „Veröffentlichen“ nur die zuletzt gespeicherte Revision, sodass übernommene, aber ungespeicherte Änderungen (etwa ein gewähltes Bild) verloren gingen.
|
||||
- Verlassen oder Neuladen mit ungespeicherten Änderungen löst eine Warnung des Browsers aus.
|
||||
- Ganzseitige Vorschau: `/redaktion/vorschau/{revision}/geraete` mit Umschaltern 390/768/1440 px; zeigt Kopfzeile, Navigation, Abschnitte, Flächen, Trenner und Fußbereich mit demselben Renderer wie die öffentliche Seite; `noindex`.
|
||||
@@ -172,6 +187,8 @@ ## 9. Rollback und Datenformat (wichtig vor dem Merge nach `main`)
|
||||
|
||||
Die Migrationen (`sections`, `parent_id`) sind ergänzend und müssen beim Rollback nicht zurückgenommen werden; älterer Code ignoriert beide Spalten.
|
||||
|
||||
**Adaptive Widgets (ADR-38)** bringen keine Migration. Gespeichert werden ab jetzt `hero` Version 2 und `image_text` Version 3. Ein Code-Rollback auf Designiteration 1 stellt diese Hüllen „bestmöglich“ dar (höhere Version als im Code): unbekannte Varianten fallen auf die Vorgabe zurück, die data-Schlüssel sind unverändert; Höhe, Fläche, Label und Fokus werden nicht dargestellt, aber nicht gelöscht. Speichern im alten Editor ist für diese Hüllen nicht möglich, bis der neue Code wieder läuft.
|
||||
|
||||
**Designiteration 1** bringt keine Migration. Bei einem Code-Rollback auf Iteration 2 fallen die neuen Varianten beim Lesen auf die Vorgabe zurück (`stage`/`editorial` → `standard`, `featured` → `standard`); die neuen Einstellungen und `cta2_*` werden nicht dargestellt, aber nicht gelöscht. Seiten bleiben darstellbar; der Wiederherstellungsweg oben ist dafür nicht nötig. Ein reiner Code-Rollback ist nach redaktionellen Änderungen im neuen Editor **nicht** als sicher anzusehen; der Weg oben ist Teil jedes Rollbacks.
|
||||
|
||||
## 10. Navigation
|
||||
@@ -214,19 +231,26 @@ ## 11. Abschnitte und Plätze
|
||||
- **Erstes Widget** der Seite ist der Seiteneinstieg (Überschrift erster Ordnung); seitenweit genau eine.
|
||||
- **Grenzen**: höchstens 30 Abschnitte und 60 Widgets je Seite; keine Verschachtelung.
|
||||
|
||||
## 12. Responsive Widget-Regeln
|
||||
## 12. Responsive Widget-Regeln und gemeinsamer Layoutvertrag (ADR-38)
|
||||
|
||||
Jede Widget-Art meldet `minUnits()` (kleinste zulässige Platzbreite auf dem Desktop), `preferredUnits()` (Hinweis) und `stages()` (Darstellungsstufen). Jeder Platz ist ein Container (`slot`); die Widget-Ansichten verwenden Container-Abfragen statt Fensterbreiten.
|
||||
Jede Widget-Art erklärt in `WidgetType`:
|
||||
- `supportedUnits()`: zulässige Platzbreiten (1–4); `minUnits()` ist daraus abgeleitet. Ein Platz mit anderer Breite wird beim Speichern abgewiesen („… ist für Plätze mit 3 oder 4 Rastereinheiten vorgesehen“); der Platzkopf im Editor warnt vorher („passt nicht“), die Widget-Auswahl nennt die zulässigen Breiten.
|
||||
- `heights()`: angebotene Höhen aus `WidgetType::HEIGHTS` (`auto`, `compact`, `normal`, `large`, `spacious`, `fill`), gespeichert als `settings.height`; `defaultHeight()` gilt ohne Angabe. Höhen sind Mindesthöhen oder Proportionen, nie Begrenzungen. `fill` streckt das Widget auf die Höhe der Abschnittszeile, wenn Plätze nebeneinander stehen.
|
||||
- `stages()` und `narrowBehavior()`: Darstellungsmodi nach Containerbreite und Verhalten bei wenig Platz.
|
||||
|
||||
| Widget | Mindestbreite | Vorzug | Stufen |
|
||||
Jeder Platz ist ein Container (`slot`); die Premium-Widgets haben zusätzlich eigene Container (`lf-hero`, `lf-bt`). Entscheidend ist die tatsächliche Breite, nicht die Einheitenzahl.
|
||||
|
||||
| Widget | Breiten | Höhen | Darstellung nach Containerbreite |
|
||||
|---|---|---|---|
|
||||
| Einstieg (Hero) | 2 | 4 | unter 48 rem Bild unter dem Text; ab 48 rem nebeneinander; Überschrift wächst mit der Platzbreite. Markenbühne: unter 56 rem Bild 4:3 mit überlappender Tafel, ab 56 rem Bild über die ganze Bühne (30–46 rem hoch) mit Tafel links oder rechts. Editorial: ab 56 rem Beschreibung und Schaltflächen nebeneinander, Bild 21:9 |
|
||||
| Überschrift | 1 | 4 | Größe folgt der Platzbreite |
|
||||
| Fließtext | 1 | 2 | Zeilenlänge höchstens etwa 70 Zeichen |
|
||||
| Bild und Text | 2 | 4 | unter 36 rem gestapelt; ab 36 rem Bild und Text gleich breit; ab 56 rem Bild betont (7:5); festes Bildformat nach Einstellung |
|
||||
| Redaktionelle Karten | 1 | 4 | so viele Karten nebeneinander, wie bei 15 rem Kartenbreite passen; hervorgehobene erste Karte ab 44 rem mit Bild neben dem Text; kompakte Liste mit kleinem Bild rechts |
|
||||
| Programm- und Modulkarten | 1 | 4 | ab 17 rem Kartenbreite mehrspaltig; eine einzelne Karte ab 40 rem mit Tafel neben dem Text; kompakte Liste für schmale Plätze |
|
||||
| Handlungsaufruf | 1 | 2 | unter 20 rem Schaltfläche in voller Breite |
|
||||
| FAQ | 2 | 4 | Fragen untereinander, Antworten auf Lesebreite |
|
||||
| Einstieg (Hero) | 3, 4 | compact/normal/large | ab 860 px Foto über die Fläche, Text links, Mindesthöhe 400/512/640 px; darunter Sicherheitsumbruch: Foto 16:9 über dem Text, Höhe nach Inhalt; unter 440 px Schaltflächen untereinander |
|
||||
| Bild und Text | 1–4 | compact/normal/spacious | unter 540 px gestapelt, Schaltflächen in voller Breite; 540–899 px flacher Bildstreifen (2,5 : 1 / 2,15 : 1 / 1,8 : 1) über dem Text; ab 900 px zweispaltig, Bild links oder rechts |
|
||||
| Überschrift | 1–4 | – | Größe folgt der Platzbreite, lange Wörter werden getrennt |
|
||||
| Fließtext | 1–4 | – | Zeilenlänge höchstens etwa 70 Zeichen, lange Adressen brechen um |
|
||||
| Redaktionelle Karten | 1–4 | – | so viele Karten nebeneinander, wie bei 15 rem Kartenbreite passen; hervorgehobene Karte ab 44 rem mit Bild neben dem Text |
|
||||
| Programm- und Modulkarten | 1–4 | – | ab 17 rem Kartenbreite mehrspaltig; eine einzelne Karte ab 40 rem mit Tafel neben dem Text |
|
||||
| Handlungsaufruf | 1–4 | auto/fill | unter 20 rem Schaltfläche in voller Breite; Beschriftungen brechen um |
|
||||
| FAQ | 2–4 | – | Fragen untereinander, Antworten auf Lesebreite |
|
||||
|
||||
Ableitung: Ein Platz mit einer Einheit ist bei Standardbreite auf dem Desktop etwa 17 rem (rund 276 px) breit. Bild-neben-Text und Einstieg sind darin nicht sinnvoll lesbar (zwei Spalten unter je 140 px); Karten, Fließtext und Aufrufe bleiben es. Ein zu schmaler Platz wird beim Speichern mit Abschnitt und Platz gemeldet; der Platzkopf im Editor zeigt „zu schmal“ bereits vorher. Auf Tablet und Smartphone stapeln die Plätze, dort gilt die Mindestbreite nicht.
|
||||
Gemessene Platzbreiten im Standardabschnitt (82 rem) bei 1440 px Fensterbreite: 1 Einheit etwa 301–319 px, 2 Einheiten 638 px, 3 Einheiten 957 px, 4 Einheiten 1312 px. Bei 1200 px Fensterbreite hat ein Platz mit 3 Einheiten 807 px; der Einstieg zeigt dort den Sicherheitsumbruch.
|
||||
|
||||
Ableitung: Bild und Text funktioniert dank gestapelter Darstellung auch in einer Einheit; der Einstieg braucht für seine Komposition mindestens etwa 860 px und ist deshalb nur für 3 oder 4 Einheiten freigegeben. Auf Tablet und Smartphone stapeln die Plätze; dort gelten die Breitenregeln nicht, die Widgets reagieren auf ihre Containerbreite.
|
||||
@@ -146,6 +146,19 @@ ## 12. Breitenmodell (Designiteration 1)
|
||||
| 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 |
|
||||
| Randlos | – | 100 % | automatisch (`section-bleed`) | Markenbühne allein im Abschnitt |
|
||||
|
||||
Hintergründe reichen immer über die ganze Fensterbreite. `--frame-inset` = `max(Randabstand, (100 % − Standard) / 2)` richtet Inhalte in randlosen Flächen (Tafel der Markenbühne) am Standardraster aus, ohne `100vw` (kein Scrollbalkenfehler). Die Schlüssel der Abschnittsbreiten sind gespeicherte Daten und bleiben unverändert; nur die Werte wurden angepasst (vorher 45/75/90 rem).
|
||||
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.
|
||||
Reference in new issue
Block a user