BLOG /

React 19は loading 未指定のimgを勝手にpreloadする

React 19(Next.js 16含む)が、loading未指定のimgをpreloadに持ち上げる挙動の原因と、枚数・容量の確認コマンド、lazyの既定化やWebP化による回避策をまとめます。

手書きの preload も priority もないのに、本番 HTML の head に画像の preload が並ぶ。原因は React 19 の自動 preload で、loading を指定していない img 要素が対象になる。React 19 を使う Next.js でも同じ挙動になる。

対策は単純だ。画像の既定を loading="lazy" にそろえ、eager にするのは初期表示に入るものだけにする。装飾画像の preload は、ファーストビューに必要な数枚まで絞れる。

症状:書いていない preload が head に並ぶ

priority を付けた画像がロゴ1枚だけで、手書きの preload が1行もなくても、出力された HTML には画像の preload が大量に入ることがある。

中身は、ファーストビューと関係のないものになりやすい。

  • 破れ紙のような大判のテクスチャ
  • ページ下部のセクション見出し
  • フッター付近のテープや飾り

コラージュのように装飾画像を大量に並べるデザインでは、ここに帯域が使われる。LCP(Largest Contentful Paint)の要素と、同じ回線を取り合う形になる。画像が多く、モバイル回線の閲覧が中心のサイトほど、影響は大きい。

原因:loading 未指定の img を React 19 が preload に持ち上げる

React 19 の Float 機能は、レンダリングされる画像を「早く出したいもの」とみなす。SSR や静的出力の時点で、loading を指定していない img 要素を、head 内の link rel="preload" as="image" に変換する。

条件は単純だ。loading の指定がなければ持ち上がり、lazy が付いていれば除外される。同じコードベースに preload される画像とされない画像が混在していたら、まず loading 属性の有無を見る。

preload はブラウザが最優先で取りにいく。装飾が数枚なら目立たない。数十枚が並ぶ構成では、前提が崩れる。

厄介なのは、気づく機会がないことだ。実装者は preload を書いていない。ソースを読んでも、画面を見ても出てこない。出力された HTML を開くまで、存在すらわからない。

確かめ方:grep で枚数と合計バイト数を見る

静的出力なら、1コマンドで足りる。

grep -o '<link rel="preload" href="[^"]*"' out/index.html | grep -v woff2

フォントの preload(woff2)を除き、画像だけを残している。見る数字は2つ。行数(枚数)と、各ファイルを足した合計バイト数だ。

SSR のサイトなら、本番 URL を curl で取得して同じ grep にかける。URL が並んだら、ファイルサイズも確かめる。ファーストビューにない画像が上位に並んでいたら、この挙動を疑ってよい。

回避策:画像は既定 lazy、eager は初期表示だけ

方針は、既定を lazy にして、eager を例外にすることだ。eager にするのは、初期表示に入るものに限る。

  • ロゴ
  • ヒーロー画像
  • 下層ページ先頭の見出し

共通の画像コンポーネントに eager?: boolean を持たせ、呼び出し側で選ばせる。

type Props = { src: string; alt: string; eager?: boolean }

export function Img({ src, alt, eager = false }: Props) {
  return <img src={src} alt={alt} loading={eager ? 'eager' : 'lazy'} />
}

こうしておけば、付け忘れは起きにくい。忘れても lazy 側に倒れる。装飾が増えるたびに preload が増える、という事故も止まる。

落とし穴もある。ヒーロー画像まで lazy にすると、今度は LCP が遅れる。lazy は読み込みの開始を、画面に近づくまで待つ指定だからだ。ファーストビューの画像には、必ず eager を渡す設計にしておきたい。

ついでに効く:表示サイズに合う画像と WebP 変換

preload を整理すると、画像そのものの重さも目につく。

表示サイズに合わせる。 ヘッダーで小さく出すアイコンに、原寸の大きな版を読ませるのは典型的な無駄だ。表示サイズ相当の版に替えるだけで、転送量は桁で変わる。

output: 'export' では、next/image の最適化が効かない。images 設定で unoptimized: true が必要になるためだ。サイズ違いの画像は、手で用意するしかない。

テクスチャは WebP にする。 静的サイトの紙や写真系は、PNG より WebP のほうが軽くなりやすい。

cwebp -q 82 -alpha_q 95 -m 6 in.png -o out.webp

cwebp -lossless -z 9 in.png -o out.webp

すでに pngquant をかけた8bit PNG は、pngquant ではもう縮まない。そこで止めずに、WebP 変換まで進める。非可逆と可逆の両方を出力して、小さいほうを採ればよい。

自動 preload は便利な機能だが、装飾の多いデザインでは裏目に出る。loading を書くかどうかが、そのまま優先度の指定になっている。

似た地雷の記録は、/blog にも並べている。制作の相談は /contact から。