From f511ad10de1d6eb73f6fe19450a868c553d783bd Mon Sep 17 00:00:00 2001 From: Lars Date: Wed, 18 Nov 2026 12:39:57 +0100 Subject: [PATCH] =?UTF-8?q?Vereinfache=20die=20Abschnittsabst=C3=A4nde=20a?= =?UTF-8?q?uf=20oben,=20unten=20und=20Widget-Abstand.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Die Abschnittshülle Version 2 kennt genau drei unabhängige Abstände mit denselben Stufen (Kein Abstand, Kompakt, Normal, Großzügig): - spacing_top / spacing_bottom: Innenabstand des Abschnitts; zwischen zwei Abschnitten addieren sich unten und oben (0 + 0 = 0). - gap: Abstand zwischen den Plätzen des Rasters, nebeneinander und gestapelt. Widget-Innenabstände bleiben im Widget. Entfallen sind „Abstand oben und unten“, die Abweichung „Abstand oben“ (same/small/none), die versteckte Regel, die oben zwischen zwei Abschnitten ohne Fläche auf null setzte, und der Trenner „Zusätzlicher Abstand“. Hüllen der Version 1 werden beim Lesen ohne Layoutänderung übersetzt (SectionStyle::migrateSpacing); gespeicherte Revisionen bleiben. Einzige Abweichung: „Gering“ hat keine eigene Stufe mehr und wird „Kompakt“. Tests bewusst angepasst (Hüllenversion 2, neue Klassen, Prüfung freier Werte über die neuen Schlüssel); neue Tests für Addition, Vorgaben und die Übersetzung aller Fälle der Version 1. Co-Authored-By: Claude Opus 5.5 --- app/Domain/Cms/Sections/PageSections.php | 28 ++-- app/Domain/Cms/Sections/SectionRenderer.php | 9 +- app/Domain/Cms/Sections/SectionStyle.php | 122 ++++++++++++++---- app/Filament/Support/SectionEditor.php | 23 ++-- resources/css/sections.css | 53 ++++---- resources/css/tokens.css | 10 ++ .../views/site/templates/standard.blade.php | 2 +- tests/Feature/CmsPageListAndSpacingTest.php | 71 ++++++++-- tests/Feature/CmsSectionRenderingTest.php | 5 +- tests/Unit/PageSectionsTest.php | 9 +- 10 files changed, 238 insertions(+), 94 deletions(-) diff --git a/app/Domain/Cms/Sections/PageSections.php b/app/Domain/Cms/Sections/PageSections.php index d7932e1..642ff0a 100644 --- a/app/Domain/Cms/Sections/PageSections.php +++ b/app/Domain/Cms/Sections/PageSections.php @@ -11,14 +11,17 @@ * Abschnitts- und Slotmodell einer Seite: Seite → Abschnitte → Slots → Widget-Instanzen. * * Gespeicherte Hülle eines Abschnitts (Version 1): - * {id, v, layout, style: {background, image, focus, overlay, width, spacing, spacing_top, divider}, slots: [Widget-Hülle|null, …]} + * {id, v, layout, style: {background, image, focus, overlay, width, spacing_top, spacing_bottom, gap, divider}, slots: [Widget-Hülle|null, …]} + * + * Version 2 (Abstände): oben, unten und Widget-Abstand sind drei unabhängige Werte. Hüllen der Version 1 werden beim + * Lesen übersetzt (SectionStyle::migrateSpacing), ohne die Darstellung zu ändern; gespeicherte Revisionen bleiben. * * Jeder Slot enthält höchstens ein Widget aus dem zentralen Widget-Register. Abschnitte sind nicht verschachtelbar. * Revisionen ohne Abschnitte (Bestand vor dieser Fassung) werden beim Lesen als einspaltige Abschnitte gelesen. */ class PageSections { - public const VERSION = 1; + public const VERSION = 2; public const MAX_SECTIONS = 30; @@ -41,10 +44,8 @@ public function read(?array $sections, ?array $blocks = null): array $result = []; - foreach (array_values($sections) as $section) { - if (is_array($section)) { - $result[] = $this->upcastSection($section); - } + foreach (SectionStyle::migrateSpacing(array_values(array_filter($sections, 'is_array')), byVersion: true) as $section) { + $result[] = $this->upcastSection($section); } return $result; @@ -74,6 +75,12 @@ public function normalize(array $content): array $seenWidgetIds = []; $widgetCount = 0; + // Eingaben mit Abständen der Version 1 (zum Beispiel ältere Aufrufer) werden wie beim Lesen übersetzt. + $migrated = SectionStyle::migrateSpacing(array_map( + fn ($item) => is_array($item) && array_key_exists('slots', $item) ? $item : ['style' => [], 'slots' => [$item]], + $items, + )); + foreach ($items as $index => $item) { if (! is_array($item)) { $errors["sections.$index"] = ['Ein Abschnitt ist unvollständig.']; @@ -83,6 +90,8 @@ public function normalize(array $content): array if (! array_key_exists('slots', $item)) { $item = ['id' => null, 'layout' => SectionLayouts::DEFAULT, 'style' => [], 'slots' => [$item]]; + } else { + $item['style'] = $migrated[$index]['style'] ?? ($item['style'] ?? []); } $sections[] = $this->normalizeSection($item, $index, $errors, $seenSectionIds, $seenWidgetIds, $widgetCount); @@ -164,13 +173,14 @@ private function wrapWidgets(array $blocks): array { $sections = []; - foreach ($this->widgets->read($blocks) as $widget) { + foreach ($this->widgets->read($blocks) as $position => $widget) { $sections[] = [ 'id' => null, 'v' => self::VERSION, 'layout' => SectionLayouts::DEFAULT, - // Bestand vor dem Raster stand in einem durchgehenden Blatt: kompakte Abstände kommen dem am nächsten. - 'style' => ['spacing' => 'compact'] + SectionStyle::DEFAULTS, + // Bestand vor dem Raster stand in einem durchgehenden Blatt: kompakte Abstände, zwischen den Widgets + // nur einmal (oben kein Abstand ab dem zweiten), wie bisher. + 'style' => ['spacing_top' => $position === 0 ? 'compact' : 'none', 'spacing_bottom' => 'compact', 'gap' => 'normal'] + SectionStyle::DEFAULTS, 'slots' => [$widget], ]; } diff --git a/app/Domain/Cms/Sections/SectionRenderer.php b/app/Domain/Cms/Sections/SectionRenderer.php index fa0c9e9..a2ba2ee 100644 --- a/app/Domain/Cms/Sections/SectionRenderer.php +++ b/app/Domain/Cms/Sections/SectionRenderer.php @@ -81,8 +81,9 @@ private function renderSection(array $section, array $cells, int $index): string 'page-section', 'section-bg-'.($hasImage ? 'image' : ($style['background'] === 'image' ? 'default' : $style['background'])), 'section-width-'.$style['width'], - 'section-space-'.$style['spacing'], - ...($style['spacing_top'] !== 'same' ? ['section-space-top-'.$style['spacing_top']] : []), + 'section-space-top-'.$style['spacing_top'], + 'section-space-bottom-'.$style['spacing_bottom'], + 'section-gap-'.$style['gap'], 'section-layout-'.str_replace('_', '-', $section['layout']), ]; @@ -102,10 +103,6 @@ private function renderSection(array $section, array $cells, int $index): string $classes[] = $scope; } - if ($style['divider'] === 'space') { - $classes[] = 'section-divider-space'; - } - $id = is_string($section['id'] ?? null) ? ' id="bereich-'.e($section['id']).'"' : ''; $html = '
'; diff --git a/app/Domain/Cms/Sections/SectionStyle.php b/app/Domain/Cms/Sections/SectionStyle.php index ae3656f..e047be0 100644 --- a/app/Domain/Cms/Sections/SectionStyle.php +++ b/app/Domain/Cms/Sections/SectionStyle.php @@ -2,6 +2,8 @@ namespace App\Domain\Cms\Sections; +use App\Domain\Cms\Widgets\Support\PublicMedia; + /** * Semantische Abschnittsgestaltung. Jeder Wert ist eine Aufzählung, die auf zentrale Design-Tokens * abgebildet wird (resources/css/app.css, Abschnitt „Abschnitte“). Keine freie CSS- oder Farbangabe. @@ -25,29 +27,27 @@ final class SectionStyle 'full' => 'Vollbreite', ]; - /** @var array */ + /** + * Gemeinsame Stufen der drei Abstände eines Abschnitts (Hülle Version 2): + * - spacing_top: Abstand vor dem Inhalt (oben), + * - spacing_bottom: Abstand nach dem Inhalt (unten), + * - gap: Abstand zwischen den Plätzen im Abschnittsraster, nebeneinander und gestapelt. + * Zwischen zwei Abschnitten addieren sich „unten“ des ersten und „oben“ des zweiten; es gibt keine weitere + * versteckte Vorgabe. Liegt eine eigene Fläche (Hintergrund) vor, liegen oben und unten innerhalb dieser Fläche. + * Werte: resources/css/tokens.css (--section-space-*, --section-gap-*). + * + * @var array + */ public const SPACINGS = [ + 'none' => 'Kein Abstand', 'compact' => 'Kompakt', 'normal' => 'Normal', 'large' => 'Großzügig', ]; - /** - * Abweichender Abstand oben, zum Beispiel damit ein Einstieg direkt unter der Kopfzeile beginnt. - * Ergänzt „Abstand oben und unten“, ersetzt ihn nicht; der Abstand unten bleibt unverändert. - * - * @var array - */ - public const SPACINGS_TOP = [ - 'same' => 'Wie „Abstand oben und unten“', - 'small' => 'Gering', - 'none' => 'Kein Abstand', - ]; - /** @var array */ public const DIVIDERS = [ 'none' => 'Kein Trenner', - 'space' => 'Zusätzlicher Abstand', 'line' => 'Dezente Linie', 'accent' => 'Markenakzent', ]; @@ -91,8 +91,9 @@ final class SectionStyle 'focus' => 'center', 'overlay' => 'light', 'width' => 'standard', - 'spacing' => 'normal', - 'spacing_top' => 'same', + 'spacing_top' => 'compact', + 'spacing_bottom' => 'compact', + 'gap' => 'normal', 'divider' => 'none', ]; @@ -108,8 +109,9 @@ public static function enums(): array 'focus' => self::FOCUS, 'overlay' => self::OVERLAYS, 'width' => self::WIDTHS, - 'spacing' => self::SPACINGS, - 'spacing_top' => self::SPACINGS_TOP, + 'spacing_top' => self::SPACINGS, + 'spacing_bottom' => self::SPACINGS, + 'gap' => self::SPACINGS, 'divider' => self::DIVIDERS, ]; } @@ -118,7 +120,7 @@ public static function enums(): array * Lesepfad: gespeicherte Werte; Unbekanntes fällt auf die Vorgabe zurück, damit alte oder fremde Daten * nie eine Seite brechen. * - * @return array{background: string, image: ?string, focus: string, overlay: string, width: string, spacing: string, spacing_top: string, divider: string} + * @return array{background: string, image: ?string, focus: string, overlay: string, width: string, spacing_top: string, spacing_bottom: string, gap: string, divider: string} */ public static function fromStored(mixed $style): array { @@ -151,12 +153,13 @@ public static function summary(array $style): string $parts[] = self::WIDTHS[$style['width']]; } - if ($style['spacing'] !== 'normal') { - $parts[] = 'Abstand '.mb_strtolower(self::SPACINGS[$style['spacing']]); + if ($style['spacing_top'] !== self::DEFAULTS['spacing_top'] || $style['spacing_bottom'] !== self::DEFAULTS['spacing_bottom']) { + $parts[] = 'Abstand oben '.mb_strtolower(self::SPACINGS[$style['spacing_top']]) + .', unten '.mb_strtolower(self::SPACINGS[$style['spacing_bottom']]); } - if ($style['spacing_top'] !== 'same') { - $parts[] = 'oben '.mb_strtolower(self::SPACINGS_TOP[$style['spacing_top']]); + if ($style['gap'] !== 'normal') { + $parts[] = 'Widget-Abstand '.mb_strtolower(self::SPACINGS[$style['gap']]); } if ($style['divider'] !== 'none') { @@ -165,4 +168,77 @@ public static function summary(array $style): string return implode(' · ', $parts); } + + /** + * Ob eine gespeicherte Gestaltung noch die Abstände der Hülle Version 1 trägt + * („Abstand oben und unten“ spacing, Abweichung „Abstand oben“ same/small/none). + * + * @param array $style + */ + public static function hasLegacySpacing(array $style): bool + { + return array_key_exists('spacing', $style) + || in_array($style['spacing_top'] ?? null, ['same', 'small'], true); + } + + /** + * Übersetzt die Abstände der Hülle Version 1 in die drei Werte der Version 2, ohne die Darstellung zu ändern. + * + * Version 1 rechnete so: jeder Abschnitt oben und unten „spacing“ (Vorgabe normal); die Abweichung + * „Abstand oben“ ersetzte nur oben (small/none); und eine versteckte Regel setzte oben auf null, wenn ein Abschnitt + * ohne eigene Fläche direkt auf einen Abschnitt ohne eigene Fläche folgte (ohne Linien- oder Akzenttrenner dazwischen). + * Diese Regel wird hier als „oben: kein Abstand“ ausgeschrieben. „Gering“ hat keine eigene Stufe mehr und wird + * „Kompakt“ (dokumentierte Abweichung). Der Widget-Abstand entspricht dem bisherigen festen Rasterabstand („normal“). + * + * @param list> $sections Abschnitte in Lesereihenfolge (mit style und slots) + * @param bool $byVersion true: jede Hülle mit v < 2 gilt als Version 1 (Lesepfad gespeicherter Revisionen); + * false: nur Gestaltungen mit alten Schlüsseln (Eingaben ohne Versionsangabe) + * @return list> dieselben Abschnitte mit übersetzter Gestaltung + */ + public static function migrateSpacing(array $sections, bool $byVersion = false): array + { + $previous = null; + + foreach ($sections as $index => $section) { + $style = is_array($section['style'] ?? null) ? $section['style'] : []; + $rendered = is_array($section['slots'] ?? null) && array_filter($section['slots'], 'is_array') !== []; + + $background = is_string($style['background'] ?? null) && isset(self::BACKGROUNDS[$style['background']]) ? $style['background'] : 'default'; + if ($background === 'image' && ! PublicMedia::isPublicPath($style['image'] ?? null)) { + $background = 'default'; + } + $divider = in_array($style['divider'] ?? null, ['line', 'accent'], true) ? $style['divider'] : 'none'; + + $legacy = $byVersion ? (int) ($section['v'] ?? 1) < 2 : self::hasLegacySpacing($style); + + if ($legacy) { + $level = in_array($style['spacing'] ?? null, ['compact', 'normal', 'large'], true) ? $style['spacing'] : 'normal'; + $override = $style['spacing_top'] ?? 'same'; + $collapsed = $background === 'default' && $previous !== null && $previous['background'] === 'default' && ! in_array($previous['divider'], ['line', 'accent'], true); + + $style['spacing_top'] = match (true) { + $override === 'none' => 'none', + $override === 'small' => 'compact', + $collapsed => 'none', + default => $level, + }; + $style['spacing_bottom'] = $level; + $style['gap'] = 'normal'; + + // Trenner „Zusätzlicher Abstand“ (Version 1) fügte unten noch einmal den Abschnittsabstand an. + if (($style['divider'] ?? null) === 'space') { + $style['spacing_bottom'] = ['compact' => 'normal', 'normal' => 'large', 'large' => 'large'][$level]; + $style['divider'] = 'none'; + } + unset($style['spacing']); + $sections[$index]['style'] = $style; + } + + if ($rendered) { + $previous = ['background' => $background, 'divider' => $divider]; + } + } + + return $sections; + } } diff --git a/app/Filament/Support/SectionEditor.php b/app/Filament/Support/SectionEditor.php index 8fc7151..9ae3e11 100644 --- a/app/Filament/Support/SectionEditor.php +++ b/app/Filament/Support/SectionEditor.php @@ -143,17 +143,24 @@ private static function styleFields(): array ->default('standard') ->selectablePlaceholder(false) ->helperText('Ein Hintergrund reicht immer über die ganze Bildschirmbreite.'), - Select::make('spacing') - ->label('Abstand oben und unten') - ->options(SectionStyle::SPACINGS) - ->default('normal') - ->selectablePlaceholder(false), Select::make('spacing_top') ->label('Abstand oben') - ->options(SectionStyle::SPACINGS_TOP) - ->default('same') + ->options(SectionStyle::SPACINGS) + ->default(SectionStyle::DEFAULTS['spacing_top']) ->selectablePlaceholder(false) - ->helperText('Zum Beispiel „Kein Abstand“, damit ein Einstieg direkt unter der Kopfzeile beginnt. Der Abstand unten bleibt.'), + ->helperText('Vor dem Inhalt. Zwischen zwei Abschnitten addieren sich „unten“ und „oben“; „Kein Abstand“ lässt einen Einstieg direkt unter der Kopfzeile beginnen.'), + Select::make('spacing_bottom') + ->label('Abstand unten') + ->options(SectionStyle::SPACINGS) + ->default(SectionStyle::DEFAULTS['spacing_bottom']) + ->selectablePlaceholder(false) + ->helperText('Nach dem Inhalt. Bei eigener Fläche liegen beide Abstände innerhalb der Fläche.'), + Select::make('gap') + ->label('Widget-Abstand') + ->options(SectionStyle::SPACINGS) + ->default(SectionStyle::DEFAULTS['gap']) + ->selectablePlaceholder(false) + ->helperText('Zwischen den Plätzen dieses Abschnitts, nebeneinander und gestapelt. Abstände innerhalb eines Widgets bleiben Sache des Widgets.'), Select::make('divider') ->label('Trenner zum nächsten Abschnitt') ->options(SectionStyle::DIVIDERS) diff --git a/resources/css/sections.css b/resources/css/sections.css index 7fa7692..9c3b991 100644 --- a/resources/css/sections.css +++ b/resources/css/sections.css @@ -13,40 +13,37 @@ .page-sections { display: block; } +/* + * Abstände (Hülle Version 2): genau drei Werte je Abschnitt, keine weitere Vorgabe aus Seiten- oder Rasterhüllen. + * - oben/unten: Innenabstand des Abschnitts; zwischen zwei Abschnitten addieren sich „unten“ und „oben“ (0 + 0 = 0). + * Bei eigener Fläche liegen beide innerhalb der Fläche, damit Hintergründe nahtlos anschließen. + * - Widget-Abstand: Abstand zwischen den Plätzen des Rasters, nebeneinander und gestapelt. + * Abstände innerhalb eines Widgets (zum Beispiel zwischen Karten) bleiben im Widget (--grid-gap). + */ .page-section { position: relative; isolation: isolate; background: var(--color-surface); color: var(--color-text); - padding-block: var(--section-space); - --section-space: clamp(3rem, 2rem + 4vw, 6rem); + padding-top: var(--section-space-top); + padding-bottom: var(--section-space-bottom); + --section-space-top: var(--section-space-compact); + --section-space-bottom: var(--section-space-compact); + --section-gap: var(--section-gap-normal); } -.section-space-compact { - --section-space: clamp(1.5rem, 1rem + 2vw, 3rem); -} - -.section-space-large { - --section-space: clamp(4.5rem, 3rem + 5vw, 8rem); -} - -/* Abweichender Abstand oben (Abschnittsgestaltung „Abstand oben“); der Abstand unten folgt weiter --section-space. */ -.page-section.section-space-top-small { - padding-top: clamp(0.75rem, 0.5rem + 1vw, 1.25rem); -} - -.page-section.section-space-top-none { - padding-top: 0; -} - -/* Aufeinanderfolgende Abschnitte ohne eigene Fläche teilen sich den Abstand, statt ihn zu verdoppeln. */ -.section-bg-default + .section-bg-default { - padding-top: 0; -} - -.section-divider-space { - margin-bottom: var(--section-space); -} +.section-space-top-none { --section-space-top: var(--section-space-none); } +.section-space-top-compact { --section-space-top: var(--section-space-compact); } +.section-space-top-normal { --section-space-top: var(--section-space-normal); } +.section-space-top-large { --section-space-top: var(--section-space-large); } +.section-space-bottom-none { --section-space-bottom: var(--section-space-none); } +.section-space-bottom-compact { --section-space-bottom: var(--section-space-compact); } +.section-space-bottom-normal { --section-space-bottom: var(--section-space-normal); } +.section-space-bottom-large { --section-space-bottom: var(--section-space-large); } +.section-gap-none { --section-gap: var(--section-gap-none); } +.section-gap-compact { --section-gap: var(--section-gap-compact); } +.section-gap-normal { --section-gap: var(--section-gap-normal); } +.section-gap-large { --section-gap: var(--section-gap-large); } .page-section-inner { position: relative; @@ -72,7 +69,7 @@ .section-width-full .page-section-inner { .section-grid { display: grid; - gap: var(--grid-gap); + gap: var(--section-gap); grid-template-columns: minmax(0, 1fr); align-items: start; } diff --git a/resources/css/tokens.css b/resources/css/tokens.css index 8e1731b..72d02e5 100644 --- a/resources/css/tokens.css +++ b/resources/css/tokens.css @@ -117,6 +117,16 @@ :root { */ --gutter: clamp(1rem, 4vw, 2.5rem); --grid-gap: clamp(1.25rem, 2.5vw, 2.25rem); + + /* Stufen der Abschnittsabstände (oben, unten) und des Widget-Abstands im Abschnittsraster (SectionStyle::SPACINGS). */ + --section-space-none: 0px; + --section-space-compact: clamp(1.5rem, 1rem + 2vw, 3rem); + --section-space-normal: clamp(3rem, 2rem + 4vw, 6rem); + --section-space-large: clamp(4.5rem, 3rem + 5vw, 8rem); + --section-gap-none: 0px; + --section-gap-compact: clamp(0.75rem, 1.25vw, 1.25rem); + --section-gap-normal: clamp(1.25rem, 2.5vw, 2.25rem); + --section-gap-large: clamp(2rem, 4vw, 3.5rem); --width-reading: 44rem; --width-standard: 82rem; --width-wide: 96rem; diff --git a/resources/views/site/templates/standard.blade.php b/resources/views/site/templates/standard.blade.php index c29beef..8d259e1 100644 --- a/resources/views/site/templates/standard.blade.php +++ b/resources/views/site/templates/standard.blade.php @@ -1,7 +1,7 @@ {{-- Seitenvorlage „standard“: Abschnitte untereinander; jeder Abschnitt bestimmt Raster, Fläche und Breite selbst. --}} {{ $content }} @if ($page->path === '/' && $themes->isNotEmpty()) -
+

Themenbereiche

diff --git a/tests/Feature/CmsPageListAndSpacingTest.php b/tests/Feature/CmsPageListAndSpacingTest.php index 750ec18..5b4e350 100644 --- a/tests/Feature/CmsPageListAndSpacingTest.php +++ b/tests/Feature/CmsPageListAndSpacingTest.php @@ -65,32 +65,75 @@ public function test_publishing_also_counts_as_an_edit(): void $this->assertSame('2026-11-18 11:00:00', $page->fresh()->updated_at->toDateTimeString()); } - public function test_first_section_can_start_directly_below_the_header_without_changing_other_spacing(): void + /** + * Drei unabhängige Abstände je Abschnitt; zwischen zwei Abschnitten addieren sich „unten“ und „oben“ (0 + 0 = 0). + */ + public function test_sections_render_three_independent_spacings(): void { $page = Page::query()->create(['path' => '/abstand']); $service = app(PageService::class); - $hero = ['type' => 'hero', 'v' => 2, 'data' => ['heading' => 'Einstieg']]; + $prose = fn (string $text) => ['type' => 'prose', 'v' => 1, 'data' => ['body' => $text]]; $revision = $service->saveRevision($page, [ - ['layout' => 'u4', 'style' => ['spacing_top' => 'none', 'spacing' => 'large'], 'slots' => [$hero]], - ['layout' => 'u4', 'style' => ['spacing_top' => 'small'], 'slots' => [['type' => 'prose', 'v' => 1, 'data' => ['body' => 'Text']]]], - ['layout' => 'u4', 'style' => [], 'slots' => [['type' => 'prose', 'v' => 1, 'data' => ['body' => 'Weiter']]]], + ['layout' => 'u4', 'style' => ['spacing_top' => 'none', 'spacing_bottom' => 'none', 'gap' => 'none'], 'slots' => [['type' => 'hero', 'v' => 2, 'data' => ['heading' => 'Einstieg']]]], + ['layout' => 'u3_1', 'style' => ['spacing_top' => 'none', 'spacing_bottom' => 'large', 'gap' => 'compact'], 'slots' => [$prose('Drei'), $prose('Eins')]], + ['layout' => 'u4', 'style' => [], 'slots' => [$prose('Vorgabe')]], ], null, null, null); $service->publish($page, $revision); $html = $this->get('/abstand')->assertOk()->getContent(); - $this->assertMatchesRegularExpression('#class="page-section section-bg-default section-width-standard section-space-large section-space-top-none section-layout-u4"#', $html); - $this->assertStringContainsString('section-space-normal section-space-top-small section-layout-u4', $html); - $this->assertSame(2, substr_count($html, 'section-space-top-'), 'Ohne Angabe gilt der normale Abstand; keine zusätzliche Klasse.'); - $this->assertSame('same', $revision->sections[2]['style']['spacing_top']); - $this->assertStringContainsString('oben kein abstand', SectionStyle::summary($revision->sections[0]['style'])); + $this->assertStringContainsString('section-space-top-none section-space-bottom-none section-gap-none section-layout-u4', $html); + $this->assertStringContainsString('section-space-top-none section-space-bottom-large section-gap-compact section-layout-u3-1', $html); + $this->assertStringContainsString('section-space-top-compact section-space-bottom-compact section-gap-normal section-layout-u4', $html, 'Vorgabe neuer Abschnitte: oben und unten kompakt, Widget-Abstand normal.'); + $style = $revision->sections[0]['style']; + $this->assertSame(['none', 'none', 'none'], [$style['spacing_top'], $style['spacing_bottom'], $style['gap']]); + $this->assertStringContainsString('Abstand oben kein abstand, unten großzügig · Widget-Abstand kompakt', SectionStyle::summary($revision->sections[1]['style'])); } - public function test_top_spacing_accepts_only_its_enumerated_values(): void + /** + * Hüllen der Version 1 werden beim Lesen so übersetzt, dass die Darstellung gleich bleibt (gespeicherte Revision unverändert). + */ + public function test_version_one_spacing_is_translated_without_changing_the_layout(): void { - $this->expectException(ValidationException::class); + $prose = ['type' => 'prose', 'v' => 1, 'data' => ['body' => 'Text']]; + $v1 = fn (array $style, ?array $slots = null) => ['id' => null, 'v' => 1, 'layout' => 'u4', 'style' => $style + ['divider' => 'none'], 'slots' => $slots ?? [$prose]]; - app(PageSections::class)->normalize([ - ['layout' => 'u4', 'style' => ['spacing_top' => '0px'], 'slots' => [['type' => 'prose', 'v' => 1, 'data' => ['body' => 'Text']]]], + $sections = app(PageSections::class)->read([ + $v1(['background' => 'default', 'spacing' => 'normal', 'spacing_top' => 'none']), + $v1(['background' => 'default', 'spacing' => 'normal']), + $v1(['background' => 'dark', 'spacing' => 'large']), + $v1(['background' => 'default', 'spacing' => 'compact', 'divider' => 'line']), + $v1(['background' => 'default', 'spacing' => 'normal', 'spacing_top' => 'small']), + $v1(['background' => 'default', 'spacing' => 'compact', 'divider' => 'space']), + $v1(['background' => 'default', 'spacing' => 'normal'], [null]), + $v1(['background' => 'default', 'spacing' => 'large']), ]); + + $spacing = array_map(fn ($s) => [$s['style']['spacing_top'], $s['style']['spacing_bottom'], $s['style']['gap'], $s['style']['divider']], $sections); + $this->assertSame([ + ['none', 'normal', 'normal', 'none'], // Abweichung „kein Abstand“ + ['none', 'normal', 'normal', 'none'], // folgt Abschnitt ohne Fläche: bisher oben 0 + ['large', 'large', 'normal', 'none'], // eigene Fläche: oben wie Abstand + ['compact', 'compact', 'normal', 'line'], // folgt dunkler Fläche: oben wie Abstand + ['compact', 'normal', 'normal', 'none'], // nach Linientrenner keine Zusammenlegung; „Gering“ wird „Kompakt“ + ['none', 'normal', 'normal', 'none'], // folgt ohne Fläche: oben 0; „Zusätzlicher Abstand“ wird unten eine Stufe mehr + ['none', 'normal', 'normal', 'none'], // leer, wird nicht dargestellt + ['none', 'large', 'normal', 'none'], // folgt Abschnitt 5 (leerer Abschnitt dazwischen zählt nicht) + ], $spacing); + $this->assertSame([2, 2], [$sections[0]['v'], $sections[7]['v']]); + $this->assertArrayNotHasKey('spacing', $sections[0]['style']); + } + + public function test_spacings_accept_only_their_enumerated_values(): void + { + foreach (['spacing_top' => 'medium', 'spacing_bottom' => '0px', 'gap' => '2rem'] as $key => $value) { + try { + app(PageSections::class)->normalize([ + ['layout' => 'u4', 'style' => ['spacing_top' => 'none', 'spacing_bottom' => 'none', 'gap' => 'none', $key => $value], 'slots' => [['type' => 'prose', 'v' => 1, 'data' => ['body' => 'Text']]]], + ]); + $this->fail("$key: $value wurde angenommen."); + } catch (ValidationException $exception) { + $this->assertArrayHasKey("sections.0.style.$key", $exception->errors()); + } + } } } diff --git a/tests/Feature/CmsSectionRenderingTest.php b/tests/Feature/CmsSectionRenderingTest.php index 38c6fe6..a8bbd23 100644 --- a/tests/Feature/CmsSectionRenderingTest.php +++ b/tests/Feature/CmsSectionRenderingTest.php @@ -61,11 +61,12 @@ public function test_sections_render_grid_ratios_backgrounds_and_dividers(): voi $html = $this->get('/raster')->assertOk()->getContent(); - $this->assertStringContainsString('page-section section-bg-dark section-width-standard section-space-normal section-layout-u4 scope-dark', $html); + $this->assertStringContainsString('page-section section-bg-dark section-width-standard section-space-top-compact section-space-bottom-compact section-gap-normal section-layout-u4 scope-dark', $html); $this->assertStringContainsString('section-bg-light section-width-wide', $html); $this->assertStringContainsString('--section-cols-lg: minmax(0, 1fr) minmax(0, 3fr); --section-cols-md: minmax(0, 1fr)', $html); $this->assertStringContainsString('--section-cols-md: repeat(2, minmax(0, 1fr))', $html, 'Vier gleiche Plätze stehen auf dem Tablet als 2 × 2.'); - $this->assertStringContainsString('section-bg-accent section-width-standard section-space-large section-layout-u1-1-1-1 scope-accent', $html); + // Eingabe im Format der Version 1 („spacing“): oben und unten großzügig, Widget-Abstand wie bisher normal. + $this->assertStringContainsString('section-bg-accent section-width-standard section-space-top-large section-space-bottom-large section-gap-normal section-layout-u1-1-1-1 scope-accent', $html); $this->assertStringContainsString('section-divider section-divider-accent', $html); $this->assertSame(1, substr_count($html, 'section-divider section-divider-line'), 'Nach dem letzten Abschnitt steht kein Trenner.'); $this->assertSame(1, substr_count($html, '

'), 'Nur das erste Widget der Seite ist Überschrift erster Ordnung.'); diff --git a/tests/Unit/PageSectionsTest.php b/tests/Unit/PageSectionsTest.php index 2006a7e..a8505f6 100644 --- a/tests/Unit/PageSectionsTest.php +++ b/tests/Unit/PageSectionsTest.php @@ -65,7 +65,7 @@ public function test_sections_are_normalized_with_slots_matching_the_layout(): v $this->assertCount(2, $stored); $this->assertSame('u1_3', $stored[0]['layout']); - $this->assertSame(1, $stored[0]['v']); + $this->assertSame(2, $stored[0]['v'], 'Hülle Version 2: drei unabhängige Abstände.'); $this->assertSame('dark', $stored[0]['style']['background']); $this->assertSame('line', $stored[0]['style']['divider']); $this->assertSame('standard', $stored[0]['style']['width']); @@ -141,7 +141,9 @@ public function test_free_style_values_and_unknown_layouts_are_rejected(): void [['layout' => 'u5', 'slots' => []], 'sections.0.layout'], [$this->section('u4', [], ['background' => '#ff00ff']), 'sections.0.style.background'], [$this->section('u4', [], ['css' => 'color: red']), 'sections.0.style.css'], - [$this->section('u4', [], ['spacing' => 'riesig']), 'sections.0.style.spacing'], + [$this->section('u4', [], ['spacing_top' => 'riesig']), 'sections.0.style.spacing_top'], + [$this->section('u4', [], ['spacing_bottom' => '0px']), 'sections.0.style.spacing_bottom'], + [$this->section('u4', [], ['gap' => '3rem']), 'sections.0.style.gap'], ] as [$section, $key]) { try { $this->sections()->normalize([$section]); @@ -218,7 +220,8 @@ public function test_reading_without_sections_wraps_legacy_blocks_in_single_colu $this->assertCount(2, $sections); $this->assertSame('u4', $sections[0]['layout']); - $this->assertSame('compact', $sections[0]['style']['spacing']); + $this->assertSame(['compact', 'compact', 'normal'], [$sections[0]['style']['spacing_top'], $sections[0]['style']['spacing_bottom'], $sections[0]['style']['gap']]); + $this->assertSame('none', $sections[1]['style']['spacing_top'], 'Wie bisher steht zwischen zwei Altbausteinen nur einmal der kompakte Abstand.'); $this->assertSame('Alt', $sections[0]['slots'][0]['data']['heading']); $this->assertSame('prose', $sections[1]['slots'][0]['type']); }