devIndicators
devIndicators
は、開発中に表示している現在のルートに関するコンテキストを提供する、画面上のインジケーターを設定するために使用できます。
型
devIndicators: false | {
position?: 'bottom-right'
| 'bottom-left'
| 'top-right'
| 'top-left', // defaults to 'bottom-left',
},
devIndicators
を false
に設定すると、インジケーターは非表示になりますが、Next.js は発生したビルドエラーやランタイムエラーを引き続き表示します。
トラブルシューティング
インジケーターがルートを静的としてマークしない場合
ルートが静的であると期待しているにもかかわらず、インジケーターがそれを動的とマークしている場合、そのルートは静的レンダリングからオプトアウトしている可能性があります。
next build --debug
を使用してアプリケーションをビルドし、ターミナルで出力を確認することで、ルートが静的か動的かを確認できます。静的(またはプリレンダリングされた)ルートは ○
シンボルを表示し、動的ルートは ƒ
シンボルを表示します。例:
ビルド出力
Route (app) Size First Load JS
┌ ○ /_not-found 0 B 0 kB
└ ƒ /products/[id] 0 B 0 kB
○ (Static) prerendered as static content
ƒ (Dynamic) server-rendered on demand
ルートが静的レンダリングからオプトアウトする理由は2つあります
- ランタイム情報に依存する動的APIの存在。
- ORMやデータベースドライバへの呼び出しなど、キャッシュされていないデータリクエスト。
これらの条件のいずれかに該当するか、ルートを確認してください。ルートを静的にレンダリングできない場合は、loading.js
または <Suspense />
を使用してストリーミングを活用することを検討してください。
バージョン履歴
バージョン | 変更点 |
---|---|
v15.2.0 | 新しい position オプションで画面上のインジケーターを改善。appIsrStatus 、buildActivity 、buildActivityPosition オプションは非推奨となりました。 |
v15.0.0 | appIsrStatus オプションで静的画面インジケーターを追加。 |
お役に立ちましたか?