*/ public const PARAMETERS = [ 'body' => ['label' => 'Fließtext', 'default' => 17, 'min' => 16, 'max' => 20, 'unit' => 'px', 'group' => 'Schrift', 'hint' => 'Schriftgröße auf Desktop; auf kleinen Bildschirmen etwa 1 px weniger, nie unter 16 px.', 'effect' => 'Auch Einleitung, Überschrift 3, kleine Schrift und Schaltflächen folgen daraus.'], 'h1' => ['label' => 'Überschrift 1', 'default' => 40, 'min' => 30, 'max' => 56, 'unit' => 'px', 'group' => 'Schrift', 'hint' => 'Seitentitel auf Desktop; schrumpft auf Smartphones auf etwa 70 %.', 'effect' => 'Muss mindestens 4 px größer sein als Überschrift 2.'], 'h2' => ['label' => 'Überschrift 2', 'default' => 28, 'min' => 22, 'max' => 40, 'unit' => 'px', 'group' => 'Schrift', 'hint' => 'Abschnittstitel auf Desktop; auch Titel in Bild und Text, Handlungsaufruf und breiten Karten.', 'effect' => 'Muss mindestens 6 px größer sein als der Fließtext. Überschrift 3 bleibt darunter.'], 'display' => ['label' => 'Display-Überschrift (Höchstwert)', 'default' => 52, 'min' => 36, 'max' => 80, 'unit' => 'px', 'group' => 'Schrift', 'hint' => 'Größter Titel (Einstieg). Wächst mit der Breite des Platzes bis zu diesem Wert.', 'effect' => 'Mindestens so groß wie Überschrift 1.'], 'space' => ['label' => 'Basisabstand', 'default' => 8, 'min' => 6, 'max' => 12, 'unit' => 'px', 'group' => 'Abstände', 'hint' => 'Grundmaß des Abstandsrasters (halber, einfacher, anderthalbfacher bis zwölffacher Wert).', 'effect' => 'Alle Abstandsstufen der Komponenten und die Abstände zwischen Plätzen im Raster.'], 'section' => ['label' => 'Abschnittsabstand (Desktop)', 'default' => 48, 'min' => 24, 'max' => 96, 'unit' => 'px', 'group' => 'Abstände', 'hint' => 'Stufe „Normal“ auf Desktop. „Kompakt“ ist zwei Drittel davon, „Großzügig“ das Anderthalbfache.', 'effect' => 'Auf Smartphones werden alle Stufen kleiner.'], 'card_pad' => ['label' => 'Karten-Innenabstand', 'default' => 20, 'min' => 12, 'max' => 32, 'unit' => 'px', 'group' => 'Abstände', 'hint' => 'Innenabstand von Karten auf Desktop.', 'effect' => 'Große Flächen (Einstieg, Bild und Text, Handlungsaufruf) verwenden das Ein- bis Zweifache.'], 'header' => ['label' => 'Höhe der Kopfzeile', 'default' => 80, 'min' => 56, 'max' => 112, 'unit' => 'px', 'group' => 'Rahmen', 'hint' => 'Kopfzeile im Ausgangszustand auf Desktop. Beim Scrollen und auf Smartphones gilt 80 % davon.', 'effect' => 'Die Anzeigegröße der Wortmarke folgt daraus; die Wortmarke selbst bleibt unverändert.'], 'width' => ['label' => 'Maximale Inhaltsbreite', 'default' => 1312, 'min' => 960, 'max' => 1600, 'unit' => 'px', 'group' => 'Rahmen', 'hint' => 'Breite des Standardrasters; Kopfzeile, Inhalt und Fußbereich fluchten hier. „Breit“ ist etwa 17 % mehr.', 'effect' => 'Der Lesebereich (44 rem) ist davon unabhängig.'], 'media' => ['label' => 'Bildhöhe in Bild und Text (Desktop)', 'default' => 320, 'min' => 200, 'max' => 480, 'unit' => 'px', 'group' => 'Medien', 'hint' => 'Höhe des Bildes neben dem Text in der Variante „Standard“. Kompakt: 75 %, Großzügig: 130 %.', 'effect' => 'Bestimmt zugleich die Mindesthöhe des Einstiegs (das 1,2-Fache; kompakt und großzügig wie bei Bild und Text).'], ]; /** Gruppen in fester Reihenfolge. */ public const GROUPS = ['Schrift', 'Abstände', 'Rahmen', 'Medien']; /** * @return array */ public static function defaults(): array { return array_map(static fn (array $p): int => $p['default'], self::PARAMETERS); } /** Name der CSS-Variable, zum Beispiel card_pad → --ds-card-pad. */ public static function variable(string $key): string { return '--ds-'.str_replace('_', '-', $key); } /** * Prüft vollständige Eingaben (Zeichenketten aus dem Formular oder Zahlen). Gibt Fehlermeldungen je Schlüssel zurück; * leer, wenn alles zulässig ist. * * @param array $input * @return array */ public static function errors(array $input): array { $rules = []; $messages = []; $names = []; foreach (self::PARAMETERS as $key => $p) { $rules[$key] = ['required', 'integer', 'min:'.$p['min'], 'max:'.$p['max']]; $names[$key] = $p['label']; $messages["$key.required"] = $p['label'].': Bitte einen Wert eintragen.'; $messages["$key.integer"] = $p['label'].': Bitte eine ganze Zahl in Pixeln eintragen.'; $messages["$key.min"] = $p['label'].': Der Wert muss mindestens '.$p['min'].' px betragen.'; $messages["$key.max"] = $p['label'].': Der Wert darf höchstens '.$p['max'].' px betragen.'; } $validator = Validator::make(array_intersect_key($input, self::PARAMETERS), $rules, $messages, $names); $errors = []; foreach ($validator->errors()->messages() as $key => $list) { $errors[$key] = $list[0]; } if ($errors !== []) { return $errors; } $v = array_map('intval', array_intersect_key($input, self::PARAMETERS)); if ($v['h2'] < $v['body'] + 6) { $errors['h2'] = 'Überschrift 2 muss mindestens 6 px größer sein als der Fließtext ('.($v['body'] + 6).' px).'; } if ($v['h1'] < $v['h2'] + 4) { $errors['h1'] = 'Überschrift 1 muss mindestens 4 px größer sein als Überschrift 2 ('.($v['h2'] + 4).' px).'; } if ($v['display'] < $v['h1']) { $errors['display'] = 'Die Display-Überschrift darf nicht kleiner sein als Überschrift 1 ('.$v['h1'].' px).'; } return $errors; } /** * Gespeicherte Werte lesen: nur bekannte Schlüssel, ganze Zahlen im zulässigen Bereich und stimmige Reihenfolge. * Alles andere (fehlende Schlüssel, Fremdes, beschädigte Daten) ergibt die Standardwerte, nie einen Fehler. * * @return array */ public static function read(mixed $stored): array { if (! is_array($stored)) { return self::defaults(); } $merged = self::defaults(); foreach (array_keys(self::PARAMETERS) as $key) { if (array_key_exists($key, $stored) && (is_int($stored[$key]) || (is_string($stored[$key]) && ctype_digit($stored[$key])))) { $merged[$key] = (int) $stored[$key]; } } return self::errors($merged) === [] ? $merged : self::defaults(); } /** * Inline-Stylesheet mit den abweichenden Basiswerten. Ausgegeben werden ausschließlich geprüfte ganze Zahlen zu * bekannten Schlüsseln. Ohne Abweichung leer: dann gelten die Standardwerte aus tokens.css. * * @param array $values */ public static function css(array $values): string { $declarations = ''; foreach (self::PARAMETERS as $key => $p) { $value = $values[$key] ?? $p['default']; if ($value !== $p['default'] && $value >= $p['min'] && $value <= $p['max']) { $declarations .= sprintf('%s:%d;', self::variable($key), $value); } } return $declarations === '' ? '' : ':root{'.$declarations.'}'; } }