Files
laraundfelix/docs/architektur/cms-widget-registry.md
T
LarsandClaude Opus 5.5 33aaf64024
CI Feature / test (push) Successful in 36s
Deploy Test / test (push) Successful in 32s
Deploy Test / deploy (push) Successful in 32s
Stabilisiere den Website-Rahmen und veredele die zentralen Widgets.
Designiteration 1 auf Grundlage des Brand-UI-Kits (vorläufige Werte):
- Kopfzeile mit konstanter Box und zwei Zuständen (großzügig, kompakt
  beim Scrollen) ohne Layoutsprung; Navigation bricht nie um, sondern
  verkürzt erst den Kontozugang und schaltet dann in den Menümodus.
  Scrollbalken-Reserve, gemeinsames Breitenmodell (Lesebereich,
  Standard, Breit, Vollbreite), Wortmarke und Inhalt fluchten.
- Fokusfalle im Mobilmenü schließt auch den Weg von der
  Menü-Schaltfläche in den Inhalt.
- Fußbereich mit Grundzeile für rechtliche Links und grünem Bogen.
- Markenakzente (Unterstreichung, Strahlen, Bogen) als Komponenten.
- Hero: Varianten Markenbühne (randlos) und Editorial, zweite
  Schaltfläche, Bildausschnitt. Bild und Text: Bildformat und
  Ausschnitt. Karten: hervorgehobene erste Karte, ganze Karte klickbar.
  Programmkarten mit Markentafel. Alles additiv, ohne neue Version.

Testanpassungen: Die Website-Wortmarke trägt jetzt brand-lockup, die
erste Hero-Schaltfläche button-brand (beabsichtigte Gestaltung).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 06:43:13 +01:00

23 KiB
Raw Blame History

CMS: Widget-Registry, Abschnitte, Seiteneditor und Website-Gerüst

Stand: 17.11.2026, Iteration 2 (Branch feature/cms-sections, baut auf Iteration 1 feature/cms-widget-registry auf). Bezug: ADR-22, ADR-28, ADR-29, ADR-30, ADR-32, ADR-36 (12_Entscheidungsprotokoll_ADR.md), Website-CMS-Zielarchitektur §§5.3–5.6, 6.2. Designsystem: docs/architektur/designsystem.md.

Dieses Dokument beschreibt den umgesetzten Stand für Entwickler. Es ist keine fachliche Freigabe der ADRs.

1. Überblick

Seite → Abschnitte (Raster, Gestaltung) → Plätze → je Platz höchstens ein Widget aus dem Register

config/cms.php ──► WidgetRegistry ──► PageSections (Lesen, Prüfen, Rollback-Fassung)
                        │                    │
                        │                    ▼
                        │             SectionRenderer ──► WidgetRenderer ──► widgets/<typ>.blade.php
                        │                    ▲                  ▲
                        │                    │                  └── Widget-Vorschau im Editor (WidgetBlock)
                        │                    ├── öffentliche Seite (PageController::show)
                        │                    └── Vorschau einer Revision (PageController::preview)
                        └──► SectionEditor + WidgetEditor (Filament: Abschnitte, Raster, Plätze, Widget-Dialoge)
Baustein Datei Aufgabe
Vertrag app/Domain/Cms/Widgets/WidgetType.php abstrakte Basisklasse jeder Widget-Art, einschließlich Mindestbreite
Register app/Domain/Cms/Widgets/WidgetRegistry.php Registrierung, Lesen (Anheben älterer Fassungen), Prüfen und Bereinigen je Widget
Abschnitte app/Domain/Cms/Sections/PageSections.php Abschnitts- und Platzmodell: Lesen, Prüfen, flache Rollback-Fassung, Medien
Raster und Gestaltung app/Domain/Cms/Sections/SectionLayouts.php, SectionStyle.php freigegebene Raster und Gestaltungswerte (Aufzählungen)
Darstellung app/Domain/Cms/Sections/SectionRenderer.php, Widgets/WidgetRenderer.php einziger Renderweg für Seite, Vorschau und Editor
Editor-Adapter app/Filament/Support/SectionEditor.php, WidgetEditor.php, WidgetBlock.php, ReportsSectionErrors.php Abschnitte, Rasterauswahl, Plätze, Widget-Dialoge, Fehlermeldungen
Navigation app/Domain/Cms/SiteNavigation.php Kopf- und Fußnavigation aus dem CMS-Navigationsmodell
Katalog-Lesesicht app/Domain/Cms/Catalog/PublicCatalogReader.php einzige Stelle, die entscheidet, welche Programme/Module öffentlich erscheinen
Hilfen app/Domain/Cms/Widgets/Support/* sichere Links, bereinigter formatierter Text, öffentlicher Medienbereich, Bildauswahl
Seitenvorlagen app/Domain/Cms/PageTemplates.php, resources/views/site/templates/ derzeit nur standard (Abschnitte untereinander)
Layout resources/views/layouts/site.blade.php, resources/views/components/site/* Kopfzeile, Wortmarke, Navigation, Inhaltsfläche, Fußbereich
Designsystem resources/css/{tokens,base,components,site,sections,widgets}.css Tokens, Grundkomponenten, Gerüst, Abschnitte, Widgets
Wiederherstellung app/Console/Commands/RevertPublishedPages.php cms:revert-published vor einem Code-Rollback (Abschnitt 9)

2. Widget-Vertrag

Jede Widget-Instanz (in einem Platz von page_revisions.sections und in der flachen Liste page_revisions.blocks) hat dieselbe Hülle:

Feld Inhalt
id stabile Kennung (UUID), bleibt beim Bearbeiten erhalten; Duplikate erhalten beim Speichern eine neue (seitenweit geprüft)
type Typkennung aus dem Register; ändert sich nie
v Schemaversion der Art
variant eine der für die Art registrierten Varianten
settings nur registrierte Aufzählungswerte; freie Werte werden abgewiesen. Seit Designiteration 1: hero (focus, text_side), image_text (format, focus). Fehlt ein Wert, gilt die Vorgabe der Darstellung
data redaktionelle Inhalte
refs Verweise auf Fachobjekte oder Medien, nur Kennungen bzw. Pfade im öffentlichen Bereich cms/

Gespeichert werden nur Schlüssel, für die die Art Prüfregeln deklariert. Felder mit führendem _ (zum Beispiel _upload) sind Editorhilfen und werden nie gespeichert.

3. Versionierung und Altbestand

  • Altformat (vor der Registry: {type, heading, intro, …} ohne v) wird beim Lesen als Version 1 interpretiert (WidgetType::fromLegacy).
  • Liegt v unter der aktuellen Version, hebt WidgetType::upgrade($widget, $from) schrittweise an.
  • Revisionen ohne Abschnitte (sections = null, alles vor Iteration 2) werden als einspaltige Abschnitte mit kompaktem Abstand gelesen (PageSections::read).
  • Gespeicherte Revisionen werden nicht umgeschrieben. Erst eine neue Revision aus dem Editor speichert Abschnitte und aktuelle Hüllen.
  • „Wiederherstellen“ kopiert Abschnitte und flache Liste einer Revision unverändert.
  • Unbekannte Widget-Arten werden ausgelassen; unbekannte Raster- oder Gestaltungswerte fallen beim Lesen auf Vorgaben zurück. Eine Hülle mit höherer Version als im Code wird bestmöglich dargestellt, aber nicht gespeichert.
  • Regel: Optionale neue Felder brauchen keine neue Version. Umbenennen, Umdeuten oder Verschieben von Feldern braucht eine neue Version mit upgrade() und einen Test. Gleiches gilt für die Abschnittshülle (PageSections::VERSION).

Beispiel: image_text Version 1 {image, alt, body (Klartext)} → Version 2 data {title, body (bereinigtes HTML), alt}, refs {image}, Variante image_left.

4. Registrierte Widget-Arten

Kennung Name Version Varianten Verweise Mindestbreite
hero Einstieg (Hero) 1 standard (Bild neben dem Text), highlight (Markenfläche), stage (Markenbühne, randlos), editorial (textbetont) refs.image 2
heading Überschrift und Einleitung 1 standard – 1
prose Fließtext 1 standard – 1
image_text Bild und Text 2 image_left, image_right refs.image 2
cards Redaktionelle Karten 1 standard (Raster), compact (kompakte Liste), featured (erste Karte hervorgehoben) Bild je Karte in data.items[].image 1
catalog_cards Programm- und Modulkarten 1 standard (Karten mit Kurzbeschreibung), compact (Liste) refs.items[] = {type: composition, id} 1
call_to_action Handlungsaufruf 1 standard – 1
faq FAQ 1 standard – 2

Darstellungsklassen: widget widget-<typ> widget-variant-<variante> an der Widget-Hülle; je Ansicht eigene Klassen (hero-highlight, hero-stage, image-text-right, image-format-portrait, cards-compact, cards-featured, catalog-cards-compact). Die visuelle Veredelung verändert nur resources/views/widgets/* und resources/css/widgets.css, nicht Daten, Register oder Editor.

Designiteration 1 (additiv, keine neue Version):

Art Neu Gespeichert als
hero Varianten stage, editorial; zweite Schaltfläche; Bildausschnitt; Textseite der Markenbühne variant; data.cta2_label, data.cta2_url (sicheres Linkziel wie cta_url); settings.focus (Werte wie Abschnittsfokus), settings.text_side (left, right)
image_text Bildformat und Bildausschnitt settings.format (landscape, portrait, square, original), settings.focus
cards Variante featured; ganze Karte über den Titellink klickbar variant
catalog_cards Markentafel statt Bild, eine Karte breit mit Tafel daneben keine Datenänderung

Ältere Instanzen enthalten die neuen Schlüssel nicht und werden mit den Vorgaben dargestellt (Test CmsDesignIterationTest). Die erste Schaltfläche des Einstiegs ist jetzt die gelbe Markenschaltfläche (button button-brand).

Randlos (WidgetType::bleeds). Eine Markenbühne mit Bild, die allein in ihrem Abschnitt steht, setzt am Abschnitt section-bleed: kein Innenabstand, keine Breitenbegrenzung, das Bild reicht über die ganze Fensterbreite; die Texttafel richtet sich am Standardraster aus. In mehrspaltigen Abschnitten erscheint dieselbe Bühne als Bild mit runden Ecken und überlappender Tafel.

5. Neues Widget hinzufügen

  1. Klasse unter app/Domain/Cms/Widgets/Types/ anlegen, von WidgetType ableiten. Pflicht: key(), label(), description(), dataRules(), dataFields(). Je nach Bedarf: variants(), minUnits()/preferredUnits()/stages() (Abschnitt 12), refRules(), refFields(), clean() (Links mit SafeUrl, Text mit RichText::sanitize, Bilder mit ImageRefFields::clean), resolve(), mediaPaths(), summary(), schematic(), icon().
  2. Ansicht resources/views/widgets/<kennung>.blade.php anlegen. Verfügbar: $data, $refs, $variant, $settings, $first, $context (Vorschau ja/nein) und die Rückgabe von resolve(). Kein {!! !!} außer für mit RichText::sanitize bereinigten Text. Breitenabhängige Regeln als Container-Abfrage @container slot (…), nicht als Fenster-Medienabfrage; Farben nur über Bedeutungs-Tokens.
  3. Klasse in config/cms.php unter widgets eintragen.
  4. Tests ergänzen (Registrierung und Prüfregeln in tests/Unit/WidgetRegistryTest.php, Darstellung in tests/Feature/CmsWidgetRenderingTest.php bzw. CmsSectionRenderingTest.php).

Editor, Plätze, Vorschau, Speicherung und öffentliche Darstellung brauchen keine Änderung. WidgetRegistryTest::test_a_new_widget_type_works_through_the_contract_alone belegt das mit einer nur im Test definierten Art.

Fachobjekt-Widgets (künftig Angebote, Lizenzartikel, Kampagnen) speichern ausschließlich Kennungen in refs und lesen Anzeigeinhalte über eine Lesesicht wie PublicCatalogReader. Preise, Rechte und Angebotsbedingungen werden nie in data kopiert.

6. Öffentliche Freigabe von Programmen und Modulen (Übergangsregel)

ADR-29 (öffentliche Fachobjektprofile) ist nicht umgesetzt. Deshalb gilt in PublicCatalogReader:

Objekt Im Editor wählbar Öffentlich sichtbar Redaktionsvorschau
Programm mit Anzeigefreigabe, nicht archiviert ja ja, mit Link auf /programme/{id} (dieselbe Regel wie die bestehende Programmliste) ja
Modul mit Anzeigefreigabe, nicht archiviert ja nein ja, mit Hinweis „Nur in der Redaktionsvorschau sichtbar“
Fassung ohne Anzeigefreigabe, Entwurf, archiviert, ohne Inhaltsart nein (Speichern wird abgewiesen) nein nein

Die Prüfung erfolgt bei jeder Darstellung, nicht nur beim Speichern: Wird eine Anzeigefreigabe zurückgenommen, verschwindet die Karte ohne Seitenänderung. Vorschaubilder der Bibliothek sind geschützt (Paket 6) und werden nicht gezeigt; die Karte zeigt eine Inhaltsart-Fläche.

Offener Integrationsschritt: Mit ADR-29 ersetzt die Profilprüfung (Status „gelistet“, gezeigte Fassung, freigegebenes Bild) die Übergangsregel in PublicCatalogReader::isPublic()/entries(). Daten der Widgets ändern sich dadurch nicht.

7. Medien

  • Wählbar sind nur Bilder im öffentlichen Website-Bereich cms/ (media_public bzw. noch nicht übertragene Uploads in cms_incoming). Bibliotheksmedien und Filmstandbilder erscheinen nicht, auch nicht als Abschnittshintergrund.
  • Neue Uploads (Widgets und Abschnittshintergründe) landen im Webprozess in cms_incoming (privater Speicher); PublishPublicMedia überträgt sie in der Hintergrundverarbeitung nach media_public. Der Web-Prozess schreibt nicht in den Medienbestand.
  • Widget-Bilder sind an einen Alternativtext gebunden (Ausnahme: Kartenbilder gelten als dekorativ, alt=""). Abschnittshintergründe sind dekorativ (alt=""); tragende Aussagen stehen als HTML-Text in den Widgets.

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, 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-Vorschau: dieselbe Ansicht wie öffentlich, im isolierten iframe mit dem Website-Stylesheet, in der tatsächlichen Platzbreite (Container-Abfragen greifen). Keine eigene Bildlaufleiste; über 22 rem wird gekürzt mit Hinweis „vollständig in der Seitenvorschau“. Die Abschnittsfläche zeigt erst die Seitenvorschau.
  • „Entwurf speichern“ erzeugt eine Revision (bei unverändertem Stand keine weitere). „Veröffentlichen“ speichert zuerst den aktuellen Stand im Editor und veröffentlicht genau diesen; enthält er Fehler, wird nichts veröffentlicht. Vorher veröffentlichte „Veröffentlichen“ nur die zuletzt gespeicherte Revision, sodass übernommene, aber ungespeicherte Änderungen (etwa ein gewähltes Bild) verloren gingen.
  • Verlassen oder Neuladen mit ungespeicherten Änderungen löst eine Warnung des Browsers aus.
  • Ganzseitige Vorschau: /redaktion/vorschau/{revision}/geraete mit Umschaltern 390/768/1440 px; zeigt Kopfzeile, Navigation, Abschnitte, Flächen, Trenner und Fußbereich mit demselben Renderer wie die öffentliche Seite; noindex.
  • Revisionen: Vorschau, Veröffentlichen, Wiederherstellen (legt eine neue Revision an).
  • Seitenliste: „Duplizieren“ legt eine unveröffentlichte Kopie des zuletzt gespeicherten Stands unter neuer Adresse an; die Vorlage bleibt unverändert.

Fehler beim Speichern erscheinen als Meldung „Abschnitt N, Platz M (Widget-Art): …“ und als Zusammenfassung am Platzraster des Abschnitts, auch wenn das Feld im geschlossenen Widget-Dialog liegt (Registry-Fehler über SectionEditor::mapErrors, Formularfehler über ReportsSectionErrors).

9. Rollback und Datenformat (wichtig vor dem Merge nach main)

Speicherung. Jede neue Revision schreibt zwei Spalten:

Spalte Inhalt Wer liest sie
page_revisions.sections (neu, ergänzend, nullable) Abschnitte mit Raster, Gestaltung und Plätzen Code ab Iteration 2
page_revisions.blocks (bestehend) alle Widgets in Lesereihenfolge als flache Hüllenliste Code der Iteration 1; Iteration 2 nur bei sections = null

Was ein reiner Code-Rollback bewirkt (scripts/deploy.sh setzt nur den Code zurück):

Rollback auf Seiten, die nach dem Deploy gespeichert wurden Sicher?
Iteration 1 (Widget-Registry ohne Abschnitte) zeigen alle Widgets untereinander; Raster, Flächen, Hintergrundbilder, Trenner und Untermenüs entfallen darstellbar, aber nicht gleichwertig
Stand vor der Widget-Registry (derzeitiger Stand main/Prod) blocks liegt im Hüllenformat vor, das dieser Code nicht lesen kann: Fehler auf genau diesen Seiten nicht sicher

Wiederherstellungsweg (vor dem Code-Rollback, solange der neue Code läuft):

  1. Probelauf: php artisan cms:revert-published --before="<Zeitpunkt des Deployments>" listet jede veröffentlichte Seite, deren Revision danach entstand, und die Revision, auf die zurückgesetzt würde.
  2. Ausführen mit --apply: Nur der Veröffentlichungszeiger wechselt auf die letzte Revision vor dem Zeitpunkt (Altformat). Seiten ohne ältere Revision werden zurückgezogen, nicht gelöscht. Keine Revision wird geändert oder gelöscht.
  3. Danach den Code zurückrollen. Nach einem erneuten Vorwärts-Deploy lassen sich die neueren Revisionen in der Revisionsliste wieder veröffentlichen.

Ist der neue Code nicht mehr lauffähig, entspricht Schritt 2 dieser Anweisung (nur nach bestätigtem Backup, PostgreSQL; :deploy ersetzen):

UPDATE pages p SET published_revision_id = (
  SELECT r.id FROM page_revisions r
  WHERE r.page_id = p.id AND r.created_at < :deploy ORDER BY r.id DESC LIMIT 1)
WHERE p.published_revision_id IN (SELECT id FROM page_revisions WHERE created_at >= :deploy);

Die Migrationen (sections, parent_id) sind ergänzend und müssen beim Rollback nicht zurückgenommen werden; älterer Code ignoriert beide Spalten.

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.

10. Navigation

NavigationItemResource: Einträge bearbeiten, aus-/einblenden (is_visible), löschen, Reihenfolge per Ziehen („Reihenfolge ändern“), interne Seite oder geprüfte Adresse.

  • Plätze: header (Hauptnavigation), footer (Fußbereich: Service), footer_contact (Kontakt), footer_legal (Rechtliches). Die Fußbereichsgruppen sind Werte derselben Spalte, keine zweite Verwaltung. Leere Gruppen erscheinen nicht.
  • Untermenü: eine Ebene über parent_id (ergänzende Migration), nur in der Hauptnavigation und nur unter Einträgen der obersten Ebene. Ist der übergeordnete Eintrag ausgeblendet, sind seine Untereinträge es auch; wird er gelöscht, rücken sie nach oben. Ein Eintrag mit Untereinträgen darf ohne eigenes Ziel nur das Untermenü öffnen.
  • Aktiver Eintrag: aus dem angefragten Pfad (aria-current="page"; der übergeordnete Eintrag wird als aktiver Pfad markiert).
  • Die Ausgabe hängt nie vom Anmeldestatus ab (ADR-32). Der Kontozugang „Mitgliederbereich“ ist für alle gleich und leitet Gäste zur Anmeldung.

11. Abschnitte und Plätze

Gespeicherte Hülle eines Abschnitts (sections[], Version 1):

{"id": "uuid", "v": 1, "layout": "u1_3",
 "style": {"background": "dark", "image": null, "focus": "center", "overlay": "light",
           "width": "standard", "spacing": "normal", "divider": "line"},
 "slots": [{"id": "…", "type": "cards", "v": 1, "…": "…"}, null]}
Raster Einheiten Desktop (Abschnitt ab 60 rem) Tablet (40–60 rem) Smartphone
u4 4 volle Breite volle Breite volle Breite
u2_2 2 + 2 1 : 1 zwei Spalten gestapelt
u1_3 / u3_1 1 + 3 / 3 + 1 1 : 3 / 3 : 1 gestapelt gestapelt
u1_2_1 1 + 2 + 1 1 : 2 : 1 gestapelt gestapelt
u1_1_1_1 1 + 1 + 1 + 1 vier Spalten 2 × 2 gestapelt
  • Die Einheiten werden als Spaltenverhältnis (fr) umgesetzt, nicht als zweites CSS-Grundraster. Der Umbruch richtet sich nach der Breite des Abschnitts (Container-Abfrage section); ein schmaler Abschnitt stapelt deshalb früher.
  • Gestapelt wird immer in Platzreihenfolge; Lese- und Fokusreihenfolge bleiben gleich (keine visuelle Umordnung).
  • Leere Plätze gibt es im Editor. Öffentlich entfallen sie; die übrigen Plätze teilen sich die Breite im Verhältnis ihrer Einheiten. Ein Abschnitt ohne darstellbares Widget entfällt samt Fläche und Trenner.
  • 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.
    • 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).
  • 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.

12. Responsive Widget-Regeln

Jede Widget-Art meldet minUnits() (kleinste zulässige Platzbreite auf dem Desktop), preferredUnits() (Hinweis) und stages() (Darstellungsstufen). Jeder Platz ist ein Container (slot); die Widget-Ansichten verwenden Container-Abfragen statt Fensterbreiten.

Widget Mindestbreite Vorzug Stufen
Einstieg (Hero) 2 4 unter 48 rem Bild unter dem Text; ab 48 rem nebeneinander; Überschrift wächst mit der Platzbreite. Markenbühne: unter 56 rem Bild 4:3 mit überlappender Tafel, ab 56 rem Bild über die ganze Bühne (30–46 rem hoch) mit Tafel links oder rechts. Editorial: ab 56 rem Beschreibung und Schaltflächen nebeneinander, Bild 21:9
Überschrift 1 4 Größe folgt der Platzbreite
Fließtext 1 2 Zeilenlänge höchstens etwa 70 Zeichen
Bild und Text 2 4 unter 36 rem gestapelt; ab 36 rem Bild und Text gleich breit; ab 56 rem Bild betont (7:5); festes Bildformat nach Einstellung
Redaktionelle Karten 1 4 so viele Karten nebeneinander, wie bei 15 rem Kartenbreite passen; hervorgehobene erste Karte ab 44 rem mit Bild neben dem Text; kompakte Liste mit kleinem Bild rechts
Programm- und Modulkarten 1 4 ab 17 rem Kartenbreite mehrspaltig; eine einzelne Karte ab 40 rem mit Tafel neben dem Text; kompakte Liste für schmale Plätze
Handlungsaufruf 1 2 unter 20 rem Schaltfläche in voller Breite
FAQ 2 4 Fragen untereinander, Antworten auf Lesebreite

Ableitung: Ein Platz mit einer Einheit ist bei Standardbreite auf dem Desktop etwa 17 rem (rund 276 px) breit. Bild-neben-Text und Einstieg sind darin nicht sinnvoll lesbar (zwei Spalten unter je 140 px); Karten, Fließtext und Aufrufe bleiben es. Ein zu schmaler Platz wird beim Speichern mit Abschnitt und Platz gemeldet; der Platzkopf im Editor zeigt „zu schmal“ bereits vorher. Auf Tablet und Smartphone stapeln die Plätze, dort gilt die Mindestbreite nicht.