
アイランドを実際に置いてみた
目次
前回の記事で紹介したアイランドアーキテクチャを、実際にこのブログに置いてみました。この記事の中には、JavaScript で動く「島」が 2 つあります。
準備:UI フレームワークを追加する
Astro のアイランドは、React や Vue などの UI フレームワークのコンポーネントで作ります。今回は軽量な Preact を使うことにして、次のコマンドで追加しました。
npx astro add preactastro.config.mjs への登録や tsconfig.json の設定まで自動でやってくれます。
また、Markdown(.md)の中ではコンポーネントを使えないので、この記事は MDX(.mdx)で書いています。
島その 1:すぐに動く「いいね」ボタン(client:load)
このボタンには client:load を付けています。
import LikeButton from '../../components/islands/LikeButton.tsx';
<LikeButton client:load />ページを開くとすぐに JavaScript が読み込まれ、ボタンが押せるようになります。ボタンの横の表示が「⏳ 読み込み待ち」から「✅ 押せるようになりました」に変わるのが、ハイドレーション(静的な HTML に JavaScript が結びつくこと)の瞬間です。
ちなみに、このボタンの数はページを再読み込みすると 0 に戻ります。状態はブラウザの中だけで持っていて、サーバーには保存していないためです。
島がないとどうなるか
client:* を付けずに、ただ <LikeButton /> と書くとどうなるでしょうか。
答えは、見た目はそのままで、ボタンが一切反応しなくなります。Astro はコンポーネントをサーバー側で HTML に変換しますが、client:* がなければ JavaScript はブラウザに送られません。「何もしなければ JS ゼロ」という Astro の方針がよくわかる挙動です。
client:visible の出番
client:load は便利ですが、ページ内のすべての島に付けると、結局たくさんの JavaScript を最初に読み込むことになります。
そこで使うのが client:visible です。これを付けたコンポーネントは、ユーザーがスクロールして画面に入ったとき に初めて JavaScript を読み込みます。ページの下の方にあるコメント欄や、関連記事のカルーセルなどに向いています。
この記事の一番下にも、client:visible を付けた島を置いています。ページを開いた直後ではなく、スクロールしてたどり着いたときに目を覚ますはずです。
ブラウザの開発者ツールの「ネットワーク」タブを開いた状態でスクロールすると、島が画面に入った瞬間に JavaScript ファイルが読み込まれる様子も確認できます。
ここまでの流れを図にすると、次のようになります。

使い分けの目安
| ディレクティブ | 向いている場面 |
|---|---|
client:load |
ページを開いてすぐ操作されるもの(ヘッダーのメニュー、検索ボックスなど) |
client:idle |
すぐでなくてもよいが、早めに使えてほしいもの |
client:visible |
ページの下の方にあるもの(コメント欄、関連記事など) |
client:media |
特定の画面幅のときだけ必要なもの(スマホ用メニューなど) |
client:only |
サーバーで描画できないもの(ブラウザの API に依存するものなど) |
島その 2:画面に入ったら目を覚ます島(client:visible)
import HydrationStamp from '../../components/islands/HydrationStamp.tsx';
<HydrationStamp client:visible />表示されている秒数は、ページを開いてからこの島が動き出すまでの時間です。ゆっくりスクロールしてきた場合は数秒以上、ページ内リンクで一気に飛んできた場合は短くなります。client:load の島と比べると、読み込みのタイミングがずれていることがわかります。
まとめ
- アイランドを使うには、React や Preact などの UI フレームワークを
npx astro addで追加する - Markdown の記事に置くなら MDX で書く
client:*を付けたコンポーネントだけが JavaScript で動き、それ以外は静的な HTML になる- 読み込みのタイミングはディレクティブで選べる。必要になるまで遅らせるほど、ページは軽くなる