アイランドを実際に置いてみた


目次

前回の記事で紹介したアイランドアーキテクチャを、実際にこのブログに置いてみました。この記事の中には、JavaScript で動く「島」が 2 つあります。

準備:UI フレームワークを追加する

Astro のアイランドは、React や Vue などの UI フレームワークのコンポーネントで作ります。今回は軽量な Preact を使うことにして、次のコマンドで追加しました。

Terminal window
npx astro add preact

astro.config.mjs への登録や tsconfig.json の設定まで自動でやってくれます。

また、Markdown(.md)の中ではコンポーネントを使えないので、この記事は MDX(.mdx)で書いています。

島その 1:すぐに動く「いいね」ボタン(client:load)

⏳ JavaScript の読み込み待ち(まだ静的な HTML です)

このボタンには 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: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 />
💤 この島はまだ眠っています。画面に入るまで JavaScript は読み込まれません。

表示されている秒数は、ページを開いてからこの島が動き出すまでの時間です。ゆっくりスクロールしてきた場合は数秒以上、ページ内リンクで一気に飛んできた場合は短くなります。client:load の島と比べると、読み込みのタイミングがずれていることがわかります。

まとめ

  • アイランドを使うには、React や Preact などの UI フレームワークを npx astro add で追加する
  • Markdown の記事に置くなら MDX で書く
  • client:* を付けたコンポーネントだけが JavaScript で動き、それ以外は静的な HTML になる
  • 読み込みのタイミングはディレクティブで選べる。必要になるまで遅らせるほど、ページは軽くなる