Dokumentiere die vereinfachten Abschnittsabstände mit Messwerten.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
f511ad10de
commit
cca069be48
3 files changed
+83
-7
No files matched your search
@@ -259,3 +259,57 @@ ### Wortmarke in Kopfzeile und Fußbereich
|
||||
**Offen:**
|
||||
- Eine Vektorfassung der Wortmarke fehlt; die Rasterfassung ist für die gezeigten Größen scharf (2x-Ableitung).
|
||||
- Bitte die Wortmarke in Kopf- und Fußbereich visuell abnehmen.
|
||||
|
||||
## 9. Korrektur: Abschnittsabstände vereinfacht (18.11.2026)
|
||||
|
||||
Branch `feature/abschnittsabstaende`, Commit `f511ad1`; CI 4842, Deploy 4843 auf `develop`, gearbeitet in einem separaten Worktree. Kein Merge nach `main`.
|
||||
|
||||
**Ersetzt** wurden:
|
||||
- „Abstand oben und unten“,
|
||||
- die Abweichung „Abstand oben“,
|
||||
- die versteckte Regel, die oben zwischen zwei Abschnitten ohne Fläche auf null setzte,
|
||||
- der Trenner „Zusätzlicher Abstand“.
|
||||
|
||||
**Neu** sind genau drei unabhängige Einstellungen: **Abstand oben**, **Abstand unten** und **Widget-Abstand**, jeweils mit den Stufen Kein Abstand, Kompakt, Normal und Großzügig. Gespeichert werden sie in der Abschnittshülle Version 2; Einzelheiten stehen in `cms-widget-registry.md` §11.
|
||||
|
||||
**Bestehende Seiten:** Hüllen der Version 1 werden beim Lesen übersetzt.
|
||||
|
||||
| Seite | Breiten | Ergebnis vor und nach dem Deploy |
|
||||
|---|---|---|
|
||||
| `/`, `/praevention`, `/designreferenz`, `/referenz-abschnitte`, `/premium-referenz`, `/t1-landingpage` | 1440 und 390 px | pixelgleich: Seitenhöhe, Lage jedes Abschnitts und Rasters, Innenabstände, Rasterabstände, Platzpositionen |
|
||||
| `/praevention-im-alltag` | 1440 und 390 px | erster Abschnitt oben +24,5 px bzw. +12 px, weil „Gering“ jetzt „Kompakt“ ist (gewollte Folge der vier Stufen) |
|
||||
|
||||
**Prüfung über den regulären Seitenkonfigurator:**
|
||||
- Angelegt wurde `/abstand-pruefung` (Seite 18) mit aufeinanderfolgenden Abschnitten:
|
||||
|
||||
| Abschnitt | Raster | oben / unten / Widget-Abstand |
|
||||
|---|---|---|
|
||||
| 1 | 4/4 | 0 / 0 / 0 |
|
||||
| 2 | 3:1 | 0 / 0 / 0 |
|
||||
| 3 | 4/4 | Kompakt / Normal / Normal |
|
||||
| 4 | 3:1 | Großzügig / 0 / Großzügig |
|
||||
| 5 | 3:1 | 0 / Kompakt / Kompakt |
|
||||
|
||||
- Die Gestaltung zeigt genau die drei Felder, „Abstand oben und unten“ gibt es nicht mehr.
|
||||
- Berechnete CSS-Werte (26 von 26 Prüfungen):
|
||||
|
||||
| Prüfung | 1440 px | 390 px |
|
||||
|---|---|---|
|
||||
| Stufen oben/unten (Kompakt / Normal / Großzügig) | 44,8 / 89,6 / 120 px | 24 / 48 / 72 px |
|
||||
| Stufen Widget-Abstand (Kompakt / Normal / Großzügig) | 18 / 36 / 56 px | 12 / 20 / 32 px |
|
||||
| Innenabstände und Rasterabstand je Abschnitt | wie eingestellt, Außenabstand jeweils 0 | wie eingestellt, Außenabstand jeweils 0 |
|
||||
| Inhalt 1 → 2 (0 + 0) | 0,0 px | 0,0 px |
|
||||
| Inhalt 2 → 3 (0 + Kompakt) | 44,8 px | 24 px |
|
||||
| Inhalt 3 → 4 (Normal + Großzügig) | 209,6 px | 120 px |
|
||||
| Inhalt 4 → 5 (0 + 0) | 0,0 px | 0,0 px |
|
||||
| Widget-Abstand 3:1 | nebeneinander 0 / 56 / 18 px | gestapelt 0 / 32 / 12 px |
|
||||
|
||||
**Tests:** 204 grün.
|
||||
- Neu:
|
||||
- Addition und Vorgaben,
|
||||
- Übersetzung aller Fälle der Version 1 (Abweichung, versteckte Regel, eigene Fläche, Linientrenner, leerer Abschnitt, Zusatzabstand),
|
||||
- Abweisung freier Werte für alle drei Felder.
|
||||
- Bewusst angepasst: Hüllenversion 2, neue Klassen, Prüfung freier Werte über die neuen Schlüssel.
|
||||
|
||||
**Vorgabe für neue Abschnitte:** oben und unten Kompakt, Widget-Abstand Normal. Damit bleibt der Abstand zwischen zwei neuen Abschnitten so groß wie bisher, und ein neuer erster Abschnitt beginnt näher an der Kopfzeile als vorher.
|
||||
|
||||
@@ -141,7 +141,7 @@ ## 8. Editor und Vorschau
|
||||
- Arbeitsfläche in voller Breite (`maxContentWidth = Full`); „Seite und Suchmaschinen“ ist beim Bearbeiten eingeklappt.
|
||||
- **Abschnitte** (Repeater): Kopfzeile „Abschnitt N · Raster 1 + 3 · Fläche · Widgets“; Aktionen Ziehen, nach oben/unten, Duplizieren, Löschen (mit Rückfrage), Einklappen, jeweils mit Tooltip.
|
||||
- **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 oben und unten, **Abstand oben** (Abweichung: wie Abstand / gering / kein, zum Beispiel für einen Einstieg direkt unter der Kopfzeile; gespeichert als `style.spacing_top`, Vorgabe `same`), Trenner; bei Hintergrundbild zusätzlich Bild (Auswahl oder Upload), Fokuspunkt und Überlagerung. Abschnitts- und Widget-Einstellungen sind getrennt.
|
||||
- **Gestaltung des Abschnitts** (eingeklappt, Zusammenfassung im Kopf): Hintergrund, Breite, **Abstand oben**, **Abstand unten**, **Widget-Abstand** (je Kein Abstand / Kompakt / Normal / Großzügig, siehe §11), 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-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.
|
||||
@@ -187,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.
|
||||
|
||||
**Abschnittshülle Version 2 (Abstände)** bringt keine Migration der Datenbank; ältere Hüllen werden beim Lesen übersetzt. Ein Code-Rollback auf eine Fassung vor Version 2 zeigt neue Hüllen mit den alten Vorgaben (Abstand normal), weil sie `spacing_bottom` und `gap` nicht kennt; Speichern im alten Editor weist diese Schlüssel ab. Der Wiederherstellungsweg oben gilt.
|
||||
|
||||
**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.
|
||||
@@ -202,12 +204,12 @@ ## 10. Navigation
|
||||
|
||||
## 11. Abschnitte und Plätze
|
||||
|
||||
Gespeicherte Hülle eines Abschnitts (`sections[]`, Version 1):
|
||||
Gespeicherte Hülle eines Abschnitts (`sections[]`, Version 2):
|
||||
|
||||
```json
|
||||
{"id": "uuid", "v": 1, "layout": "u1_3",
|
||||
"style": {"background": "dark", "image": null, "focus": "center", "overlay": "light",
|
||||
"width": "standard", "spacing": "normal", "divider": "line"},
|
||||
{"id": "uuid", "v": 2, "layout": "u1_3",
|
||||
"style": {"background": "dark", "image": null, "focus": "center", "overlay": "light", "width": "standard",
|
||||
"spacing_top": "compact", "spacing_bottom": "compact", "gap": "normal", "divider": "line"},
|
||||
"slots": [{"id": "…", "type": "cards", "v": 1, "…": "…"}, null]}
|
||||
```
|
||||
|
||||
@@ -225,9 +227,28 @@ ## 11. Abschnitte und Plätze
|
||||
- **Gestaltung**: nur Aufzählungswerte (`SectionStyle`), abgebildet auf Tokens. Freie Werte (Farbcodes, CSS, unbekannte Schlüssel) werden abgewiesen.
|
||||
- Hintergrund: Standard, helle Markenfläche, dunkle Markenfläche, Markenakzent, Hintergrundbild. Jede Fläche setzt die Bedeutungs-Tokens neu (`scope-dark`, `scope-accent`, `scope-light`).
|
||||
- Breite: schmal (45 rem), Standard (75 rem), breit (90 rem), volle Breite. Der Hintergrund reicht immer über die ganze Bildschirmbreite.
|
||||
- Abstand: kompakt, normal (48 → 96 px), großzügig.
|
||||
- **Abstände (Version 2): genau drei unabhängige Werte**, je Kein Abstand / Kompakt / Normal / Großzügig:
|
||||
|
||||
| Wert | Bedeutung | Stufen (390 px → 1440 px) |
|
||||
|---|---|---|
|
||||
| `spacing_top` | Abstand oben (vor dem Inhalt) | 0 / 24 → 45 / 48 → 90 / 72 → 120 px (`--section-space-*`) |
|
||||
| `spacing_bottom` | Abstand unten (nach dem Inhalt) | wie oben |
|
||||
| `gap` | Widget-Abstand zwischen den Plätzen des Rasters, nebeneinander und gestapelt | 0 / 12 → 18 / 20 → 36 / 32 → 56 px (`--section-gap-*`) |
|
||||
|
||||
- Zwischen zwei Abschnitten addieren sich „unten“ des ersten und „oben“ des zweiten; 0 + 0 = 0. Es gibt keine weitere Vorgabe aus Seiten- oder Rasterhüllen (geprüft: kein Außenabstand der Abschnitte, `main` ohne Innenabstand).
|
||||
- Oben und unten sind der Innenabstand des Abschnitts. Bei eigener Fläche (dunkel, Akzent, Bild) liegen sie innerhalb der Fläche, damit Hintergründe nahtlos anschließen.
|
||||
- Vorgabe neuer Abschnitte: oben und unten Kompakt, Widget-Abstand Normal. Damit entspricht der Abstand zwischen zwei neuen Abschnitten dem bisherigen Normalabstand.
|
||||
- Abstände innerhalb eines Widgets (zum Beispiel zwischen Karten, `--grid-gap`) bleiben Sache des Widgets.
|
||||
- Trenner „Linie“ und „Markenakzent“ sind sichtbare Elemente zwischen zwei Abschnitten und bringen ihren eigenen kleinen Rand um die Linie mit (24 bzw. 8 px oben und unten).
|
||||
- **Version 1 → 2** (`SectionStyle::migrateSpacing`, beim Lesen; gespeicherte Revisionen bleiben):
|
||||
- „Abstand oben und unten“ wird zu oben und unten mit demselben Wert.
|
||||
- Die Abweichung „Abstand oben“ ersetzt nur oben: „kein“ → Kein Abstand, „gering“ → Kompakt. Die Stufe „gering“ gibt es nicht mehr; das ist die einzige sichtbare Änderung, auf der Testinstanz nur bei `/praevention-im-alltag`, +24 px.
|
||||
- Die frühere versteckte Regel „Abschnitt ohne Fläche direkt nach Abschnitt ohne Fläche: oben 0“ (ohne Linien- oder Akzenttrenner dazwischen, leere Abschnitte zählen nicht) wird als „oben: Kein Abstand“ ausgeschrieben.
|
||||
- Der Trenner „Zusätzlicher Abstand“ entfällt; er wird zu „Abstand unten“ eine Stufe höher.
|
||||
- Der Widget-Abstand wird Normal (der bisher feste Rasterabstand).
|
||||
- Messung auf der Testinstanz: sieben Seiten bei 1440 und 390 px vor und nach dem Deploy pixelgleich, außer der genannten Stelle.
|
||||
- Hintergrundbild: nur aus `cms/`, Fokuspunkt als `object-position` (neun Positionen), Überlagerung hell (84 % Weiß) oder dunkel (78 % Navy) oder keine. Das Bild des ersten Abschnitts lädt sofort, alle übrigen verzögert.
|
||||
- **Trenner** stehen zwischen Abschnitten, nie nach dem letzten: zusätzlicher Abstand, dezente Linie, Markenakzent (kurzer gelber Balken).
|
||||
- **Trenner** stehen zwischen Abschnitten, nie nach dem letzten: dezente Linie, Markenakzent (kurzer gelber Balken).
|
||||
- **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.
|
||||
|
||||
|
||||
@@ -76,6 +76,7 @@ ## 5. Typografie, Abstände, Maße
|
||||
| Abstände | Grundmaß 4 px: 4, 8, 12, 16, 24, 32, 48, 64, 96 px |
|
||||
| Rundungen | 8 (klein), 14 (Karte), 22 (Fläche), Pille |
|
||||
| Breiten | Lesebereich 44 rem, Standard 82 rem, Breit 96 rem, 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); 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 |
|
||||
|
||||
|
||||
Reference in new issue
Block a user