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:
1 parent
e0a3fdbb70
commit
67614158e4
23 files changed
+1110
-111
No files matched your search
@@ -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.'}';
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,121 @@
|
||||
<?php
|
||||
|
||||
namespace App\Domain\Design;
|
||||
|
||||
use App\Models\User;
|
||||
use Illuminate\Support\Carbon;
|
||||
use Illuminate\Support\Facades\Cache;
|
||||
use Illuminate\Support\HtmlString;
|
||||
use Throwable;
|
||||
|
||||
/**
|
||||
* Lesen und Schreiben der Größenskala (Schlüssel „design.scale“ in site_settings).
|
||||
*
|
||||
* Die öffentliche Ausgabe hängt nie am Erfolg dieser Klasse: Fehlt die Tabelle (Code vor Migration), ist die Datenbank
|
||||
* nicht erreichbar oder sind die Daten beschädigt, gelten die Standardwerte aus tokens.css, ohne Fehlerseite.
|
||||
* Änderungen wirken sofort (Zwischenspeicher wird beim Speichern geleert), ohne Deployment.
|
||||
*/
|
||||
final class DesignSettings
|
||||
{
|
||||
public const KEY = 'design.scale';
|
||||
|
||||
private const CACHE_KEY = 'design.scale.v1';
|
||||
|
||||
/** @var array<string, int>|null */
|
||||
private static ?array $memo = null;
|
||||
|
||||
/**
|
||||
* Wirksame Werte (gespeichert oder Standard).
|
||||
*
|
||||
* @return array<string, int>
|
||||
*/
|
||||
public static function values(): array
|
||||
{
|
||||
if (self::$memo !== null) {
|
||||
return self::$memo;
|
||||
}
|
||||
|
||||
try {
|
||||
$stored = Cache::rememberForever(self::CACHE_KEY, static function (): array {
|
||||
$row = SiteSetting::query()->find(self::KEY);
|
||||
|
||||
return $row === null ? [] : (array) $row->value;
|
||||
});
|
||||
|
||||
return self::$memo = $stored === [] ? DesignScale::defaults() : DesignScale::read($stored);
|
||||
} catch (Throwable) {
|
||||
return self::$memo = DesignScale::defaults();
|
||||
}
|
||||
}
|
||||
|
||||
/** Ob abweichende Werte wirksam sind. */
|
||||
public static function isCustomised(): bool
|
||||
{
|
||||
return self::values() !== DesignScale::defaults();
|
||||
}
|
||||
|
||||
/**
|
||||
* Speichert vollständige, geprüfte Werte.
|
||||
*
|
||||
* @param array<string, mixed> $input
|
||||
* @return array<string, string> Fehlermeldungen je Schlüssel; leer bei Erfolg
|
||||
*/
|
||||
public static function save(array $input, ?User $by = null): array
|
||||
{
|
||||
$errors = DesignScale::errors($input);
|
||||
|
||||
if ($errors !== []) {
|
||||
return $errors;
|
||||
}
|
||||
|
||||
$ordered = [];
|
||||
|
||||
foreach (array_keys(DesignScale::PARAMETERS) as $key) {
|
||||
$ordered[$key] = (int) $input[$key];
|
||||
}
|
||||
|
||||
SiteSetting::query()->updateOrCreate(['key' => self::KEY], ['value' => $ordered, 'updated_by' => $by?->getKey()]);
|
||||
self::flush();
|
||||
|
||||
return [];
|
||||
}
|
||||
|
||||
/** Standardwerte wiederherstellen: die Zeile entfällt, es gelten wieder die Werte aus tokens.css. */
|
||||
public static function reset(): void
|
||||
{
|
||||
SiteSetting::query()->whereKey(self::KEY)->delete();
|
||||
self::flush();
|
||||
}
|
||||
|
||||
/** Zeitpunkt der letzten Speicherung, falls vorhanden. */
|
||||
public static function updatedAt(): ?Carbon
|
||||
{
|
||||
try {
|
||||
return SiteSetting::query()->find(self::KEY)?->updated_at;
|
||||
} catch (Throwable) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
public static function flush(): void
|
||||
{
|
||||
self::$memo = null;
|
||||
|
||||
try {
|
||||
Cache::forget(self::CACHE_KEY);
|
||||
} catch (Throwable) {
|
||||
// Der Zwischenspeicher ist nur Beschleunigung.
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Stylesheet-Block für Layouts und Vorschauen; nach dem Stylesheet der Website einzufügen, damit er gewinnt.
|
||||
* Leer, solange keine abweichenden Werte gespeichert sind.
|
||||
*/
|
||||
public static function styleTag(): HtmlString
|
||||
{
|
||||
$css = DesignScale::css(self::values());
|
||||
|
||||
return new HtmlString($css === '' ? '' : '<style id="lf-design-scale">'.$css.'</style>');
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,31 @@
|
||||
<?php
|
||||
|
||||
namespace App\Domain\Design;
|
||||
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
|
||||
/**
|
||||
* Eine Einstellung der Website (Schlüssel-Wert, Wert als JSON). Lesen und Schreiben der Größenskala
|
||||
* läuft über DesignSettings.
|
||||
*
|
||||
* @property string $key
|
||||
* @property array<string, mixed> $value
|
||||
* @property int|null $updated_by
|
||||
*/
|
||||
class SiteSetting extends Model
|
||||
{
|
||||
protected $table = 'site_settings';
|
||||
|
||||
protected $primaryKey = 'key';
|
||||
|
||||
public $incrementing = false;
|
||||
|
||||
protected $keyType = 'string';
|
||||
|
||||
protected $guarded = [];
|
||||
|
||||
protected function casts(): array
|
||||
{
|
||||
return ['value' => 'array'];
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user