Die Foto-Sektion meiner alten Seite lief jahrelang mit Flickrs justified-layout. Bewährter Code, technisch aber aus der Zeit gefallen: CommonJS-Modul mit UMD-Build für den Browser und seit v4.1.0 im Januar 2021 kein neues Release. Für die nächste Fassung der Foto-Seite und ein paar andere Astro-Projekte wollte ich etwas, das sich von Anfang an wie eine Astro-Komponente anfühlt. Also habe ich es neu geschrieben. Im April 2026 kam die erste öffentliche Version heraus: @altner/astro-justified-gallery-layout.
Das Paket steht in der Tradition von Flickrs Original, ist aber von Grund auf neu gebaut. Deutlich kleiner, nur ESM, TypeScript-Typen mitgeliefert, im Kern keine Runtime-Dependencies. Dazu kommen genau die Bausteine, die ich für eine echte Foto-Seite gebraucht habe.
Was im Paket steckt
<JustifiedGallery />: die Standard-Komponente. Sie ordnet sich bei Größenänderungen des Containers neu an (ResizeObserver), nutzt Astros<Image />zur Optimierung und kann lange Listen perIntersectionObserverhäppchenweise rendern.<JustifiedGalleryVirtual />: DOM-Windowing für riesige Sammlungen. Der Server liefert einen leeren Container, der Client holt die Metadaten portionsweise von einem JSON-Endpoint und hält nur die sichtbaren Reihen im DOM.<Lightbox />: ein natives<dialog>-Modal mit Pfeiltasten, Wischen, ESC und Schließen per Klick auf den Hintergrund. Du bindest es einmal pro Seite ein und schaltest es pro Galerie mit dem Proplightboxzu.galleryLoader(): ein Astro-Content-Loader, der ein Verzeichnis durchsucht. Optional liest er EXIF, IPTC, XMP und GPS überexifrund erzeugt LQIP-Vorschauen übersharp, also Base64-Platzhalter von etwa 1 KB für einen sofortigen ersten Bildaufbau.computeLayout(): die reine Funktion dahinter. Rund 120 Zeilen, an kein Framework gebunden, auch außerhalb von Astro nutzbar.readPhotoMeta()/formatCameraLine(): kleine Helfer, die aus EXIF eine lesbare Zeile machen, etwaSony ILCE-7M3 · 35mm · f/2.8 · 1/250s · ISO 400.
Minimal-Beispiel
---
import JustifiedGallery from '@altner/astro-justified-gallery-layout/JustifiedGallery.astro';
import Lightbox from '@altner/astro-justified-gallery-layout/Lightbox.astro';
import type { ImageMetadata } from 'astro';
const modules = import.meta.glob<{ default: ImageMetadata }>(
'../assets/photos/*.{jpg,jpeg,png,webp,avif}',
{ eager: true },
);
const images = Object.values(modules).map((m) => ({ src: m.default }));
---
<JustifiedGallery
images={images}
targetRowHeight={240}
gap={6}
chunkSize={30}
lightbox
/>
<Lightbox />
Mehr braucht es nicht. Bilder ins Verzeichnis legen, astro dev starten, fertig. Lazy Loading, LQIP-Platzhalter und Lightbox sind dabei.
Wie eine Reihe umbricht
Der interessanteste Teil steckt in computeLayout(). Während Bilder in eine Reihe kommen, berechnet die Funktion die Höhe, bei der die Reihe genau die Containerbreite füllt. Sinkt diese Höhe auf oder unter die Zielhöhe, vergleicht sie zwei Möglichkeiten:
- Die Reihe mit dem aktuellen Bild abschließen.
- Die Reihe ohne das Bild abschließen, es rutscht in die nächste Reihe.
Gewählt wird, was näher an der Zielhöhe liegt. So gibt es weder riesige Einzelbilder noch gequetschte Mini-Reihen. Die letzte, unvollständige Reihe bleibt linksbündig auf Zielhöhe. Drei Querformate auf 1500 px gestreckt sehen einfach lächerlich aus.
computeLayout() ist deterministisch, greift nicht aufs DOM zu und hat keine Seiteneffekte. Das Ergebnis lässt sich leicht memoizen, und die Funktion läuft auch in einem Web Worker.
Im Vergleich zu Flickrs Paket
| dieses Paket (Kern) | flickr/justified-layout | |
|---|---|---|
| Größe | ~120 LOC, ~1 kB min+gz | ~10 kB minified, ~2,5 kB gz |
| Modul-Format | nur ESM | UMD (Node-Stil) |
| Dependencies | 0 | 0 |
| TypeScript-Typen | mitgeliefert | DefinitelyTyped, oft veraltet |
| Astro-Komponente | mitgeliefert | keine |
| Letztes Release | v0.6.0 (April 2026) | v4.1.0 (Januar 2021) |
Die Zahlen zu Flickrs Paket stammen aus Version 4.1.0, wie sie auf npm liegt.1
exifr und sharp sind optionale Peer-Dependencies. Wenn du keine Metadaten und keine LQIPs brauchst, installierst du sie nicht. Fehlt ein Peer, fällt das Feature still weg, ohne Absturz.
Warum meine eigene Seite es noch nicht nutzte
Die ehrliche Antwort damals: irgendwann ja, im Moment nein. Die Foto-Sektion hatte über die Zeit eine eigene Logik bekommen. Ein hierarchischer Foto-Baum mit einer index.md pro Set und vorab erzeugte JSON-Sidecars mit EXIF, IPTC und GPS. Dazu mehrsprachige Titel pro Foto, sprachabhängige URL-Segmente sowie Statistik- und Weltkarten-Ansichten auf dieser Datenform. galleryLoader() erwartet eine flache Sammlung mit anderem EXIF-Schema und kennt keine Lokalisierung. Hätte ich ihn einfach eingesetzt, wäre die halbe Seite kaputt gewesen.
Der größere Bruch war der Workflow. Das Paket liest Tags, Titel, Beschreibung und GPS direkt aus der Bilddatei und nicht aus getrennten JSON-Sidecars. Die Fotos brauchen deshalb vor dem Export Pflege in Lightroom oder einem anderen DAM. Die IPTC-Felder Title, Description und Keywords müssen gefüllt sein, und das Export-Preset muss IPTC und GPS im JPG lassen. Sonst stehen die Felder beim Auslesen leer.
Der Vorteil: keine zweite Datenquelle, jedes Foto trägt seine Metadaten selbst. Der Nachteil: Die vorhandenen JSON-Dateien müssten zurück in die Bilder geschrieben werden, oder der Loader bräuchte einen Hybrid-Modus, der beides liest. Ich hatte vor, erst beim nächsten größeren Umbau des Foto-Stacks umzusteigen. Dazu gehören sauber gepflegte IPTC-Felder in Lightroom, gemappte Datenstrukturen, eine Schicht für die Set-Hierarchie und eine Übersetzung für GPS- und Kameradaten. Später habe ich die Layout-Funktion allein umgezogen: justified-layout durch mein eigenes Paket ersetzen.
Installation
Version 0.6.0, MIT-Lizenz, auf npm:
npm install @altner/astro-justified-gallery-layout
Der Quellcode liegt im Monorepo auf GitHub, Issues und Wünsche gehen in den Tracker.
Mehr dazu
- Thema
-
- Statische Website Eine Website aus fertigen HTML-Dateien, die einmal gebaut und dann unverändert ausgeliefert werden. Kein Servercode, keine Datenbank.
- Grundlage für
-
- justified-layout durch mein eigenes Paket ersetzen Wie meine alte Seite Flickrs verwaistes justified-layout gegen computeLayout() aus meinem eigenen Paket tauschte, ohne den Foto-Baum anzufassen.
- Schlagwörter