Bildoptimierung
Regeln
- Verwende
next/image für alle Bilder in Next.js – automatische Optimierung, Lazy Loading, responsive srcsets
- Setze immer
width und height oder verwende fill mit einem dimensionierten Container – verhindert Layout-Verschiebungen (CLS)
- Unschärfe-Platzhalter: Generiere
blurDataURL zum Build-/Upload-Zeitpunkt mit plaiceholder oder verwende placeholder="blur" für statische Importe
- Remote-Bilder: Konfiguriere
remotePatterns in next.config.js – Whitelist für CDN-Domains
- Upload-Ablauf: Client → Presigned-URL (S3/R2/Supabase Storage) → direkter Upload → URL in Datenbank speichern
- Größenänderung beim Upload: Verwende
sharp serverseitig, um mehrere Größen zu erstellen (Thumbnail, Medium, Voll) – liefere keine Originale aus
- Formate: Serviere WebP/AVIF über
next/image-Auto-Format – Fallback auf JPEG für Kompatibilität
- CDN-Auslieferung: Speichere Originale im Objektspeicher (S3, R2), liefere über CDN (CloudFront, Cloudflare) mit Cache-Headern aus
- Dateigrößen-Validierung: Prüfe auf Client (vor dem Upload) und Server (vor der Verarbeitung) – typisches Limit: 5-10 MB
Muster
import Image from "next/image";
<Image
src="/hero.jpg"
alt="Hero-Bild"
width={1200}
height={630}
placeholder="blur"
blurDataURL="data:image/jpeg;base64,/9j/4AAQ..."
priority // oberhalb des Falzes
/>
<div className="relative aspect-video">
<Image src={url} alt={alt} fill className="object-cover" sizes="(max-width: 768px) 100vw, 50vw" />
</div>
import sharp from "sharp";
async function processUpload(buffer: Buffer) {
const thumbnail = await sharp(buffer).resize(200, 200, { fit: "cover" }).webp({ quality: 80 }).toBuffer();
const medium = await sharp(buffer).resize(800).webp({ quality: 85 }).toBuffer();
const full = await sharp(buffer).resize(1920).webp({ quality: 90 }).toBuffer();
return { thumbnail, medium, full };
}
Vermeiden
- Verwendung von
<img>-Tags in Next.js – verlierst automatische Optimierung, Lazy Loading und Formatkonvertierung
- Fehlendes
sizes-Attribut bei responsiven Bildern – Browser kann nicht die richtige srcset-Größe auswählen
- Auslieferung von unverkleinerten Originalen – ein 5 MB Foto, das mit 400px angezeigt wird, ist verschwenderisch
- Überspringen der Dateityp-Validierung – Prüfe den MIME-Typ serverseitig, nicht nur die Dateierweiterung