Vereinfache die Abschnittsabstände auf oben, unten und Widget-Abstand.
CI Feature / test (push) Successful in 42s
Deploy Test / test (push) Successful in 37s
Deploy Test / deploy (push) Successful in 31s

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 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Opus 5.5 committed 2026-11-18 12:39:57 +01:00
1 parent f4d225d0b2
commit f511ad10de
10 files changed
+238 -94

No files matched your search

+19 -9
View File
@@ -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],
];
}
+3 -6
View File
@@ -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 = '<div class="'.e(implode(' ', $classes)).'"'.$id.'>';
+99 -23
View File
@@ -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<string, string> */
/**
* 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<string, string>
*/
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<string, string>
*/
public const SPACINGS_TOP = [
'same' => 'Wie „Abstand oben und unten“',
'small' => 'Gering',
'none' => 'Kein Abstand',
];
/** @var array<string, string> */
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<string, mixed> $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<array<string, mixed>> $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<array<string, mixed>> 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;
}
}
+15 -8
View File
@@ -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)
+25 -28
View File
@@ -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;
}
+10
View File
@@ -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;
@@ -1,7 +1,7 @@
{{-- Seitenvorlage „standard“: Abschnitte untereinander; jeder Abschnitt bestimmt Raster, Fläche und Breite selbst. --}}
{{ $content }}
@if ($page->path === '/' && $themes->isNotEmpty())
<div class="page-section section-bg-default section-width-standard section-space-normal">
<div class="page-section section-bg-default section-width-standard section-space-top-none section-space-bottom-normal section-gap-normal">
<div class="page-section-inner">
<section class="block">
<h2>Themenbereiche</h2>
+57 -14
View File
@@ -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());
}
}
}
}
+3 -2
View File
@@ -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, '<h1>'), 'Nur das erste Widget der Seite ist Überschrift erster Ordnung.');
+6 -3
View File
@@ -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']);
}