"Sieht gut aus" ist Geschmack und laesst sich nicht pruefen. Handwerkliche
Qualitaet laesst sich pruefen -- und bei einer WEBDESIGN-Seite ist sie
zugleich das Verkaufsargument: Wer selbst schludert, kann schlecht
Sorgfalt verkaufen.
Neues Werkzeug pruef-design.mjs misst 13 Seiten x 5 Sprachen auf
Handy-Breite gegen WCAG 2.2 AA -- denselben Standard, auf den auch das
Barrierefreiheitsstaerkungsgesetz verweist. Der Browser rechnet, es wird
nichts geschaetzt.
ERGEBNIS: 0 Befunde. Kontrast, Klickflaechen, Tastaturfokus,
Ueberschriftenstruktur, Bildalternativen, Feldbeschriftungen,
lang-Attribut, Schriftgroessen.
ECHTE BEFUNDE, DIE BEHOBEN WURDEN
1. 23 Schriftgroessen unter 12px (bis hinunter zu 10,9px), verteilt ueber
CSS und sieben Seiten. Betroffen waren durchweg gesperrte
Grossbuchstaben-Beschriftungen -- also genau die Textsorte, die klein
ohnehin am schlechtesten lesbar ist. Alle auf mindestens 12px, die
gesperrten auf 12,8px. Das ist zugleich die Dauervorgabe
"augenschonend" ernst genommen.
2. Ueberschriftensprung h2 -> h4 in der Fusszeile, auf ALLEN 13 Seiten in
allen 5 Sprachen (42 Stellen). Wer sich mit einem Screenreader durch
die Ueberschriften bewegt, hoert dadurch eine Gliederung, die es nicht
gibt, und vermutet uebersprungene Abschnitte. Jetzt h2 mit
Gestaltungsklasse: Die Ebene sagt etwas ueber die STRUKTUR, die
Groesse ueber die GEWICHTUNG -- zwei verschiedene Dinge.
3. code-Auszeichnung auf der Rechtsseite rutschte durch relative
Groessenangabe auf 11,2px. Jetzt mit Untergrenze abgesichert.
SECHS FEHLALARME IM WERKZEUG -- ALLE GEFUNDEN UND BESEITIGT
Der erste Lauf meldete 302 Fundstellen. Fast alle waren falsch. Haette
ich sie "repariert", haette ich funktionierende Gestaltung zerstoert.
Jeder Fehlalarm hatte eine eigene, nicht offensichtliche Ursache:
* Farbverlaeufe: getComputedStyle().backgroundColor liefert bei einer
reinen Verlaufsflaeche "rgba(0,0,0,0)". Die Suche lief an der hellen
Knopfflaeche VORBEI bis zum dunklen Seitengrund und verglich dunkle
Schrift mit dunklem Grund -- Ergebnis 1:1 fuer 60 einwandfreie
Knoepfe. Jetzt werden die Farbstopps ausgelesen und der
unguenstigste Fall gerechnet.
* MEHRERE Hintergrundebenen: Die Karten nutzen den bekannten Kniff
"Flaeche padding-box, Rahmenverlauf border-box". Der helle
Rahmenverlauf ist im Textbereich gar nicht sichtbar. Alle Ebenen
zusammenzurechnen ergab 820 Meldungen mit Werten wie "3,45:1" fuer
Text, der in Wahrheit ueber 7:1 liegt. CSS malt die ERSTE Ebene oben
-- nur die zaehlt. Das Trennen an Kommas muss dabei die Kommas
INNERHALB der Verlaufsklammern respektieren.
* Verlaufsschrift (background-clip:text): Dort ist die Schriftfarbe
durchsichtig und der Verlauf IST der Text. Farbe gegen Hintergrund zu
vergleichen ergibt zwangslaeufig 1:1.
* Verlaufsstopps mit wenig Deckkraft (9 % und 4 % Gold in den
Hinweiskaesten) wurden verworfen statt auf den Untergrund gerechnet.
Uebrig blieb "nicht messbar" fuer 72 Textstellen. Ein Pruefwerkzeug,
das bei allem passt, prueft nichts.
* Laufende Ueberblendungen: getComputedStyle liefert waehrend einer
Ueberblendung den ZWISCHENWERT. Nach blur() verblasst der Fokusring
ueber 0,16 s -- misst man sofort, sieht man ihn noch, und "vorher"
ist identisch mit "nachher". Das Codefeld der Verwaltung wurde
dadurch als "ohne sichtbaren Fokus" gemeldet. Nachgewiesen mit
el.matches(":focus") === false bei gleichzeitig sichtbarem Schatten.
Loesung: Ueberblendungen fuer die Messung abschalten.
* Ausgeblendete Abschnitte: Eine Ueberschrift in einem versteckten
Bereich hat selbst weiterhin display:block. Im Portal wurden dadurch
drei h1 gezaehlt, obwohl immer nur eine sichtbar ist. Jetzt
getClientRects().
Dazu zwei bekannte Muster, die das Werkzeug jetzt kennt: der Sprunglink
(absichtlich aus dem Bild geschoben) und die winzigen Auswahlfelder
hinter den Kacheln (die Kachel IST die Klickflaeche).
ALLE UEBRIGEN PRUEFUNGEN WEITERHIN GRUEN nach den Aenderungen:
Anfragedetail 20, Verwaltung 69, Portal 32, Widerruf 58, Textkodierung
55 Seiten-Sprach-Kombinationen.
Versionsstempel und Cache-Name auf v8.
Co-Authored-By: Claude Opus 5 <[email protected]>
192 lines
7.9 KiB
JavaScript
192 lines
7.9 KiB
JavaScript
/* =====================================================================
|
|
sw.js — Service Worker NUR für /webdesign/
|
|
Macht den Bereich auf Handy und Computer als App installierbar und
|
|
sorgt dafür, dass die Oberfläche auch bei wackeliger Verbindung
|
|
sofort da ist.
|
|
|
|
⚠️ SICHERHEITSENTSCHEIDUNG, DIE HIER DEN AUSSCHLAG GIBT
|
|
|
|
Der Webdesign-Bereich ist zugangsgeschützt (server/webdesign-gate.js).
|
|
Ein Service Worker, der HTML-Seiten zwischenspeichert, würde diesen
|
|
Schutz aushebeln: Nach dem Abmelden — oder nachdem jemand anders das
|
|
Gerät in die Hand nimmt — lieferte der Zwischenspeicher die geschützten
|
|
Seiten samt Preisen, Anfragen und Kundendaten weiterhin aus, ohne dass
|
|
der Server je gefragt wird. Genau das ist der klassische Fehler bei
|
|
PWAs hinter einer Anmeldung.
|
|
|
|
Deshalb gilt hier strikt:
|
|
- HTML-Seiten werden NIEMALS zwischengespeichert. Immer Netz.
|
|
Ist kein Netz da, kommt eine schlichte Offline-Meldung — nicht die
|
|
zuletzt gesehene, möglicherweise vertrauliche Seite.
|
|
- Zwischengespeichert werden ausschließlich die neutralen Bausteine
|
|
unter /assets/ (Stilvorlagen, Skripte, Logo, Icons). Die enthalten
|
|
keine Kunden- oder Projektdaten und liegen ohnehin außerhalb der
|
|
Zugangsschranke.
|
|
- Antworten der API (postfach.dogfather-universe.com) werden
|
|
ebenfalls nie zwischengespeichert.
|
|
|
|
Das kostet Offline-Komfort. Der ist hier aber weniger wert als die
|
|
Zusicherung, dass nach dem Schließen der Sitzung wirklich nichts mehr
|
|
einsehbar ist.
|
|
===================================================================== */
|
|
|
|
/* Version im Namen: eine Änderung dieser Zeichenkette wirft beim nächsten
|
|
Start alle alten Zwischenspeicher weg. Muss bei jeder Änderung an den
|
|
Dateien unten hochgezählt werden, sonst hängen Nutzer auf einem alten
|
|
Stand fest. */
|
|
const CACHE_NAME = "dogfather-webdesign-v8";
|
|
|
|
/* Bausteine, die die Oberfläche zum Anzeigen braucht. Bewusst KEINE
|
|
HTML-Datei in dieser Liste. */
|
|
const GRUNDGERUEST = [
|
|
"/assets/css/main.css",
|
|
"/assets/css/webdesign.css",
|
|
"/assets/js/wd-core.js",
|
|
"/assets/img/logo-dogfather-transparent.png",
|
|
"/assets/img/wd-app-192.png",
|
|
"/assets/img/wd-app-512.png",
|
|
];
|
|
|
|
self.addEventListener("install", (ereignis) => {
|
|
ereignis.waitUntil(
|
|
caches.open(CACHE_NAME).then((speicher) =>
|
|
/* addAll bricht komplett ab, wenn EINE Datei fehlt — dann wäre der
|
|
Service Worker gar nicht erst installiert und die App nicht
|
|
installierbar. Deshalb jede Datei einzeln und Fehler schlucken. */
|
|
Promise.all(
|
|
GRUNDGERUEST.map((pfad) =>
|
|
speicher.add(new Request(pfad, { cache: "reload" })).catch(() => {})
|
|
)
|
|
)
|
|
)
|
|
);
|
|
/* Sofort übernehmen statt auf das Schließen aller Tabs zu warten —
|
|
sonst bleibt nach einem Deploy tagelang die alte Fassung aktiv. */
|
|
self.skipWaiting();
|
|
});
|
|
|
|
self.addEventListener("activate", (ereignis) => {
|
|
ereignis.waitUntil(
|
|
caches.keys()
|
|
.then((namen) => Promise.all(
|
|
namen.filter((n) => n !== CACHE_NAME).map((n) => caches.delete(n))
|
|
))
|
|
.then(() => self.clients.claim())
|
|
);
|
|
});
|
|
|
|
/* Schlichte Offline-Meldung. Bewusst als erzeugte Antwort statt als
|
|
Datei — so kann sie nie mit echtem Seiteninhalt verwechselt werden.
|
|
Fünf Sprachen wären hier Überinstrumentierung: der Text erscheint nur
|
|
ohne Internet und ist absichtlich sehr kurz gehalten. */
|
|
function offlineSeite() {
|
|
return new Response(
|
|
`<!DOCTYPE html><html lang="de"><head><meta charset="utf-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
<title>Keine Verbindung</title>
|
|
<style>
|
|
body{margin:0;min-height:100svh;display:flex;align-items:center;justify-content:center;
|
|
background:#05070b;color:#eef4fb;font-family:system-ui,sans-serif;text-align:center;padding:2rem}
|
|
.k{max-width:34ch}
|
|
h1{font-size:1.4rem;margin:0 0 .6rem}
|
|
p{color:#b3c2d4;line-height:1.6;margin:0 0 1.4rem}
|
|
button{min-height:48px;padding:.8rem 1.6rem;border:none;border-radius:999px;
|
|
background:#7fd0e8;color:#04070c;font-weight:700;font-size:1rem;cursor:pointer}
|
|
</style></head><body>
|
|
<div class="k">
|
|
<h1>Keine Verbindung</h1>
|
|
<p>Dogfather Webdesign braucht eine Internetverbindung. Sobald du wieder online bist, geht es normal weiter.</p>
|
|
<button onclick="location.reload()">Erneut versuchen</button>
|
|
</div></body></html>`,
|
|
{ status: 503, headers: { "Content-Type": "text/html; charset=utf-8" } }
|
|
);
|
|
}
|
|
|
|
self.addEventListener("fetch", (ereignis) => {
|
|
const anfrage = ereignis.request;
|
|
|
|
// Nur einfache Abrufe. Absendungen (POST) gehen immer direkt ans Netz.
|
|
if (anfrage.method !== "GET") return;
|
|
|
|
const url = new URL(anfrage.url);
|
|
|
|
// Fremde Server (API, externe Bilder) nie anfassen.
|
|
if (url.origin !== self.location.origin) return;
|
|
|
|
/* --- HTML: immer Netz, niemals zwischenspeichern (siehe Kopf) --- */
|
|
const willHtml = anfrage.mode === "navigate" ||
|
|
(anfrage.headers.get("accept") || "").includes("text/html");
|
|
if (willHtml) {
|
|
ereignis.respondWith(
|
|
fetch(anfrage).catch(() => offlineSeite())
|
|
);
|
|
return;
|
|
}
|
|
|
|
/* --- Zugangs-Endpunkte niemals zwischenspeichern --- */
|
|
if (url.pathname.startsWith("/webdesign/zugang-")) return;
|
|
|
|
/* --- Neutrale Bausteine unter /assets/ ---
|
|
|
|
⚠️ HIER WAR EIN ECHTER FEHLER (gemeldet 22.08.2026: "immer noch so").
|
|
|
|
Vorher lief das als "stale-while-revalidate": die gespeicherte Fassung
|
|
ging sofort raus, im Hintergrund wurde eine frische geholt. Das ist
|
|
schnell — bedeutet aber, dass jede Korrektur an CSS oder JavaScript
|
|
beim ersten Aufruf UNSICHTBAR bleibt und erst beim zweiten wirkt.
|
|
Genau das ist passiert: die Korrektur am gestreckten Logo war auf dem
|
|
Server längst live, der Browser hat aber die alte Stilvorlage aus
|
|
meinem eigenen Zwischenspeicher angezeigt. Ein Fehler, der wie ein
|
|
nicht behobener Fehler aussieht — die unangenehmste Sorte.
|
|
|
|
Jetzt: erst Netz, Zwischenspeicher nur als Notfallnetz.
|
|
Für Stilvorlagen und Skripte ist Richtigkeit wichtiger als die
|
|
eingesparten Millisekunden — eine falsche Darstellung kostet mehr
|
|
als ein kurzer Ladevorgang. Bilder und Symbole bleiben beim schnellen
|
|
Weg: die ändern sich praktisch nie, und wenn doch, bekommen sie einen
|
|
neuen Dateinamen. */
|
|
if (url.pathname.startsWith("/assets/")) {
|
|
const istCodeOderStil = /\.(css|js|mjs)$/i.test(url.pathname);
|
|
|
|
if (istCodeOderStil) {
|
|
// Netz zuerst
|
|
ereignis.respondWith(
|
|
fetch(anfrage)
|
|
.then((antwort) => {
|
|
if (antwort && antwort.status === 200 && antwort.type === "basic") {
|
|
const kopie = antwort.clone();
|
|
caches.open(CACHE_NAME).then((speicher) => speicher.put(anfrage, kopie));
|
|
}
|
|
return antwort;
|
|
})
|
|
.catch(() => caches.match(anfrage).then((g) => g || Response.error()))
|
|
);
|
|
return;
|
|
}
|
|
|
|
// Bilder, Symbole, Schriften: Zwischenspeicher zuerst
|
|
ereignis.respondWith(
|
|
caches.open(CACHE_NAME).then(async (speicher) => {
|
|
const gespeichert = await speicher.match(anfrage);
|
|
const ausDemNetz = fetch(anfrage)
|
|
.then((antwort) => {
|
|
/* Nur vollständige, eigene Antworten ablegen. Teilantworten
|
|
(206, z.B. bei Video-Sprüngen) lassen sich nicht sinnvoll
|
|
zwischenspeichern und würden den Speicher beschädigen. */
|
|
if (antwort && antwort.status === 200 && antwort.type === "basic") {
|
|
speicher.put(anfrage, antwort.clone());
|
|
}
|
|
return antwort;
|
|
})
|
|
.catch(() => null);
|
|
|
|
return gespeichert || (await ausDemNetz) || Response.error();
|
|
})
|
|
);
|
|
return;
|
|
}
|
|
|
|
/* Alles Übrige: kein respondWith -> der Browser macht es ganz normal
|
|
selbst. Das ist die sicherste Voreinstellung. */
|
|
});
|