アイランドアーキテクチャ(Islands Architecture)は、ページの大部分を静的なHTMLで配信し、操作が必要な部品だけを「島(island)」として個別にJavaScriptで動かす設計です。ページ全体をまとめてハイドレートするSPAと違い、島の外側にはJavaScriptを送りません。この記事では、仕組みをAstro 7.4のビルド出力で確かめ、client:*ディレクティブごとに送られるJavaScriptの量、島どうしで状態を共有する方法、サーバーアイランド、Fresh・Qwikとの違い、Next.jsのPPR(Partial Prerendering)との違いまでを順に説明します。
まとめ:アイランドアーキテクチャの要点
- 定義:静的HTMLの中に、独立してハイドレートされる「島」を置く設計です。JavaScriptはページ単位ではなく島単位で配信されます。
- 由来:「コンポーネントアイランド」は2019年にEtsyのKatie Sylor-Miller氏が提案し、Preact作者のJason Miller氏が2020年8月11日の記事で体系化しました。
- Astro 7.4での実測:ディレクティブを付けないReact部品はJavaScript 0件のHTMLになります。client:visibleを付けた島を1つ置くと、React本体を含めて約69KB(gzip)が読み込まれ、Preactなら約7.7KBでした。
- 弱点と対処:島どうしは独立しているため状態を直接共有できません。Astroが推奨するNano Storesを使えば、別の島の表示を更新できます。
- 向くサイト:ブログ・ドキュメント・LP・ECの商品ページのように、静的な内容の中に操作する部品が散らばるサイトです。画面全体が連動する管理画面には向きません。
- PPRとの違い:Next.jsのPPRはサーバーが返すHTMLの静的部分と動的部分の境界を扱い、島はブラウザへ送るJavaScriptの境界を扱います。PPRはNext.js 16で
cacheComponentsに統合されました。
以下、定義と仕組みから実装手順、実測値、他の技術との違いの順に説明します。
アイランドアーキテクチャの定義と名前の由来
アイランドアーキテクチャでは、ページを「静的なHTMLの海」と、その中に浮かぶ「操作できる島」に分けて考えます。見出し・本文・フッターのように動かない部分は素のHTMLのまま配信し、検索ボックス・画像カルーセル・カートボタンのようにJavaScriptが必要な部品だけを島として切り出します。
SPAの全体ハイドレーションとの差
ReactやVueで作る一般的なSPAは、サーバーで描いたHTMLをブラウザで受け取ったあと、ページ全体のコンポーネントを読み込み直してイベントを結び付けます(ハイドレーション)。記事本文のように一度表示したら変わらない部分にも、この読み込みと実行のコストがかかります。
島の考え方では、ハイドレートするのは島だけです。Astro公式ドキュメントのアイランドの解説は、低優先度の画像カルーセルの島が高優先度のヘッダーの島をブロックせず、両者が並列に読み込まれて独立にハイドレートされる点を利点に挙げています。この土台の技術は「パーシャルハイドレーション(部分ハイドレーション)」や「セレクティブハイドレーション」と呼ばれます。レンダリング方式そのものの違いはCSRとSSRの違いと使い分けで整理しています。
2019年のEtsyと2020年のJason Millerの記事
Jason Miller氏の記事「Islands Architecture」(2020年8月11日)は、「Component Islands」というパターンを、EtsyのフロントエンドアーキテクトだったKatie Sylor-Miller氏が2019年の打ち合わせで名付けたものだと記しています。記事の説明は、サーバーでHTMLページを描き、動きの多い領域をプレースホルダーで囲み、そこをクライアント側で小さな自己完結したウィジェットとしてハイドレートする、というものです。
サーバーが返したHTMLに部分的にJavaScriptを足す手法自体は、jQuery時代から存在しました。新しいのは、フレームワークがその分割をコンポーネント単位で自動化し、どの島をいつ動かすかを宣言で書けるようにした点です。
部分ハイドレーションの仕組みとAstroが出力するHTML
島の仕組みは、ビルド後のHTMLを見ると具体的に分かります。以下はastro 7.4.2と@astrojs/react 7.1.1で、Reactのカウンター部品を1つ置いたページをビルドした結果です(2026年10月26日、Node.js 26.5.0で計測)。
ディレクティブ無しの部品が出力するJavaScript 0件のHTML
Reactの部品でも、client:*ディレクティブを付けなければAstroはサーバー側でHTMLに変換するだけで、JavaScriptを出力しません。ビルドしたページは104バイトで、<script>タグは0本でした。ブラウザで開いても /_astro/ 配下へのリクエストは発生しません。
<!DOCTYPE html><html><body><h1>static</h1><button>no-directive<!-- -->: <!-- -->0</button></body></html>
ボタンは表示されますが、押しても数は増えません。Reactで書いた部品をAstroに置くだけでは「動かない」のは、この既定動作のためです。
astro-island要素による読み込みとハイドレートの分担
同じ部品に client:visible を付けると、HTMLが <astro-island> というカスタム要素で包まれます。属性に部品のJavaScript(component-url)、Reactをブラウザで動かすレンダラー(renderer-url)、ハイドレートの契機(client)、ディレクティブのオプション(opts)が入ります。
<astro-island uid="ZgHhxj" prefix="r1"
component-url="/_astro/Counter.DfJ6q7HF.js" component-export="default"
renderer-url="/_astro/client.Cd-EeyjT.js"
props="{"label":[0,"visible"]}" ssr client="visible"
opts="{"name":"Counter","value":{"rootMargin":"200px"}}"
await-children>
<button>visible<!-- -->: <!-- -->0</button><!--astro:end-->
</astro-island>
中のボタンはサーバーで描いた完成済みのHTMLです。HTMLには約5.7KBのインラインスクリプトが加わり、契機が来た時点で component-url と renderer-url を並列に読み込んで、このHTMLにイベントを結び付けます。propsはJSON文字列として属性に埋め込まれるため、島に渡す値はシリアライズできる型に限られます。関数をpropsで渡すことはできません。
クライアントアイランドとサーバーアイランドの違い
上の astro-island はブラウザでハイドレートされる「クライアントアイランド」です。Astroにはもう1種類、server:defer で作る「サーバーアイランド」があります。こちらはブラウザでJavaScriptの部品を動かすのではなく、ログインユーザー名のように時間がかかったり人ごとに変わったりするHTML片を、ページ本体とは別のリクエストでサーバーが描いて後から差し込みます。
前者は「操作できるようにする」ための島、後者は「ページ本体を待たせない」ための島です。目的が違うので、1つのページで両方を使えます。サーバーアイランドの書き方と挙動は次の章で確かめます。
Astro 7でアイランドを作る手順
Astroの現行版は7.4.2(2026年10月21日公開)です。AstroとReactの組み合わせ方(npx astro add react での導入や設定)はAstroとReactの違いと使い分けで、Astro自体の特徴はAstroフレームワークとはで説明しています。ここでは島の指定に絞ります。
client:*ディレクティブ5種とオプションの使い分け
Astroのディレクティブリファレンスが定めるクライアントディレクティブは次の5種です。
| ディレクティブ | ハイドレートの契機 | オプション | 向く部品 |
|---|---|---|---|
| client:load | ページ読み込み直後 | なし | ヘッダーのメニュー |
| client:idle | 初期読み込み後のrequestIdleCallback | timeout(ミリ秒) | チャット起動ボタン |
| client:visible | 要素が画面に入ったとき | rootMargin | ページ下部のグラフ |
| client:media | メディアクエリが一致したとき | クエリ文字列 | スマホ専用の開閉ボタン |
| client:only | 読み込み直後(サーバー描画なし) | フレームワーク名 | windowに触る外部埋め込み |
client:idle={{timeout: 500}} と書くと、ブラウザが忙しくても500ミリ秒たてば読み込みが始まります。requestIdleCallbackに対応しないブラウザについて、公式リファレンスはloadイベントを使うと説明していますが、astro 7.4.2の実装(idle.js)は200ミリ秒(timeout指定時はその値)待ってから読み込みます。client:visibleは内部でIntersectionObserverを使い、client:visible={{rootMargin: "200px"}} なら要素の200ピクセル手前で読み込みが始まります。client:onlyだけはサーバーでHTMLを作らないため、client:only="react" のようにフレームワーク名が必須で、読み込み中の表示は slot="fallback" の子要素で出します。
---
import Menu from '../components/Menu.jsx';
import Chart from '../components/Chart.jsx';
import ChatButton from '../components/ChatButton.jsx';
---
<Menu client:load />
<ChatButton client:idle={{timeout: 500}} />
<Chart client:visible={{rootMargin: "200px"}} />
選び方の原則は、最初の画面で触る部品だけを client:load にし、下にある部品ほど client:idle、client:visible へ後ろ倒しすることです。ファーストビューの外にある部品を client:load にしていないかを見直すのが、最も手間の少ない改善です。
Nano Storesで島どうしの状態を共有する
島はそれぞれ別のReactツリーとしてハイドレートされるため、ReactのContextでは島をまたいで値を渡せません。Astro公式の状態共有レシピは、1KB未満で依存のないNano Storesを推奨しています。ヘッダーのカート件数(client:load)と、本文の「カートに入れる」ボタン(client:visible)を別々の島にした例です。
// src/stores/cart.js
import { atom } from 'nanostores';
export const $cartCount = atom(0);
// src/components/AddButton.jsx(本文の島)
import { $cartCount } from '../stores/cart.js';
export default function AddButton() {
return <button onClick={() => $cartCount.set($cartCount.get() + 1)}>カートに入れる</button>;
}
// src/components/CartBadge.jsx(ヘッダーの島)
import { useStore } from '@nanostores/react';
import { $cartCount } from '../stores/cart.js';
export default function CartBadge() {
const count = useStore($cartCount);
return <span>カート:{count}点</span>;
}
<header><CartBadge client:load /></header>
<main><AddButton client:visible /></main>
nanostores 1.5.5と@nanostores/react 2.0.1でビルドし、ヘッドレスChromiumでボタンを2回押すと、ヘッダーの表示は「カート:0点」から「カート:2点」に変わりました。ストアは1つのチャンクにまとめられ、2つの島が同じものを読み込みます。共有されるのはブラウザ内の値だけで、ページを移動すれば消えるため、残したいときは永続化用の@nanostores/persistentを使います。atomやcomputedの書き方はNano Storesとはで詳しく扱っています。
server:deferでサーバーアイランドを置く
サーバーアイランドには、オンデマンド描画用のアダプターが必要です。@astrojs/node 11.1.9を入れ、ページ自体は事前生成(prerender)のまま、cookieを読む部品にだけ server:defer を付けました。
---
// src/components/Greeting.astro
const user = Astro.cookies.get('user')?.value ?? 'guest';
---
<p>こんにちは、{user}さん</p>
<Greeting server:defer>
<p slot="fallback">読み込み中…</p>
</Greeting>
ビルドされた静的HTMLには「読み込み中…」と、/_server-islands/Greeting?e=… をfetchして中身を差し替えるスクリプトが入りました。e= は暗号化した部品のexport名で、propsは p=、スロットは s= に暗号化して入ります(この例はpropsが無いので p= は空です)。応答は 200 text/html で <p>こんにちは、yamadaさん</p> だけを返し、e= を書き換えたリクエストは400で拒否されました。
実装で効く仕様は3つあります。Astroのサーバーアイランドのガイドによると、データはGETで取得されるためCache-Controlヘッダーでキャッシュできますが、URLが2048バイトを超えるとpropsを本文に入れたPOSTに切り替わり、ブラウザのキャッシュが効かなくなります。島の中の Astro.url は /_server-islands/… を指すので、表示中のページのURLが必要ならRefererヘッダーから取ります。また、propsの暗号鍵はビルドごとに生成されるため、ローリングデプロイや古いHTMLをCDNが返す構成では、astro create-key で作った鍵を環境変数 ASTRO_KEY に設定して固定しないと復号に失敗します。Astro 5で入った当初の仕様はAstro 5の新機能と移行手順にまとめています。
もう1点、計測した応答には x-robots-tag: noindex が付いていました。ページの静的HTMLに入るのはfallbackだけで、中身はJavaScriptの実行後に差し込まれます。検索エンジンに確実に読ませたい本文はサーバーアイランドに入れず、ページ本体のHTMLに置いてください。
transition:persistでページ遷移後も島の状態を保つ
島を使うサイトはページごとにHTMLを読み込むMPAなので、移動するたびに島の状態が初期化されます。Astroのビュートランジションのガイドによると、ClientRouterを有効にして島に transition:persist を付ければ、移動先に同じ部品があるとき前のページの島が状態ごと残ります。
<Counter client:load transition:persist initialCount={5} />
用途は音楽プレーヤーや動画のように、ページをまたいで止めたくない部品です。CSSアニメーションの再開とiframeの再読み込みは避けられません。
Astro 7.4で測った島ごとのJavaScript量
島の効果は「送らずに済んだJavaScriptの量」で決まります。同じカウンター部品をReactとPreactで書いて1ページずつビルドし、ヘッドレスChromiumが実際に要求したファイルを数えて、gzip(-9)で圧縮した大きさを合計しました。
| ページの構成 | 読み込まれるJS(gzip) | /_astro/へのリクエスト |
|---|---|---|
| Reactの部品・ディレクティブ無し | 0バイト | 0件 |
| Reactの島1つ(client:visible) | 約69.1KB | 3件 |
| Reactの島を2つ(同じ部品) | 約69.1KB(増えない) | 3件 |
| Preactの島1つ(client:visible) | 約7.7KB | 4件 |
| 3,000px下のReactの島(スクロール前) | 0バイト | 0件 |
Reactの島の内訳は、react-domを含むレンダラーが65,686バイト、reactが3,042バイトで、部品自体は377バイトでした。島のコストの大半は部品ではなく、最初の島が連れてくるUIフレームワークの本体です。同じフレームワークの島を2つ目、3つ目と増やしても本体は共有されるので、増えるのは部品の分だけです。
このため、判断の軸は「島をいくつ置くか」より「1つ目の島にどのフレームワークを使うか」です。ブログにいいねボタンが1つあるだけなら、そのためにReactの島1つ分の約69KBを送るのは割に合いません。小さな部品が数個のサイトなら、Preact(約7.7KB)か、Astroの <script> に書く素のJavaScriptで足ります。PreactとReactの互換性の範囲はPreactとは?Reactとの違いで説明しています。逆に、Reactの既存部品やライブラリを島として使い回せることが目的なら、本体の分は一度払えば済むと割り切れます。
client:visibleの効果も確かめました。3,000ピクセル下に島を置いたページでは、開いた時点のリクエストは0件で、スクロールして島が画面に入ったところで3件の読み込みが始まりました。下の方の部品をclient:visibleにすれば、ページを最後まで読まない読者にはJavaScriptが一切届きません。
Fresh・Marko・Qwikでの島の扱いの違い
アイランドアーキテクチャはAstro専用の機能ではありません。Freshは同じ考え方を別の書き方で実装し、Marko 6とQwikは島をさらに細かくした別の方式を採っています。
Fresh 2.3のislandsフォルダとDenoのCloudflare合流
Deno製のFreshは、islands/ フォルダ(またはroutes配下の (_islands) フォルダ)に置いたPreact部品だけをクライアントへ送ります。部品ごとにディレクティブを書くAstroと違い、置き場所で島が決まります。Freshの島のドキュメントによると、propsにはDate・Map・Set・URL・Preact Signalsなどシリアライズできる値を渡せますが、関数は渡せません。
現行の安定版はFresh 2.3.3(2026年4月28日)です。Fresh 1系の特徴だった「ビルド不要」は2系で変わり、2.0.0のリリースノートは「Fresh is officially a vite plugin now」と書いています。Fresh 1系の前提で書かれた解説は、この点が古くなっています。
前提も変わりました。2026年10月9日のDenoの公式ブログ「Deno is joining Cloudflare」は、Deno社によるランタイム開発をあと1年の月次リリースのあとで終え(Deno自体はオープンソースとして残ります)、Deno Deployを6か月後に止めると発表しました。発表本文はFreshに触れていません。Fresh自体は6月3日にDenoから独立したGitHub組織(freshframework)へ移っており、メンテナーのLuca Casonato氏の告知では、FreshはViteに一本化し、Nitroを使ってNodeやCloudflare Workersにも配備できるようにする方針です。10月17日には同氏が、次のFresh 3は「Node、Deno、そのほかNitroがビルド先として対応するランタイムで動く」と書き込んでいます。Fresh 3は10月26日時点で未リリースです。既存のFreshアプリはFresh公式のCloudflare Workers向け手順で移せますが、島を前提に新しくサイトを作るなら、Fresh 3の正式版が出るまではAstroを選ぶ方が安全です。Deno Deploy上のアプリの移し方はDeno Deploy終了と移行手順、Fresh 2の構成はDeno Freshとはで説明しています。
Marko 6の式単位の解析とQwikのresumability
eBayが開発するMarkoは、旧版(5系まで)では部品の境界で島を切る方式でした。現行のMarko 6(GitHub Releasesの最新は2026年10月15日の6.4.6)は一歩進め、Markoの公式ドキュメントが「Islands operate at component boundaries, but Marko analyzes at the expression level」と書くとおり、コンパイル時に式の単位で静的か動的かを判定し、静的な式にはクライアント用のコードを出力しません。さらにクライアントの初期化でテンプレートを描き直さず、イベントの登録と状態の復元だけを行います。島より細かい単位で、ハイドレーションそのものを省く設計です。
Qwikも同じ方向の技術で、QwikのFAQは部分ハイドレーション(アイランドアーキテクチャ)を行うかという問いに「No」と答えています。島は開発者が手で区切り、いつハイドレートするかも手で指定する必要があり、島どうしは通信できない、というのがQwikの見方です(Astroでは前章のNano Storesで共有できます)。Qwikはサーバーで止めた実行をクライアントで再開する「resumability」を採り、部品のコードはイベントが起きたときに初めて実行します。Qwikの先読みの解説によると、既定ではページ上のイベントハンドラーのコードを裏で先読みします。
島は「どの部品をハイドレートするか」を開発者が選ぶ方式、Marko 6とQwikは「ハイドレートしない」方式です。既存のReact部品を使い回すならAstroの島、初期のJavaScriptを極限まで削る新規開発ならQwikやMarko 6が候補です。Qwikの実際のビルド結果はQwikとは?で確かめています。
アイランドアーキテクチャを採用すべきサイトと避けるべきアプリ
採用すべきなのは、内容の大半が静的で、操作する部品が局所的なサイトです。ブログ、技術ドキュメント、企業サイト、LP、ECの商品詳細ページがこれにあたります。前章の実測のとおり、本文を静的HTMLにして下の部品をclient:visibleにすれば、多くの読者にはJavaScriptがほとんど届きません。検索エンジンにとっても、本文がHTMLにそのまま入っているので読み取りやすい構成です。
避けるべきなのは、画面のほぼ全体が操作対象で、部品どうしが絶えず連動するアプリです。管理画面のダッシュボード、表計算のような編集画面、チャットやリアルタイム共同編集の画面がこれにあたります。島の数がページ全体に広がるとJavaScriptを減らす利点が消え、Nano Storesでの橋渡しが増えるだけです。この種のアプリは、Next.jsなどで作るSPA(またはReact Server Componentsを使う構成)の方が素直に書けます。
迷ったら、ページを1枚選んで「JavaScriptが無くても読める部分」の割合を見てください。半分以上が静的なら島が効き、ほぼ全部が動くなら島にする理由はありません。MPAのページ移動はSPAより遅く感じられることがあるので、遷移の体感を重視するサイトではClientRouterとtransition:persistまで含めて評価します。
PPR(Partial Prerendering)・React Server Componentsとの違い
アイランドアーキテクチャと混同されやすいのが、Next.jsのPPRとReact Server Components(RSC)です。3つは「どこで何を分けるか」が違います。
| 技術 | 分ける対象 | 分ける場所 | 主な効果 |
|---|---|---|---|
| アイランドアーキテクチャ | JSを送る部品と送らない部分 | ブラウザ | 送信するJSの削減 |
| PPR(Next.js) | 事前生成するシェルとリクエスト時の部分 | サーバー | 最初のHTMLを速く返す |
| RSC | Server ComponentsとClient Components | コンポーネントツリー | サーバー専用コードをバンドルから外す |
PPRは、ルートの静的な部分をビルド時にHTMLのシェルとして作っておき、リクエスト時にシェルをすぐ返しながら、動的な部分だけを後からストリーミングで流し込む仕組みです。短くなるのはHTMLが返るまでの時間で、ブラウザに送るJavaScriptは減りません。
PPRの設定は変わっています。Next.jsの cacheComponents のドキュメントによると、Next.js 16.0.0で cacheComponents が安定版のトップレベル設定になり、PPRはその既定の動作に組み込まれました。Next.js 15までの experimental.ppr と experimental_ppr は削除されています。現行の16.4.3(2026年10月23日公開)では、cacheComponentsを有効にするとき partialPrefetching も明示的に指定しないと警告が出ます。
// next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
cacheComponents: true,
partialPrefetching: true,
}
export default nextConfig
島に近いのは、むしろRSCです。Server ComponentsはJavaScriptを送らず、'use client' を付けたClient Componentsだけがハイドレートされるので、Client Componentsが島のように見えます。ただしNext.jsのページではルーターとreact-domが常に読み込まれるため、Astroのような「JavaScript 0件のページ」にはなりません。RSCの仕組みはReact Server Components(RSC)とは、PPRのシェルとストリーミングの挙動はStreaming UIとは、16.4のキャッシュ設定はNext.jsのキャッシュで扱っています。
よくある質問
アイランドアーキテクチャとは何ですか?
ページの大部分を静的なHTMLで配信し、操作が必要な部品だけを独立した「島」としてJavaScriptで動かす設計です。ページ全体ではなく島ごとにハイドレートするので、島の外側にはJavaScriptを送りません。Astro 7.4で確かめると、ディレクティブを付けないReact部品のページはJavaScriptが0件でした。Astro、Freshなどが採用しています。Marko 6やQwikは島より細かい単位でハイドレーションを省く別の方式です。
Island ArchitectureとSPAの違いは何ですか?
SPAはページ全体を1つのJavaScriptアプリとしてハイドレートし、画面遷移もブラウザ内で処理します。アイランドアーキテクチャは静的なHTMLを基本にし、必要な部品だけをハイドレートします。初期表示で送るJavaScriptは島の方が少なく、画面遷移の滑らかさや画面全体で状態を共有しやすい点はSPAが有利です。
Reactでアイランドアーキテクチャは使えますか?
使えます。Astroに@astrojs/reactを入れると、Reactの部品に client:load や client:visible を付けて島にできます。ただし1つ目の島でReact本体(Astro 7.4・React 19.3の計測でreact-domとreactで約69KB、gzip)が読み込まれます。島が少ないサイトでは、Preactや素のJavaScriptの方が軽く済みます。
PPRとは何ですか?アイランドアーキテクチャと同じですか?
PPR(Partial Prerendering)は、Next.jsで静的なHTMLのシェルを先に返し、動的な部分を後からストリーミングで流し込む仕組みです。サーバーがHTMLを返す速さを改善する技術で、ブラウザへ送るJavaScriptを島ごとに絞る技術ではないため、別物です。Next.js 16からは cacheComponents: true で有効になります。
アイランドアーキテクチャのデメリットは何ですか?
島どうしが独立しているため、状態を直接共有できない点です。共有にはNano Storesなどの外部ストアが要ります。また、ページ移動のたびにHTMLを読み込むので、島の状態は初期化されます(Astroでは transition:persist で保てます)。画面全体が連動するアプリでは島が増えて利点が消えるため、SPAの方が向きます。