Files
LarsandClaude Opus 5.5 0bfb53463a
CI Feature / test (push) Successful in 41s
Deploy Test / test (push) Successful in 37s
Deploy Test / deploy (push) Successful in 33s
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>
2026-11-18 10:20:09 +01:00

84 lines
2.7 KiB
PHP

<?php
namespace App\Domain\Cms\Widgets;
use Illuminate\Support\HtmlString;
/**
* Einziger Darstellungsweg für Widgets: öffentliche Seite, ganzseitige Vorschau und Blockvorschau im Editor
* verwenden dieselbe Blade-Ansicht je Widget-Art.
*/
class WidgetRenderer
{
public function __construct(private readonly WidgetRegistry $registry) {}
/**
* @param array<int|string, mixed>|null $blocks gespeicherte Bausteine (Altformat oder Hülle)
*/
public function renderAll(?array $blocks, RenderContext $context): HtmlString
{
$html = '';
$position = 0;
foreach (array_values($blocks ?? []) as $block) {
if (! is_array($block)) {
continue;
}
$widget = $this->registry->upcast($block);
if ($widget === null) {
if ($context->preview) {
$html .= '<section class="block widget-unknown"><p class="preview-note">Unbekannter Baustein „'.e((string) ($block['type'] ?? '')).'“ wird öffentlich nicht angezeigt.</p></section>';
}
continue;
}
$rendered = $this->renderWidget($widget, $context, $position === 0);
if ($rendered !== '') {
$html .= $rendered;
$position++;
}
}
return new HtmlString($html);
}
/**
* Rendert eine Instanz samt Abschnittshülle. Liefert '' wenn das Widget nichts darzustellen hat.
*
* @param array<string, mixed> $widget aktuelle Hülle
*/
public function renderWidget(array $widget, RenderContext $context, bool $first = false): string
{
$type = $this->registry->get($widget['type']);
$inner = trim(view($type->view(), [
'widget' => $widget,
'data' => $widget['data'],
'refs' => $widget['refs'],
'variant' => $widget['variant'],
'settings' => $widget['settings'],
'height' => $type->height($widget),
'first' => $first,
'context' => $context,
] + $type->resolve($widget, $context))->render());
if ($inner === '') {
return '';
}
$id = is_string($widget['id'] ?? null) ? ' id="abschnitt-'.e($widget['id']).'"' : '';
// Gemeinsamer Layoutvertrag (ADR-38): Höhe als Klasse an der Hülle, nur wenn die Art Höhen anbietet.
$height = $type->height($widget);
$heightClass = $height !== null ? ' widget-height-'.e($height) : '';
return '<section class="block widget widget-'.e(str_replace('_', '-', $widget['type'])).' widget-variant-'.e(str_replace('_', '-', $widget['variant'])).$heightClass.'"'.$id.'>'
.$inner
.'</section>';
}
}