Loheide-eu-mitarbeiterplatt.../app/Support/Theme/Contrast.php
Friederich Loheide 82bbeef31b
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 2m7s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 2m11s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 2m16s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 2m18s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 2m49s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 2m46s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 2m41s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 2m33s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m0s
Phase 5: Erscheinungsbild mit Entwurf, Vorschau und Veröffentlichen
- Theme in den Einstellungen (Entwurf/veröffentlicht), Übernahme der
  Einstellungen aus Phase 0; statische CSS-Datei mit Hash beim Veröffentlichen
- Logos hell/dunkel, Signet, App-Symbol → Favicon, Homescreen-Symbole,
  Web-App-Manifest; SVG-Bereinigung
- Markenfarbe exakt, zweite Akzentfarbe, Kopfleiste hell/Marke/dunkel,
  Kontrastprüfung (WCAG AA) mit automatisch lesbarer Linkfarbe
- Lokale Schriften (Latein), Überschriften-Schrift, eigene WOFF2-Schrift,
  Ecken, Dichte, Dunkelmodus-Regel
- Anmeldeseite (geteilt/zentriert, Bild, Texte), Fußzeile, E-Mails im Design
- Admin: Live-Vorschau (Startseite, Anmeldung, Beispielseite; hell/dunkel),
  Veröffentlichen, Verwerfen, Export/Import, Zurücksetzen, eigenes CSS
- Admin-Bereich übernimmt Logo, Farbe und Favicon; Whitelabel

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-26 10:46:05 +00:00

91 lines
3.4 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
namespace App\Support\Theme;
use App\Support\ColorPalette;
/**
* Kontrastprüfung nach WCAG 2.1 (AA: 4,5:1 für Text, 3:1 für große Schrift und Bedienelemente).
* Warnt und schlägt vor – blockiert nichts.
*/
final class Contrast
{
public const LIGHT_BACKGROUND = '#FFFFFF';
public const DARK_BACKGROUND = '#171A1E';
public const AA = 4.5;
/**
* Farbe für Links und Akzenttext auf hellem Grund: die Markenfarbe selbst,
* sonst die erste dunklere Abstufung mit ausreichendem Kontrast.
*/
public static function textShadeOnLight(string $hex): int
{
$palette = ColorPalette::fromHex($hex);
foreach ([600, 700, 800, 900, 950] as $shade) {
if (ColorPalette::contrast($palette[$shade], self::LIGHT_BACKGROUND) >= self::AA) {
return $shade;
}
}
return 950;
}
/**
* Farbe für Links und Akzenttext auf dunklem Grund.
*/
public static function textShadeOnDark(string $hex): int
{
$palette = ColorPalette::fromHex($hex);
foreach ([300, 200, 100, 50] as $shade) {
if (ColorPalette::contrast($palette[$shade], self::DARK_BACKGROUND) >= self::AA) {
return $shade;
}
}
return 50;
}
/**
* Hinweise für die Seite „Erscheinungsbild“.
*
* @return list<array{level: string, text: string}>
*/
public static function report(string $primary, ?string $secondary = null): array
{
$notes = [];
$foreground = ColorPalette::foregroundFor($primary);
$onButton = ColorPalette::contrast($primary, $foreground);
$onWhite = ColorPalette::contrast($primary, self::LIGHT_BACKGROUND);
$palette = ColorPalette::fromHex($primary);
$notes[] = $onButton >= self::AA
? ['level' => 'ok', 'text' => sprintf('Schrift auf Schaltflächen (%s): Kontrast %s:1 – gut lesbar.', $foreground === '#FFFFFF' ? 'weiß' : 'schwarz', self::format($onButton))]
: ['level' => 'warning', 'text' => sprintf('Schrift auf Schaltflächen erreicht nur %s:1 (empfohlen mindestens 4,5:1). Eine etwas dunklere oder hellere Markenfarbe wäre besser lesbar, z. B. %s.', self::format($onButton), $palette[700])];
if ($onWhite >= self::AA) {
$notes[] = ['level' => 'ok', 'text' => sprintf('Links auf hellem Grund: Kontrast %s:1 – die Markenfarbe wird unverändert verwendet.', self::format($onWhite))];
} else {
$shade = self::textShadeOnLight($primary);
$notes[] = ['level' => 'info', 'text' => sprintf('Die Markenfarbe ist auf Weiß als Textfarbe zu hell (%s:1). Für Links und Akzenttexte wird automatisch die dunklere Abstufung %s verwendet. Schaltflächen und Flächen behalten die Markenfarbe.', self::format($onWhite), $palette[$shade])];
}
if ($secondary !== null) {
$onWhite2 = ColorPalette::contrast($secondary, self::LIGHT_BACKGROUND);
if ($onWhite2 < 3) {
$notes[] = ['level' => 'info', 'text' => sprintf('Die zweite Akzentfarbe ist auf Weiß sehr hell (%s:1). Für Beschriftungen wird automatisch eine dunklere Abstufung verwendet.', self::format($onWhite2))];
}
}
return $notes;
}
private static function format(float $ratio): string
{
return number_format($ratio, 1, ',', '');
}
}