Führe eine konfigurierbare Größenskala für Website und Vorschau ein

Zehn Basiswerte (Fließtext, Überschriften, Abstände, Kopfzeile, Inhaltsbreite, Bildhöhe) leiten in tokens.css alle Größen ab. Einstieg, Bild und Text, Premium-Karten, Karten, Kopf, Fuß und Schaltflächen verwenden nur noch diese Tokens. Die Werte sind unter Website, Design, Größen einstellbar und wirken ohne Deployment über ein Inline-Stylesheet in Website, Mitgliederbereich-Layout und CMS-Vorschau. Lesen fällt bei fehlender Tabelle oder beschädigten Daten auf die Standardwerte zurück. Die Migration ist rein ergänzend.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
StommerandClaude Sonnet 5.5 committed 2026-11-22 14:54:14 +01:00
1 parent e0a3fdbb70
commit 67614158e4
23 files changed
+1110 -111

No files matched your search

+164
View File
@@ -0,0 +1,164 @@
<?php
namespace App\Domain\Design;
use Illuminate\Support\Facades\Validator;
/**
* Basiswerte der Größenskala des gemeinsamen Designsystems (ADR-44). Es sind bewusst nur zehn Werte; alles Weitere
* (Überschrift 3, Einleitung, kleine Schrift, Abschnitts- und Widget-Abstände, Kopfzeile kompakt, Mindesthöhen der
* Varianten …) leitet resources/css/tokens.css daraus ab. Die Ableitungsregeln stehen nur dort.
*
* Die Werte sind Pixel als ganze Zahl. Im Stylesheet werden sie in rem umgerechnet, damit die Textgröße des Browsers
* wirkt. Die Standardwerte stehen ebenfalls in tokens.css (Block „Basiswerte“); ein Test hält beide gleich.
* Trefferflächen (44 px) und die Untergrenze der Schrift auf Smartphones (16 px) sind nicht einstellbar.
*/
final class DesignScale
{
/**
* @var array<string, array{label: string, default: int, min: int, max: int, unit: string, group: string, hint: string, effect: string}>
*/
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<string, int>
*/
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<string, mixed> $input
* @return array<string, string>
*/
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<string, int>
*/
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<string, int> $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.'}';
}
}