Kategoria: Next.js, React i TypeScript

Next.js Image fill bez sizes pobiera za duży plik

Poradnik techniczny · Kacper Bernecki

Na telefonie grafika zajmuje mały fragment ekranu, ale przeglądarka pobiera szeroki obraz przeznaczony na desktop. Komponent Image z fill bez odpowiedniego sizes może pozwolić przeglądarce wybrać nieoptymalny wariant obrazu.

Jak rozpoznać źródło problemu

Sprawdź fizyczne rozmiary widocznego obrazu w różnych breakpointach i jego downloaded size w Network. Odczytaj wygenerowane srcset i sizes oraz sprawdź raport Largest Contentful Paint dla strony.

Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.

Kroki naprawcze

Dodaj sizes opisujące rzeczywistą szerokość kontenera, np. 100vw na mobile i część szerokości na desktopie. Przy fill ustaw rodzicowi position: relative oraz znany wymiar lub aspect-ratio, aby layout nie zapadał się.

Jak przetestować rozwiązanie

Przeglądarka wybiera wariant obrazu dopasowany do viewportu, bez niepotrzebnego transferu na telefonie.

Bezpieczeństwo i ograniczenia

Nie ustawiaj sizes="100vw" dla miniatury zajmującej 20% szerokości desktopu.