Metadata Files API Reference
このセクションでは、メタデータファイルの規約について取り上げます。ファイルベースのメタデータは、特別なメタデータファイルをルートセグメントに追加することで定義できます。
各ファイルの規約は、静的ファイル(例:opengraph-image.jpg
)またはファイルの生成にコードを使用する動的なバリアント(例:opengraph-image.js
)を使用して定義できます。
ファイルが定義されると、Next.js は自動的にそのファイルを提供し(本番環境ではキャッシングのためにハッシュ付き)、関連するhead要素を正しいメタデータ、例えばアセットのURL、ファイルタイプ、画像サイズで更新します。
知っておくと役立つ情報:
sitemap.ts
,opengraph-image.tsx
,icon.tsx
などの特別な Route Handlers や、その他のメタデータファイル は デフォルトでキャッシュされますmiddleware.ts
と一緒に使用する場合は、メタデータファイルを除外するようにmatcher を設定します