Knopf nach oben, Bildbetrachter, Rechtszeile als Baustein (Schema v19)

Der Knopf "nach oben" ist ein Anker, kein Skript: er springt an den
Seitenanfang, eingeblendet ueber eine Scroll-Zeitachse. Abschaltbar und
vollstaendig einstellbar - Seite, Form, Groesse, Farben, Schwelle,
Beschriftung.

Bilder lassen sich vergroessern, je Bild waehlbar (nichts / vergroessern
/ Adresse), Galerien mit einem Schalter. Grundlage ist ein gewoehnlicher
Verweis auf die grosse Fassung: ohne JavaScript oeffnet er das Bild, mit
JavaScript einen dialog-Betrachter mit Blaettern, Escape und Pfeiltasten.
Das Skript laedt nur, wo es etwas zu tun hat.

Die Rechtszeile wird ein Baustein und steht damit im Fussbereich statt
als heller Streifen darunter. Die eingebaute Leiste erscheint nur noch,
wenn die Seite den Baustein nicht enthaelt.

Dabei gefunden: zwei Stylesheet-Regeln griffen seit drei
Veroeffentlichungen nicht mehr. Beim Entfernen alter Regeln waren
Selektorreste stehen geblieben, und CSS nimmt dann die naechste Regel
mit - betroffen waren der Einwilligungsdialog und die Rechtszeile. Ein
Test prueft jetzt jede CSS-Datei auf abgebrochene Selektoren.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/Controller/PageController.php

@@ -54,7 +54,7 @@ final class PageController extends AbstractController
             $theme = $this->theme->load();
             // Theme first, block styles after, so a block always wins over the site defaults.
             $sections = $this->sections($page['document'], $areas);
-            $styles = $this->theme->css($theme).$this->styles->compileDocument($page['document']).$this->code->compileDocument($page['document']);
+            $styles = $this->theme->css($theme).$this->scrollTopStyles($this->settings->load(), $theme).$this->styles->compileDocument($page['document']).$this->code->compileDocument($page['document']);
             foreach ([...array_values($areas), ...array_values($sections)] as $extra) {
                 $styles .= $this->styles->compileDocument($extra).$this->code->compileDocument($extra);
             }
@@ -89,6 +89,9 @@ final class PageController extends AbstractController
                 // Ein Slider mit automatischem Weiterblättern ist der zweite Baustein, der
                 // dafür ein Skript braucht - nach demselben Muster wie die Tabs.
                 'needsSlider' => $this->hasAutoplaySlider($page['document']),
+                // Ein Bild, das sich vergroessern laesst, ist ohne Skript ein Verweis auf die
+                // grosse Fassung. Das Skript kommt nur dazu, wo es etwas zu tun hat.
+                'needsZoom' => $this->hasZoom($page['document']) || (bool) array_filter(array_values($areas), fn (array $area): bool => $this->hasZoom($area)),
                 // Own scripts arrive as one file per page, never inline, so the policy can stay
                 // hash based and no page without a script loses its strict setting.
                 'pageScript' => [] === $this->code->scriptsOf($page['document']) ? null : '/assets/seite/'.$page['id'].'.js',
@@ -107,13 +110,18 @@ final class PageController extends AbstractController
                 'googleFonts' => $googleFonts,
                 'localFonts' => $localFonts,
                 'styleBundle' => $this->bundle->url([] !== $localFonts),
+                // Steht die Rechtszeile als Baustein im Dokument oder in einem Bereich, entfaellt
+                // die eingebaute Leiste am Seitenende - zweimal dasselbe waere schlechter als gar
+                // nichts, und die Pflicht ist mit dem Baustein erfuellt.
+                'hasLegalBlock' => $this->hasType($page['document'], 'legal')
+                    || (bool) array_filter(array_values($areas), fn (array $area): bool => $this->hasType($area, 'legal')),
             ]);
         }
 
         // Die Pruefung braucht ein Skript von Cloudflare und einen Rahmen dafuer. Beides wird nur
         // dort erlaubt, wo tatsaechlich ein Formular steht - nicht auf jeder Seite der Website.
         $mitTurnstile = null !== $page && $this->turnstile->isActive() && $this->hasType($page['document'], 'form');
-        $wantsScript = null !== $page && ($mitTurnstile || $this->hasType($page['document'], 'tabs') || $this->hasAutoplaySlider($page['document']) || [] !== $this->code->scriptsOf($page['document']));
+        $wantsScript = null !== $page && ($mitTurnstile || $this->hasType($page['document'], 'tabs') || $this->hasAutoplaySlider($page['document']) || $this->hasZoom($page['document']) || [] !== $this->code->scriptsOf($page['document']));
         $frames = null === $page ? [] : $this->frameHosts($request, $page['document'], ...array_values($areas), ...array_values($sections));
         if ($mitTurnstile) {
             $frames[] = 'challenges.cloudflare.com';
@@ -249,6 +257,50 @@ final class PageController extends AbstractController
      *
      * @return list<array>
      */
+    /**
+     * Die Gestaltungswerte des Knopfes „nach oben", als Variablen für das Stylesheet.
+     *
+     * Sie stehen in den Einstellungen und nicht im Theme, weil sie zur Website gehören und nicht
+     * zum Dokument - aber sie müssen in denselben Stilblock, dessen Prüfsumme in der
+     * Sicherheitsrichtlinie steht. Ein zweiter Block wäre ein zweiter Hash.
+     */
+    private function scrollTopStyles(array $settings, array $theme): string
+    {
+        if (!($settings['scrollTop'] ?? false)) {
+            return '';
+        }
+        $farbe = static function (string $wert) use ($theme): ?string {
+            if ('' === $wert) {
+                return null;
+            }
+            if (!str_starts_with($wert, '@')) {
+                return $wert;
+            }
+            foreach ($theme['colors'] as $eintrag) {
+                if ($eintrag['key'] === substr($wert, 1)) {
+                    return sprintf('var(--k-%s)', $eintrag['key']);
+                }
+            }
+
+            return null;
+        };
+        $werte = [sprintf('--kant-top-size:%dpx', (int) ($settings['scrollTopSize'] ?? 48))];
+        $werte[] = sprintf('--kant-top-radius:%s', match ($settings['scrollTopShape'] ?? 'rund') {
+            'eckig' => '0',
+            'weich' => '12px',
+            default => '999px',
+        });
+        $werte[] = sprintf('--kant-top-after:%dpx', (int) ($settings['scrollTopAfter'] ?? 400));
+        foreach (['scrollTopColor' => '--kant-top-bg', 'scrollTopInk' => '--kant-top-ink'] as $feld => $variable) {
+            $wert = $farbe((string) ($settings[$feld] ?? ''));
+            if (null !== $wert) {
+                $werte[] = $variable.':'.$wert;
+            }
+        }
+
+        return ':root{'.implode(';', $werte).'}';
+    }
+
     /**
      * Das Bild, das beim Teilen erscheint - und im strukturierten Datensatz.
      *
@@ -323,6 +375,25 @@ final class PageController extends AbstractController
     }
 
     /** True when the stored document contains at least one block of that type. */
+    /** Enthaelt das Dokument ein Bild oder eine Galerie, die sich vergroessern laesst? */
+    private function hasZoom(array $document): bool
+    {
+        $gefunden = false;
+        $walk = function (array $blocks) use (&$walk, &$gefunden): void {
+            foreach ($blocks as $block) {
+                if ('vergroessern' === ($block['props']['click'] ?? null) || true === ($block['props']['lightbox'] ?? null)) {
+                    $gefunden = true;
+
+                    return;
+                }
+                $walk($block['children'] ?? []);
+            }
+        };
+        $walk($document['blocks'] ?? []);
+
+        return $gefunden;
+    }
+
     /** True when a slider on this page asked to advance by itself. */
     private function hasAutoplaySlider(array $document): bool
     {