Skip to content

Commit 85f3c50

Browse files
authored
Merge pull request #215 from Nextjs-ja-translation/chore/automatic-static-optimization
Chore: Automatic Static Optimization の差分追従
2 parents 2f2f0ce + 85dad58 commit 85f3c50

File tree

1 file changed

+12
-4
lines changed

1 file changed

+12
-4
lines changed

docs/advanced-features/automatic-static-optimization.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,22 +21,30 @@ description: Next.js は可能であれば静的な HTML へとアプリケー
2121

2222
プリレンダリング中は、この段階で使用できる `query` の情報がないため、 `query` は空オブジェクトになります。ハイドレーション後は、 `query` オブジェクト内のルートパラメータをアプリケーションに与えるように、 Next.js がアプリケーションを更新します。
2323

24-
> **備考:** [動的なルーティング](/docs/routing/dynamic-routes.md)と共に [`getStaticProps`](/docs/basic-features/data-fetching.md#getstaticprops-static-generation) を用いたページに与えられたパラメータは、いつでも `query` オブジェクト内で使用可能です。
24+
ハイドレーションの後にクエリが更新され、さらにレンダリングが生じるケースは以下の通りです。
25+
26+
- ページが [dynamic-route](/docs/routing/dynamic-routes.md) である場合
27+
- ページが URL にクエリの値を持っている場合
28+
- `next.config.js`[Rewrites](/docs/api-reference/next.config.js/rewrites.md) が設定されている場合。これらは `query` として解析、提供されるべきパラメータを含み得るためです。
29+
30+
クエリが全て更新され使用可能な状態になったかどうか判断するためには、[`next/router`](/docs/api-reference/next/router.md#router-object) に存在する `isReady` フィールドを利用できます。
31+
32+
> **備考:** [動的なルーティング](/docs/routing/dynamic-routes.md)と共に [`getStaticProps`](/docs/basic-features/data-fetching/get-static-props.md) を用いたページに与えられたパラメータは、いつでも `query` オブジェクト内で使用可能です。****
2533
2634
`next build` は静的最適化がされたページに対して `.html` ファイルを出力します。例えば、 `pages/about.js` のページに対するビルド結果は以下のようになります:
2735

2836
```bash
29-
.next/server/static/${BUILD_ID}/about.html
37+
.next/server/pages/about.html
3038
```
3139

3240
`getServerSideProps` をページに加えると、今度はビルド結果が以下のような JavaScript ファイルになります:
3341

3442
```bash
35-
.next/server/static/${BUILD_ID}/about.js
43+
.next/server/pages/about.js
3644
```
3745

3846
## 注意事項
3947

40-
- `getInitialProps` を用いた[カスタム `App` ](/docs/advanced-features/custom-app.md)の場合、[静的生成](/docs/basic-features/data-fetching.md#getstaticprops-static-generation)なしのページではこの最適化はオフになります。
48+
- `getInitialProps` を用いた[カスタム `App` ](/docs/advanced-features/custom-app.md)の場合、[静的生成](/docs/basic-features/data-fetching/get-static-props.md)なしのページではこの最適化はオフになります。
4149

4250
- `getInitialProps` を用いた[カスタム `Document` ](/docs/advanced-features/custom-document.md)の場合は、ページがサーバーサイドでレンダリングされると仮定する前に `ctx.req` が定義されているかどうかを確認してください。`ctx.req` はプリレンダリングされるページでは `undefined` になります。

0 commit comments

Comments
 (0)