React で LCP を悪化させずに画像を遅延読み込みするには
React で画像を遅延読み込みするには、通常の img 要素に
loading="lazy" を指定してレンダリングします。実際の URL は
src に保持し、レスポンシブ画像の候補がある場合は
srcSet と sizes を追加します。ブラウザーが表示領域を確保できるよう、width と
height も指定します。
重要な例外は、そのページの Largest Contentful Paint(LCP)要素になりそうな画像です。その画像は即時読み込みにし、初期 HTML から検出できるようにします。遅延読み込みにすると、ページで最も早く完了させたいリクエストが遅れてしまいます。
| 画像の役割 | 読み込み方針 | その他の重要なマークアップ |
|---|---|---|
| ヒーロー画像または LCP になりそうな画像 | 即時読み込み | 検証済みの場合に fetchPriority="high" |
| 初期ビューポート内のその他の画像 | 即時読み込み | 寸法とレスポンシブ画像のソース |
| 画面外にある通常のコンテンツ画像 | 遅延読み込み | src、srcSet、sizes、寸法 |
| 装飾用の CSS 背景 | 別の仕組み | 意味のある img コンテンツの代わりにしない |
「スクロールせずに見える範囲」は、画像の順番だけでは決まりません。ビューポートの高さ、レスポンシブレイアウト、バナー、ローカライズされたコンテンツによって、同じ画像でも初期ビューポートの内側に入る場合と外側になる場合があります。レンダリング後のページを基準に画像を分類し、代表的な画面サイズで判断を検証します。
React のネイティブな loading プロパティの使用
React は loading プロパティをブラウザーのネイティブ画像要素に渡します。画面外にある通常の画像には、エフェクト、スクロールハンドラー、Intersection Observer ライブラリは必要ありません。
以下のローカルプレビューでは、サーバーで React をレンダリングし、完全な画像マークアップをブラウザーに送信します。コンポーネントは、既存のサーバーレンダリング対応 React アプリケーションでも再利用できます。プレビューには Node.js と、別途インストールした Corepack が必要です。メンテナンス中の Node.js リリースを使用してください。このプレビューは Node.js 24.15.0 と 26.8.1、Yarn 4.12.0、React 19.2.6、Chrome 151 でテストしました。これらはテスト済みのバージョンであり、ネイティブ画像読み込み自体の最小要件ではありません。コマンドは POSIX シェルを使用します。
空の react-image-preview ディレクトリを新規作成し、そこでターミナルを開きます。package.json を保存します。
{
"name": "react-image-preview",
"private": true,
"type": "module",
"packageManager": "yarn@4.12.0",
"dependencies": {
"react": "19.2.6",
"react-dom": "19.2.6"
},
"devDependencies": {
"esbuild": "0.27.0"
}
}
ローカルの依存関係を選択し、上位プロジェクトの Yarn 実行ファイルを無視するため、.yarnrc.yml を保存します。
nodeLinker: node-modules
enableGlobalCache: false
ignorePath: true
Yarn がこのディレクトリを独立したプロジェクトとして扱うよう、インストール前にロックファイルで境界を作成します。
touch yarn.lock && corepack yarn install
インストールに失敗した場合は、報告されたネットワークまたはパッケージマネージャーの問題を解決し、同じディレクトリでそのコマンドを再実行します。ソースファイルは削除しないでください。
images ディレクトリを作成し、自分の写真から用意した以下の四つの
WebP ファイルを配置します。各ペアは同じ切り抜きにする必要があります。srcSet の幅は、ファイルの実際のピクセル幅と一致させてください。代替テキストも、用意した写真を説明する内容に変更します。
| ファイル | ピクセル寸法 | 役割 |
|---|---|---|
images/harbor-640.webp | 640×360 | ヒーロー画像の小サイズ候補 |
images/harbor-1280.webp | 1280×720 | 大サイズのヒーロー画像兼フォールバック |
images/workshop-480.webp | 480×320 | コンテンツ画像の小サイズ候補 |
images/workshop-960.webp | 960×640 | 大サイズのコンテンツ画像兼フォールバック |
このコンポーネントを ResponsiveImage.tsx として保存します。
import type { ReactNode } from 'react'
interface ResponsiveImageProps {
alt: string
height: number
sizes: string
src: string
srcSet: string
width: number
}
export function ResponsiveImage({
alt,
height,
sizes,
src,
srcSet,
width,
}: ResponsiveImageProps): ReactNode {
return (
<img
className="responsive-image"
src={src}
srcSet={srcSet}
sizes={sizes}
width={width}
height={height}
loading="lazy"
decoding="async"
alt={alt}
/>
)
}
実際の画像 URL は src に保持してください。唯一の URL をカスタムの data-src 属性に移すと、リクエストが JavaScript に依存し、ブラウザーのプリロードスキャナーが通常の画像マークアップから検出できなくなります。スクリプトが失敗した場合も、画像は読み込まれません。
decoding="async" プロパティは、デコードに関する独立したヒントです。ネットワークリクエストの開始時期を決めるものではなく、loading="lazy" の代わりにもなりません。
ImagePage.tsx を保存します。大きなスペーサーは、この読み込み実験でワークショップの画像を初期ビューポートから十分に離すためのものです。アプリケーションにそのまま取り入れるためのレイアウトではありません。
import type { ReactNode } from 'react'
import { HeroImage } from './HeroImage.tsx'
import { ResponsiveImage } from './ResponsiveImage.tsx'
export function ImagePage(): ReactNode {
return (
<main>
<h1>React image preview</h1>
<section className="hero-column">
<HeroImage />
<p>The harbor photo loads with the page.</p>
</section>
<section className="demo-spacer">
<p>Scroll to the workshop photo.</p>
</section>
<section className="image-column">
<ResponsiveImage
src="/images/workshop-960.webp"
srcSet="/images/workshop-480.webp 480w, /images/workshop-960.webp 960w"
sizes="(max-width: 40rem) 100vw, 40rem"
width={960}
height={640}
alt="A technician calibrating a camera rig"
/>
<p>The workshop photo keeps this caption in place while it loads.</p>
</section>
</main>
)
}
遅延読み込みが変更するのは、リクエストの開始時期だけです。画像のリサイズ、圧縮、変換、キャッシュ、説明の追加は行いません。
LCP 画像の即時読み込みを維持
LCP になりそうな画像に loading="lazy" を適用しないでください。React フレームワークがサーバーレンダリングに対応している場合は、その URL を初期 HTML に出力します。これにより、クライアント側のレンダリングや追加のデータリクエストを待たずに、ブラウザーが検出できます。
HeroImage.tsx を保存します。
import type { ReactNode } from 'react'
export function HeroImage(): ReactNode {
return (
<img
className="responsive-image"
src="/images/harbor-1280.webp"
srcSet="/images/harbor-640.webp 640w, /images/harbor-1280.webp 1280w"
sizes="(max-width: 80rem) 100vw, 80rem"
width={1280}
height={720}
loading="eager"
fetchPriority="high"
alt="Fishing boats returning to the harbor at sunrise"
/>
)
}
fetchPriority="high" は相対的な優先度のヒントであり、リクエスト順序を保証しません。測定で特定した LCP 画像だけに使用してください。複数の画像を高優先度にすると、どれが最も重要かを判断するための情報がブラウザーにとって有用でなくなります。
React 19 は、サーバーレンダリング時に画像のプリロードを自動出力することもあります。手動のプリロードを追加する前に、生成された HTML を確認してください。条件は React の画像ドキュメントに記載されています。プリロードには、画像と同じレスポンシブ候補とスロットサイズを使用する必要があります。
画像がモバイルでは LCP 要素になり、デスクトップではならない場合も、その逆もあります。大きな画像やカルーセルのスライドがすべて重要だと決めつけず、フィールドパフォーマンスデータを使って、実際の訪問者にとってどの要素が LCP になるかを確認します。
遅延読み込みとレスポンシブ画像の併用
リクエストを遅らせても、不要に大きなファイルをダウンロードしてしまうことはあります。480w のような幅記述子を使う場合、srcSet が候補ファイルを提供し、sizes がレンダリングされるスロットの幅を記述します。ブラウザーはこの情報とデバイスのピクセル密度を組み合わせて候補を選びます。
sizes はソースファイルではなく、レイアウトに合わせて記述します。このプレビューでは、ワークショップの写真は最大 40rem のカラム幅まで、ヒーロー画像は最大 80rem までビューポート幅いっぱいに表示されます。以下の CSS で実際にその上限を設定します。プレビューのルートフォントは 16 ピクセルなので、それぞれ 640 CSS ピクセルと 1,280 CSS ピクセルになります。アプリケーションにパディングやより狭いコンテナーがある場合は、それに応じて
sizes の値も小さくする必要があります。
ブラウザーは、即時読み込みと遅延読み込みの画像で同じレスポンシブ候補選択を行います。どちらの読み込み方針でも、正しい候補と正確な sizes 値が必要です。ブラウザーはキャッシュ済みの大きな候補を再利用する場合があり、高密度の画面では、これら二つの候補より多くのピクセルが必要になることもあります。一つのファイル名があらゆる環境で選ばれると考えず、空のキャッシュで
currentSrc を確認してください。スロットサイズの計算は、レスポンシブ画像を参照してください。
表示領域の確保によるレイアウトシフトの防止
すべてのコンテンツ画像に width と
height を指定します。ブラウザーはこれらの属性から、画像のダウンロード前にアスペクト比を計算し、適切なレイアウト領域を確保します。CSS で画像を可変サイズにすることは引き続き可能です。preview.css を保存します。
html {
font-size: 16px;
color-scheme: light dark;
}
body {
margin: 0;
}
.responsive-image {
display: block;
width: 100%;
height: auto;
}
.hero-column {
max-width: 80rem;
margin-inline: auto;
}
.image-column {
max-width: 40rem;
margin-inline: auto;
}
.demo-spacer {
min-height: 6000px;
}
属性は、画像本来のアスペクト比を表す必要があります。たとえば、img では、すべての候補が 3:2 の比率なら、width={960} と height={640} を使用できます。これは、ブラウザーが 480×320 のファイルを選択した場合も同じです。アートディレクション用のソースで切り抜きやアスペクト比が異なる場合、寸法は無関係なフォールバックではなく、選択されるソースを表す必要があります。
画像領域の確保で防げるのは Cumulative Layout Shift(CLS)の原因の一つであり、あらゆるシフトではありません。キャプション、広告、同意設定のコントロール、フォント、エラーメッセージによってページが動く可能性は残ります。
サーバーレンダリングのプレビューの実行
preview.tsx を保存します。このサーバーは、ループバックインターフェイス上で、このページと既知の四つのファイルだけを配信します。起動時にファイルを読み込むため、写真やスタイルシートが見つからなければ、利用可能な URL を表示する前にプレビューが停止します。この静的プレビューには、ハイドレーションや本番デプロイの設定はありません。
import { readFile } from 'node:fs/promises'
import { createServer } from 'node:http'
import { renderToStaticMarkup } from 'react-dom/server'
import { ImagePage } from './ImagePage.tsx'
async function main(): Promise<void> {
const images = new Map<string, Buffer>()
for (const name of [
'harbor-640.webp',
'harbor-1280.webp',
'workshop-480.webp',
'workshop-960.webp',
]) {
images.set(`/images/${name}`, await readFile(new URL(`./images/${name}`, import.meta.url)))
}
const css = await readFile(new URL('./preview.css', import.meta.url), 'utf8')
const html = '<!doctype html>' + renderToStaticMarkup(
<html lang="en">
<head>
<meta charSet="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>React image preview</title>
<style>{css}</style>
</head>
<body><ImagePage /></body>
</html>,
)
const port = Number(process.env.PORT ?? 4173)
if (!Number.isInteger(port) || port < 0 || port > 65535) {
throw new Error('PORT must be an integer between 0 and 65535')
}
const server = createServer((request, response) => {
response.setHeader('Cache-Control', 'no-store')
const image = images.get(request.url ?? '')
if (image) {
response.writeHead(200, { 'Content-Type': 'image/webp' })
response.end(image)
} else if (request.url === '/') {
response.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
response.end(html)
} else {
response.writeHead(404)
response.end('Not found')
}
})
server.on('error', (error) => {
console.error(`Could not start image preview: ${error.message}`)
process.exitCode = 1
})
process.once('SIGINT', () => { server.close() })
server.listen(port, '127.0.0.1', () => {
const address = server.address()
if (address && typeof address !== 'string') {
console.log(`Image preview: http://127.0.0.1:${address.port}/`)
}
})
}
main().catch((error: unknown) => {
console.error(error)
process.exitCode = 1
})
プレビューのディレクトリでビルドして実行します。空の --tsconfig-raw 設定により、上位プロジェクトの TypeScript 設定がこのプレビューの JSX ランタイムを変更するのを防ぎます。生成済みの preview.mjs は置き換えられますが、写真は変更されません。&& は、ビルド失敗時に古い生成ファイルが起動するのを防ぎます。
corepack yarn exec esbuild preview.tsx --bundle --platform=node --format=esm --packages=external --jsx=automatic --tsconfig-raw='{}' --outfile=preview.mjs && node preview.mjs
表示された URL を開き、ワークショップの写真までスクロールします。サーバーを停止するには、同じターミナルで Ctrl+C を押します。起動時にファイルが見つからないと報告された場合は、名前や配置を修正し、ビルドと実行のコマンドを再実行します。ポート使用中のエラーが出た場合は、POSIX シェルで空いているポートを指定します。
PORT=0 node preview.mjs
サーバーが新しい URL を表示します。
Intersection Observer が適切な場合
通常の画像には、ブラウザーのネイティブな読み込み動作を使用します。Intersection Observer を使うのは、loading="lazy" では表せない動作がコンポーネントに必要な場合だけにしてください。たとえば、アニメーションの開始、可視性イベントの記録、ビューポートに入る少し前の負荷の高い装飾背景の適用などです。
その動作が本当に必要でない限り、オブザーバーの発火後にだけ通常のコンテンツ画像を条件付きでマウントすることは避けてください。条件付きマウントは検出を遅らせ、JavaScript の失敗経路を増やし、安定したフォールバックの設計も必要にします。意味のある画像には、有用な代替テキストを備えた img または
picture 要素を使い続けるべきです。
React.lazy() が解決するのは別の問題で、JavaScript コンポーネントモジュールの読み込みを遅らせます。そのコンポーネントがレンダリングする画像のリクエストを、自動で遅らせるものではありません。
Transloadit によるレスポンシブ派生画像の生成
遅延読み込みでは、大きすぎるソース画像自体は改善できません。実用的な配信パイプラインでは、少数に絞った幅の画像を生成し、それぞれを最適化して永続ストレージにエクスポートし、React のビューで使う URL と寸法を記録します。
Transloadit の /image/resize Robot は幅違いの画像を作成でき、/image/optimize Robot は対応形式を最適化できます。ページをレンダリングする前に派生画像を生成し、ストレージにエクスポートして、永続的な URL とともに実際の寸法を記録します。ソースが目標の幅より小さい場合、結果も小さくなることがあります。その URL に、実際には満たしていない幅記述子を付けないでください。ストレージ連携はファイルエクスポートサービスを、オンデマンド変換は Smart CDN を参照してください。
どの画像が意味を持つか、代替テキスト、表示スロットのサイズ、初期表示で重要かどうかといった表示上の判断は、引き続き React アプリケーションが担います。Transloadit はメディア処理段階を担当し、特定のページレイアウトでどの画像が LCP になるかは判断しません。
結果の測定
コンポーネントのソースだけに頼らず、本番ページを確認してください。
- 初期 HTML レスポンスを調べます。ヒーロー画像の
srcとsrcsetがすでに含まれているはずです。 - ブラウザーの開発者ツールで、空のキャッシュから狭いビューポートと広いビューポートの読み込みを記録します。ヒーロー画像のリクエストが、アプリケーションの JavaScript を待たずに、その HTML から始まることを確認します。
- プレビューの先頭で、遠くにあるワークショップの写真がまだリクエストされていないことを確認します。写真に向かってスクロールし、リクエストの開始を観察します。ネイティブの遅延読み込みでは、画像が見える前に取得が始まることがあります。
- 各画像の
currentSrcを調べ、その URL を開いてファイルのピクセル寸法を確認します。要素のnaturalWidthは、ピクセル密度で補正されている場合があります。選択されたファイルを、表示スロットとデバイスピクセル比に照らして確認します。たとえば、このプレビューでは、空のキャッシュでピクセル比が 1 の Chrome は、390 ピクセルのビューポートで 480 ピクセルのワークショップ画像を選び、デスクトップの 640 ピクセルのカラムでは 960 ピクセルのファイルを選びました。 - 画像レスポンスを遅らせ、読み込み前後の画像ボックスとキャプションの位置を比較します。リクエストをブロックし、失敗時の代替テキストと確保された領域も確認します。
これらの確認でわかるのは、ローカルページでの検出、選択、レイアウトの動作です。訪問者にとって LCP が改善した証明にはなりません。アプリケーションで実際の LCP 要素を特定し、ページテンプレートと関連するビューポートで分類したフィールドデータを使って LCP と CLS を測定します。web.dev の LCP ガイドでは、リソースの検出が読み込みの遅延にどう影響するかを説明しています。
ブラウザーの遅延読み込みの距離やスケジューリングは、実装によって異なります。「三番目の画像より後はすべて遅延読み込みにする」といったルールや、固定のピクセルしきい値を想定することは避けてください。ユーザーに実際に配信されるページとデバイスで測定します。
React の遅延読み込みでよくある間違い
- ヒーロー画像や、測定で特定した LCP 画像の遅延読み込み
- 唯一の画像 URL を
srcからdata-srcに移すこと - クライアント側のコードやデータリクエストの完了後にだけ重要な画像をレンダリングすること
- 正確な
sizes値を指定せずにsrcSetを指定すること - 最終的に CSS で画像サイズを制御するという理由で
widthとheightを省略すること - すべての画像に
fetchPriority="high"を指定すること - ブラウザーのネイティブ動作を再現するためだけのオブザーバーライブラリの使用
React.lazy()が画像のネットワークリクエストを制御するという思い込み- 適切な派生画像を生成せず、3,000 ピクセルのソースの読み込みを遅らせること
基盤となるブラウザーのルールは、HTML の遅延読み込み標準を参照してください。スクリプトが無効な場合、ブラウザーはこれらのネイティブな遅延読み込み画像を即時に読み込みます。実際の URL をマークアップに保持しておけば、その場合もコンテンツを読み込めます。
