Skip to content

Commit 37df2ae

Browse files
i18n(ja): create queued rendering page (#13857)
Co-authored-by: Shinya Fujino <shf0811@gmail.com>
1 parent e090a22 commit 37df2ae

1 file changed

Lines changed: 93 additions & 0 deletions

File tree

Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
---
2+
title: 実験的なキューレンダリング
3+
sidebar:
4+
label: キューレンダリング
5+
i18nReady: true
6+
---
7+
8+
import Since from '~/components/Since.astro';
9+
10+
<p>
11+
12+
**Type:** `object`<br />
13+
**Default:** `{ enabled: false }`<br />
14+
<Since v="6.0.0" />
15+
</p>
16+
17+
再帰ではなくキューに基づいた、より高パフォーマンスな実験的レンダリング基盤を有効にします。
18+
19+
デフォルトでは、Astroは再帰アルゴリズムを使用して`.astro``.md``.mdx`ファイルをレンダリングします。ツリー構造にシリアライズされた一連のコンポーネントを入力として受け取り、ツリーの各ノードに対してAstroはレンダリング関数を呼び出します。
20+
21+
キューレンダリングを有効にすると、Astroはツリー内のすべてのノードを走査し、[深さ優先](https://en.wikipedia.org/wiki/Depth-first_search)のノードリストを生成します。このリストは再帰アルゴリズムを使わずに順番にレンダリングされます。このレンダリング方式はメモリ効率が高く、大規模なプロジェクトでより大きな効果が期待できます。
22+
23+
デフォルト設定でこの機能を有効にするには、Astroの設定で`queuedRendering.enabled``true`に設定します。
24+
25+
```js title="astro.config.mjs" ins={5-7}
26+
import { defineConfig } from "astro/config";
27+
28+
export default defineConfig({
29+
experimental: {
30+
queuedRendering: {
31+
enabled: true
32+
}
33+
}
34+
});
35+
```
36+
37+
将来のメジャーバージョンでは、Astroはデフォルトでこの新しいコンパイラーを使用するようになりますが、`experimental.queuedRendering`フラグを使用することで、いち早く将来の動作を試すことができます。
38+
39+
## 設定
40+
41+
キューレンダリングエンジンには追加の低レベル機能が用意されており、その他の最適化を実験することができます。これらの最適化はキューエンジン自体の直接的な機能ではなく、この実験フェーズのテスト中に非効率と判明した場合は削除される可能性があります。
42+
43+
### ノードプーリング
44+
45+
<p>
46+
47+
**Type:** `number`<br />
48+
**Default:** `1000`<br />
49+
<Since v="6.0.0" />
50+
</p>
51+
52+
ノードプーリングは、レンダリング間でコンポーネントノードを再利用するためのキャッシュシステムです。この機能は初期テストに基づいた合理的なデフォルト値で自動的に有効になります。ただし、プロジェクトのニーズに合わせて1つのプールに含まれるノード数を増減するため、プールのサイズを設定できます。この機能を完全に無効にするには、`poolSize``0`に設定します。
53+
54+
ノードプーリングは静的ページのレンダリングに非常に効果的です。同じコンポーネントを共有する多くのページを持つウェブサイトをビルドする際に、メモリを節約できます。
55+
56+
オンデマンドレンダリングのページでは、レンダリングリクエスト間でメモリを共有しないため、この戦略によるメモリ節約の効果がなく、ノードプーリングは無効になります。
57+
58+
```js title="astro.config.mjs" ins={7}
59+
import { defineConfig } from "astro/config";
60+
61+
export default defineConfig({
62+
experimental: {
63+
queuedRendering: {
64+
enabled: true,
65+
poolSize: 3000 // 3000ノードのプールを使用する
66+
}
67+
}
68+
});
69+
```
70+
71+
### コンテンツキャッシング
72+
73+
<p>
74+
75+
**Type:** `boolean`<br />
76+
**Default:** `false`<br />
77+
<Since v="6.0.0" />
78+
</p>
79+
80+
コンテンツキャッシングは、ページのレンダリング中に値(通常は文字列)を再利用するもう一つの技法です。現在、この機能は有効・無効の切り替えのみで、追加の設定はできません。デフォルトでは無効ですが、有効にすると実験的なキューエンジンがほとんどの大規模コンテンツコレクションに対して合理的なデフォルトキャッシュサイズを選択します。
81+
82+
```js title="astro.config.mjs" ins={7}
83+
import { defineConfig } from "astro/config";
84+
85+
export default defineConfig({
86+
experimental: {
87+
queuedRendering: {
88+
enabled: true,
89+
contentCache: true
90+
}
91+
}
92+
});
93+
```

0 commit comments

Comments
 (0)