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.
Geprüft von adrian
am
Im April hatte ich @altner/astro-justified-gallery-layout veröffentlicht und am Ende ehrlich zugegeben: Meine eigene Seite nutzt das Paket nicht. Der Fotobereich hatte einen eigenen hierarchischen Verzeichnisbaum, JSON-Sidecars mit EXIF, IPTC und GPS und mehrsprachige Titel pro Foto. Nichts davon passte zu dem, was galleryLoader() und <JustifiedGallery /> erwarten. Die komplette Komponente einzubauen hätte geheißen, den halben Foto-Stack um ein neues Datenmodell herum umzubauen, nur für ein Galerie-Raster.
Die Begründung stimmte weiterhin. Beim Blick in astro.config.mjs wegen etwas ganz anderem fiel mir aber auf, dass die Seite immer noch Flickrs justified-layout zog. Genau das Paket, das meins ersetzen sollte: seit 2021 ohne Pflege, CommonJS mit UMD-Build für den Browser. Und das für eine einzige Sache, nämlich Boxpositionen aus einem Array von Seitenverhältnissen zu berechnen.
Dieser Teil hing nie an meinem Datenmodell. galleryLoader() und die beiden fertigen Komponenten sind auf Astros Content Layer ausgelegt, aber computeLayout() weiß nichts davon. Zahlen rein, Zahlen raus.
Die drei Stellen im Code
Drei Komponenten liefen nach demselben Muster: im Browser ein Justified-Raster berechnen, <button>- oder <figure>-Elemente absolut positionieren, auf dem Handy das Layout überspringen.
PhotosDetailPage.astrofür Foto-Sets und AlbenPhotosTagDetailPage.astrofür Tag-DetailseitenPhotoSet.astrofür Galerien mitten in Blogposts
Alle drei hatten denselben Kern.
// vorher
import justifiedLayout from 'justified-layout';
const result = justifiedLayout(aspects, {
containerWidth: container.clientWidth,
targetRowHeight: 380,
boxSpacing: 6,
containerPadding: 0,
});
container.style.height = `${result.containerHeight}px`;
// nachher
import { computeLayout } from '@altner/astro-justified-gallery-layout';
const result = computeLayout(
aspects.map((a) => ({ w: a, h: 1 })),
{ containerWidth: container.clientWidth, targetRowHeight: 380, gap: 6 },
);
container.style.height = `${result.totalHeight}px`;
Was sich an der API geändert hat
computeLayout()nimmt{ w, h }-Paare statt nackter Seitenverhältnisse. Es zählt nur das Verhältnis, also trägt{ w: aspect, h: 1 }dieselbe Information wie vorher das Array.- Aus
boxSpacingwurdegap. containerPaddingfällt weg. Der Standardwert injustified-layoutist10, meine Aufrufe setzten aber ausdrücklich0, praktisch ändert sich also nichts.1- Aus
containerHeightim Ergebnis wurdetotalHeight.
Alles danach lief unverändert weiter, also das Auslesen von result.boxes[i].top/left/width/height, um jedes Element zu positionieren. An der Form einer Box hat sich nichts geändert.
Warum der Aufwand für drei Stellen
Die Galerie sah danach genauso aus wie vorher. Das war kein Feature, sondern ein Tausch der Dependency. Raus ging ein Paket ohne Release seit Januar 2021, rein kam eines ohne Runtime-Dependencies, nur ESM, mit mitgelieferten TypeScript-Typen. Außerdem nutzte ich jetzt mein eigenes Paket an einer Stelle, wo ich aus Gewohnheit zu einem fremden gegriffen hatte. Ein seltsamer Moment im eigenen Projekt, aber so war es.
Die große Integration blieb weiter aus: galleryLoader(), die i18n-fähige Content-Pipeline, ein gemeinsames Metadaten-Schema für die JSON-Sidecars der Seite und den IPTC-Ansatz des Pakets. Im Juli gab es dafür einen klareren Grund als im April. Die Seite lud Fotos absichtlich gar nicht über Astros Content Layer (mehr dazu in Warum der Foto-Baum keine Content Collection mehr ist). Eine Content Collection kann den deutschen und den englischen Titel eines Fotos nicht in einem Eintrag halten. galleryLoader() setzt aber eine Content Collection voraus, in die er lädt, und es gab keine. Die Layout-Mathematik hing nie am Content Layer, also gab es keinen Grund, mit ihr zu warten.
Zum Mitnehmen
- Eine Entscheidung „noch nicht migrieren“ betrifft meist die ganze Integration, nicht jede Funktion in der Dependency. Prüf, ob ein kleiner, abgeschlossener Teil allein umziehen kann.
- Reine Funktionen sind die kleinste mögliche Migrationsfläche: gleiche Eingaben, gleiche Form der Ausgabe, kein Zustand, keine Annahmen über die Architektur drumherum.
- Das eigene Paket auf der eigenen Seite einzusetzen findet Lücken, die ein Demo-Repository nicht findet. Diesmal keine: Die API funktionierte auf Anhieb an allen drei Stellen.
Beruht auf
-
Abschied von justified-layout, zumindest teilweise
(
raw/2026/2026-07-18/abschied-von-justified-layout-zumindest-teilweise.md) [post] - justified-layout 4.1.0 auf npm [npm]
Mehr dazu
Thema
- Statische Website Eine Website aus fertigen HTML-Dateien, die einmal gebaut und dann unverändert ausgeliefert werden. Kein Servercode, keine Datenbank.
Baut auf
- Astro Justified Gallery Layout Mein npm-Paket @altner/astro-justified-gallery-layout: eine schlanke Justified-Galerie für Astro mit EXIF, LQIP-Vorschauen, virtueller Variante und Lightbox.
Im Text erwähnt
- Warum der Foto-Baum keine Content Collection mehr ist Als meine alte Astro-Seite zweisprachig wurde, verließ der Foto-Baum den Content Layer: Jedes Foto braucht beide Sprachen in einer Datei.