Stufe 5: Highlights als Galerie -- und ein enger Weg fuer Bilder

Aus dem Plan im Vault. "Eure Clips und Bilder" zeigte Textkarten mit
einem Anhang darunter. Ein Bild als Anhang unter einer Ueberschrift ist
kein Highlight -- dieser Bereich lebt vom Sehen. Jetzt steht das Bild
OBEN, der Text ist Bildunterschrift.

ZWEI DINGE WAREN ANDERS ALS IM PLAN

1. "Anhaenge sind schon da" stimmte nicht. Sie hingen an AUFGABEN
   (`dateien.aufgabe_id`); ein Eintrag konnte gar kein Bild tragen.
   Neue Spalte `eintrag_id`.

2. UND DER WICHTIGE, ein Sicherheitsthema: Alles in dieser Ablage geht
   bewusst als DOWNLOAD hinaus (`application/octet-stream`,
   `Content-Disposition: attachment`). Eine hochgeladene HTML- oder
   SVG-Datei wuerde sonst im Browser als Seite DIESER Domain laufen --
   mit Zugriff auf die Sitzung. Eine Galerie braucht also einen
   eigenen, engen Weg, keine Lockerung der alten Regel.

DIE FRAGE "IST DAS EIN BILD?" DARF NICHT `dateien.typ` BEANTWORTEN.
Diese Spalte traegt den vom Browser BEHAUPTETEN Typ
(`req.get("content-type")`) -- wer hochlaedt, bestimmt ihn selbst. Eine
Galerie, die ihm glaubt, liefert auf Zuruf alles inline aus. Erkannt
wird deshalb an den ERSTEN BYTES: PNG, JPEG, GIF, WEBP.

SVG IST AUSDRUECKLICH NICHT DABEI. Es ist ein Bildformat UND kann
Skript enthalten -- genau die Luecke, gegen die die Regel gebaut wurde.
Ein Format, das beides ist, gehoert nicht in die Ausnahme.

Kein Bild heisst 404, nicht 415: Eine eigene Antwort waere die Auskunft
"diese Nummer gibt es, sie ist nur kein Bild", und die laesst sich
durchzaehlen.

WESSEN REGEL GILT: Ein Bild am Community-Beitrag folgt dem BEITRAG,
nicht der Dateiablage. Deren Regel haengt an Creator-Zuordnungen, und
ein Gast hat keine -- er saehe sonst nie ein Highlight, obwohl es fuer
ihn gemacht ist.

NEU: pruef-galerie (26 Pruefungen)
Der Beweis steht in zwei Zeilen: Am Beitrag haengen VIER Dateien --
zwei echte PNGs, ein SVG und eine HTML-Datei, die sich als
"image/png" ausgibt. Im Raster stehen ZWEI. Die anderen beiden holt
der Browser, bekommt 404, und der error-Handler raeumt sie weg: kein
leerer Rahmen, kein kaputtes Symbol.

Dazu die Gegenprobe in die andere Richtung -- ein echtes PNG, das sich
als "text/plain" ausgibt, geht durch. Ohne sie hiesse "404" nur, dass
der Weg immer ablehnt. Und die Konsolenpruefung laesst genau die zwei
gewollten 404 zu und nichts sonst; ein pauschales "Konsole egal" haette
jeden echten Fehler mitversteckt.

EIN EIGENER FEHLER: Mein Test-PNG war kein dekodierbares Bild, nur ein
Dateikopf. Der Browser konnte es nicht zeichnen, der error-Handler
raeumte es weg, und die Pruefung fand im Raster nichts. Fehler in der
Pruefung, nicht im Haus -- aber ein nuetzlicher: Er hat nebenbei
gezeigt, dass ein kaputtes Bild keinen leeren Rahmen hinterlaesst.

pruef-anhaenge 37, pruef-treff 66, pruef-bereiche-lesend,
pruef-css-klassen: gruen.

Co-Authored-By: Claude Opus 5 <[email protected]>
This commit is contained in:
2026-09-17 11:43:40 +02:00
co-authored by Claude Opus 5
parent 670940bd3a
commit 4b14906371
36 changed files with 944 additions and 363 deletions
+44
View File
@@ -326,6 +326,44 @@
}
kopf.append(b);
}
/* DAS BILD STEHT OBEN, VOR DEM TITEL (17.09.2026) -- aus dem Plan
im Vault, Stufe 5.
"Highlights -- eure Clips und Bilder" zeigte bisher Textkarten
mit einem Anhang darunter. Ein Bild als Anhang unter einer
Ueberschrift ist kein Highlight; dieser Bereich lebt vom SEHEN.
Der Text wird damit zur Bildunterschrift, nicht umgekehrt.
ANSPRINGBAR UND MIT NAMEN: Ein Bild ohne `alt` ist fuer einen
Teil der Zuschauer gar nicht da, und eine Galerie aus
nicht-anspringbaren Kacheln ist keine Galerie. Deshalb ein
echter Verweis mit Beschriftung -- das kann die Tastatur, ohne
eine Zeile JavaScript. */
if (Array.isArray(e.bilder) && e.bilder.length) {
const bg = el('div', 'bildstreifen');
if (e.bilder.length > 1) bg.dataset.mehrere = 'ja';
for (const b of e.bilder) {
const a = el('a', 'bildstreifen__feld');
a.href = `/workspace/api/dateien/${b.id}/bild`;
a.target = '_blank';
a.rel = 'noopener';
const bild = el('img', 'bildstreifen__bild');
bild.src = `/workspace/api/dateien/${b.id}/bild`;
bild.loading = 'lazy';
bild.decoding = 'async';
/* Der Titel des Beitrags ist die beste Beschreibung, die es
hier gibt -- ein Dateiname wie "IMG_2831.jpg" sagt niemandem
etwas. */
bild.alt = e.titel ? `Bild zu „${e.titel}“` : (b.name || 'Bild');
/* Ist es doch kein Bild (oder die Datei fehlt), verschwindet
der Rahmen, statt ein kaputtes Symbol zu zeigen. */
bild.addEventListener('error', () => { a.remove(); if (!bg.childNodes.length) bg.remove(); });
a.append(bild);
bg.append(a);
}
k.append(bg);
}
k.append(kopf);
/* DER RANGBALKEN. Eine Wunschliste ist eine Rangfolge, keine Liste
@@ -742,6 +780,12 @@
const ziel = $('liste');
ziel.textContent = '';
ziel.setAttribute('aria-busy', 'false');
/* HIGHLIGHTS SIND EINE GALERIE, keine Spalte aus Karten. Das
Raster steht hier und nicht fest im HTML, weil dieselbe Seite
acht Bretter bedient -- ein Raster in der Datei waere fuer
sieben davon falsch. */
if (bereich === 'highlight') ziel.dataset.galerie = 'ja';
else delete ziel.dataset.galerie;
const sichtbar = daten.eintraege.filter((e) => {
if (!filter) return true;