Menu

画像とフォントの最適化方法

Next.jsには、パフォーマンスとユーザー体験を向上させるための自動的な画像とフォントの最適化機能が組み込まれています。このページでは、これらの機能の使い方をご案内します。

静的アセットの取り扱い

画像やフォントなどの静的ファイルは、ルートディレクトリにあるpublicというフォルダに保存できます。public内のファイルは、ベースURL（/）から始まるパスでコード内から参照できます。

appとpublicフォルダを示すフォルダ構造

画像の最適化

Next.jsの<Image>コンポーネントはHTML <img>要素を拡張し、以下の機能を提供します：

  • サイズ最適化： 各デバイスに対して自動的に適切なサイズの画像を提供し、WebPなどの最新の画像フォーマットを使用します。
  • 視覚的安定性： 画像の読み込み時にレイアウトシフトが発生するのを自動的に防ぎます。
  • 高速なページ読み込み： ネイティブブラウザの遅延読み込みを使用して、ビューポートに入ったときにのみ画像を読み込み、オプションでぼかしプレースホルダを表示します。
  • アセットの柔軟性： リモートサーバーに保存されている画像も含め、オンデマンドで画像をリサイズします。

<Image>を使い始めるには、next/imageからインポートし、コンポーネント内でレンダリングします。

app/page.tsx
TypeScript
import Image from 'next/image'
 
export default function Page() {
  return <Image src="" alt="" />
}

srcプロパティにはローカル画像またはリモート画像を指定できます。

ローカル画像

ローカル画像を使用するには、publicフォルダから.jpg、.png、または.webp画像ファイルをimportします。

app/page.tsx
TypeScript
import Image from 'next/image'
import profilePic from './me.png'
 
export default function Page() {
  return (
    <Image
      src={profilePic}
      alt="作者の写真"
      // width={500} 自動的に提供されます
      // height={500} 自動的に提供されます
      // blurDataURL="data:..." 自動的に提供されます
      // placeholder="blur" // オプションで読み込み中にぼかし効果
    />
  )
}

Next.jsはインポートされたファイルに基づいて、画像の固有のwidthとheightを自動的に決定します。これらの値は画像の比率を決定し、画像の読み込み中に累積レイアウトシフトが発生するのを防ぐために使用されます。

リモート画像

リモート画像を使用するには、srcプロパティにURL文字列を指定します。

app/page.tsx
TypeScript
import Image from 'next/image'
 
export default function Page() {
  return (
    <Image
      src="https://s3.amazonaws.com/my-bucket/profile.png"
      alt="作者の写真"
      width={500}
      height={500}
    />
  )
}

Next.jsはビルドプロセス中にリモートファイルにアクセスできないため、width、height、およびオプションのblurDataURLプロパティを手動で指定する必要があります。widthとheight属性は画像の正確なアスペクト比を推測し、画像の読み込みによるレイアウトシフトを防ぐために使用されます。

次に、リモートサーバーからの画像を安全に許可するために、next.config.jsでサポートするURLパターンのリストを定義する必要があります。悪意のある使用を防ぐために、できるだけ具体的に指定してください。たとえば、次の設定では特定のAWS S3バケットからの画像のみを許可します：

next.config.ts
TypeScript
import { NextConfig } from 'next'
 
const config: NextConfig = {
  images: {
    remotePatterns: [
      {
        protocol: 'https',
        hostname: 's3.amazonaws.com',
        port: '',
        pathname: '/my-bucket/**',
        search: '',
      },
    ],
  },
}
 
export default config

フォントの最適化

next/fontモジュールは自動的にフォントを最適化し、プライバシーとパフォーマンスを向上させるために外部ネットワークリクエストを削除します。

これには_あらゆる_フォントファイルに対する組み込みの自動セルフホスティングが含まれています。これにより、レイアウトシフトなしでWebフォントを最適に読み込むことができます。

next/fontを使い始めるには、next/font/localまたはnext/font/googleからインポートし、適切なオプションを指定して関数として呼び出し、フォントを適用したい要素のclassNameを設定します。例えば：

app/layout.tsx
TypeScript
import { Geist } from 'next/font/google'
 
const geist = Geist({
  subsets: ['latin'],
})
 
export default function Layout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="en" className={geist.className}>
      <body>{children}</body>
    </html>
  )
}

Googleフォント

任意のGoogleフォントを自動的にセルフホスティングできます。フォントはデプロイメントに含まれ、デプロイメントと同じドメインから提供されるため、ユーザーがサイトを訪問してもブラウザからGoogleにリクエストは送信されません。

Googleフォントを使い始めるには、next/font/googleから選択したフォントをインポートします：

app/layout.tsx
TypeScript
import { Geist } from 'next/font/google'
 
const geist = Geist({
  subsets: ['latin'],
})
 
export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en" className={geist.className}>
      <body>{children}</body>
    </html>
  )
}

最高のパフォーマンスと柔軟性のために可変フォントを使用することをお勧めします。ただし、可変フォントを使用できない場合は、ウェイトを指定する必要があります：

app/layout.tsx
TypeScript
import { Roboto } from 'next/font/google'
 
const roboto = Roboto({
  weight: '400',
  subsets: ['latin'],
})
 
export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en" className={roboto.className}>
      <body>{children}</body>
    </html>
  )
}

ローカルフォント

ローカルフォントを使用するには、next/font/localからフォントをインポートし、publicフォルダにあるローカルフォントファイルのsrcを指定します。

app/layout.tsx
TypeScript
import localFont from 'next/font/local'
 
const myFont = localFont({
  src: './my-font.woff2',
})
 
export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en" className={myFont.className}>
      <body>{children}</body>
    </html>
  )
}

単一のフォントファミリーに複数のファイルを使用する場合、srcは配列にすることができます：

const roboto = localFont({
  src: [
    {
      path: './Roboto-Regular.woff2',
      weight: '400',
      style: 'normal',
    },
    {
      path: './Roboto-Italic.woff2',
      weight: '400',
      style: 'italic',
    },
    {
      path: './Roboto-Bold.woff2',
      weight: '700',
      style: 'normal',
    },
    {
      path: './Roboto-BoldItalic.woff2',
      weight: '700',
      style: 'italic',
    },
  ],
})

API リファレンス

このページで説明された機能について詳しく知るには、API リファレンスをご覧ください。

フォント

組み込みの `next/font` ローダーを使用したウェブフォントの読み込み最適化。

Image

組み込みの `next/image` コンポーネントを使用してNext.jsアプリケーションで画像を最適化します。