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>
84 lines
2.7 KiB
PHP
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>';
|
|
}
|
|
}
|