next/image без ошибок: AVIF и WebP, атрибут sizes и priority для LCP
Що робить next/image насправді
Компонент Image не стискає зображення під час складання. Він генерує <img> з атрибутами srcset та sizes, де кожен варіант веде на /_next/image?url=...&w=...&q=.... Оптимізатор на сервері при першому запиті ресайзує вихідний код під потрібну ширину, перекодує у формат, який підтримує браузер, і кешує результат.
З цього випливають три речі, які визначають, чи буде сторінка швидкою: якої ширини варіант вибере браузер (атрибут sizes), у якому форматі (налаштування formats) і коли почнеться завантаження (priority та lazy loading).
Формати: AVIF та WebP
За замовчуванням оптимізатор дає WebP. AVIF включається в конфігу:
// next.config.ts
import type { NextConfig } from "next";
const nextConfig: NextConfig = {
images: {
formats: ["image/avif", "image/webp"],
remotePatterns: [{ protocol: "https", hostname: "cdn.example.com", pathname: "/uploads/**" }],
minimumCacheTTL: 2678400, // 31 день, если исходники не меняются по тому же URL
},
};
export default nextConfig;Порядок важливий: браузер, який приймає AVIF, отримає його, інші WebP. AVIF при тому ж візуальному якості зазвичай менше, але кодується помітно довше. Перший запит кожного варіанта буде повільнішим, далі працює кеш. На сайтах із тисячами унікальних зображень та маленьким кешем це може стати проблемою – тоді розумно залишитися на WebP.
remotePatterns обмежує, які зовнішні зображення оптимізатор погодиться обробляти. Занадто широкий шаблон (будь-який хост) перетворює ваш сервер на безкоштовний ресайзер для чужих картинок.
sizes: найчастіша помилка
Без sizes для зображення з фіксованою шириною Next.js генерує варіанти 1x та 2x. З fill або адаптивною версткою потрібно sizes, інакше браузер вважає, що картинка займає всю ширину вікна, і на широкому моніторі завантажить варіант в 1920-3840 пікселів для картки шириною 300.
Картки в сітці: на телефоні в одну колонку, на планшеті в дві, на десктопі в три з обмеженням ширини контейнера:
import Image from "next/image";
export function PostCard({ post }: { post: { cover: string; title: string } }) {
return (
<article className="card">
<div className="relative aspect-[16/9]">
<Image
src={post.cover}
alt=""
fill
sizes="(max-width: 640px) 100vw, (max-width: 1024px) 50vw, 380px"
className="object-cover"
/>
</div>
<h3>{post.title}</h3>
</article>
);
}sizes описує реальну ширину відтворення зображення в CSS-пікселях, а не ширину файлу. Останнє значення без умови - для решти випадків. Щільність екрана браузер враховує сам.
alt="" тут свідомо: декоративна обкладинка, заголовок поруч. Для змістовних зображень потрібний осмислений текст.
У fill дві вимоги: батько з position: relative (або absolute/fixed) та заданий розмір. Інакше картинка розтягнеться непередбачувано або зникне в нуль.
LCP-картинка та priority
Зображення в next/image за замовчуванням завантажуються ліниво (loading="lazy"). Для зображення, яке видно на першому екрані і є елементом LCP, це шкідливо: браузер почне його завантаження лише після розмітки сторінки.
import hero from "@/public/hero.jpg";
<Image
src={hero}
alt="Панель аналитики с графиком продаж"
priority
sizes="100vw"
placeholder="blur"
className="h-auto w-full"
/>priority вимикає ліниве завантаження, ставить fetchpriority="high" і додає попереднє завантаження. Ставте його одному-двох зображень першого екрану, не всім: якщо пріоритетні всі, не пріоритетний ніхто. У Next.js 16 замість priority введено властивість preload, у 15 використовується priority.
Статичний імпорт (import hero from ...) дає Next.js розміри файлу і вбудовує розмите прев'ю для placeholder="blur". Для віддалених зображень розміри потрібно вказати самим через width та height, інакше буде зсув макета (CLS).
Як перевірити, що працює
- Який файл реально завантажено. У консолі браузера:
document.querySelector('img[alt^="Панель"]').currentSrc— в URL видно ширинуw=. У Network відфільтруйте Img і перевірте колонку Type:avifабоwebp. - Який елемент LCP. DevTools → Performance → запис завантаження → маркер LCP покаже елемент. Якщо це картинка без
priority- ось і проблема. - Lighthouse попереджає "Properly size images", якщо завантажений варіант помітно більше відображуваного. У більшості випадків це неправильний
sizes.
Типові помилки
sizes="100vw"на маленьких картках «про всяк випадок».priorityна зображенні, яке нижче першого екрана, - воно забирає канал у справжнього LCP.unoptimizedглобально через помилку на одному зображенні. Краще розібратися зremotePatterns.- Великі вихідники (6000 пікселів, 10 МБ) в
public. Оптимізатор впорається, але перший запит кожного варіанта буде повільним та навантажить сервер. - Self-hosted у контейнері без прав на запис
.next/cache— оптимізовані варіанти не кешуються і перераховуються на кожен запит.
Коли next/image не потрібний
SVG-іконки та логотипи вигідніше вставляти як SVG: растрова оптимізація їм не потрібна. Якщо зображення вже обробляє CDN з ресайзом URL (Cloudinary, imgproxy), підключіть його через loader, а не тримайте два оптимізатори. І на Vercel враховуйте, що оптимізація зображень входить до лімітів тарифу.