シングルページアプリケーション

どのようなものか

シングルページアプリケーションは、single-page
appとも表記し、通常はSPAと略します。一つのHTML文書を読み込み、サー
バーへ新しいページを要求する代わりに、JavaScriptでその文書を書き換え
るウェブアプリケーションです。内部のリンクをクリックしても、ページは
破棄されません。スクリプトがクリックを受け取り、次の画面に必要なデー
タを取得し、DOMの一部を書き換えてアドレスバーを更新します。そのた
め、URLには利用者がいる場所が引き続き示されます。

この用語を定義する標準はなく、ツールの開発者自身もそれを認めていま
す。Next.jsは、この主題のガイドを「SPAの定義はさまざまです」という説
明で始め、そのうえで、自分たちが使う定義をstrict
SPAと呼んで定めています。特徴は二つあります。一つのHTMLファイルがア
プリ全体を受け持ち、ブラウザー内のJavaScriptが、すべてのルート、ペー
ジ遷移、データのリクエストを処理します。そして、ページ全体は再読み込
みしません。ルートが変わると、クライアント側のスクリプトが、すでに開
いているページのDOMを書き換え、サーバーへ新しい文書を要求する代わり
に、必要なときにデータを読み込みます。この記事は、この定義を使いま
す。提示されている中で最も直接的であり、ほかのすべての前提となる、文
書が置き換わらないという性質を明示しているためです。

それを支えるブラウザーの仕組みは標準化されています。HTML
StandardのHistoryインターフェースは、何も読み込まずにセッション履歴
へ新しい項目を追加してURLを設定する`history.pushState()`と、現在の項
目を書き換える`history.replaceState()`を提供します。利用者がそれらの
項目の間を戻ったり進んだりすると、ブラウザーはウィンドウに`popstate`
イベントを発火し、再描画はページへ任せます。標準が従来のlocationと
historyのAPIの後継として紹介する、より新しいNavigation
APIは、反対側から処理します。ナビゲーションが始まると`navigate`イベ
ントが発火し、その`intercept()`メソッドが、ページ自身の処理する同一
文書内のナビゲーションへ切り替えます。

対照的なのは、通常の複数ページのウェブサイトです。リンクをたどるたび
にサーバーへ新しい文書を要求し、ブラウザーは古い文書を破棄します。
ページのHTMLを静的サイトジェネレーターで一度生成するか、サーバーサイ
ドレンダリングでリクエストごとに生成するかは、別の問題です。それは、
HTMLが届いた後の動作ではなく、HTMLの生成方法に関わります。Next.jsは
意図的にこの境界を曖昧にしています。静的エクスポートはルートごとに
HTMLファイルを書き出しますが、その間の移動は依然としてクライアント側
で行います。

なぜ重要なのか

文書を置き換えないため、その中にあるものはクリック後も残ります。入力
途中のフォーム、再生中の動画、サイドパネルのスクロール位置、取得済み
のデータなどです。ネットワークを通す必要があるのは、次の画面に必要な
データだけで、ヘッダー、スタイル、スクリプトを含む新しいページ全体で
はありません。画面の切り替えが、ページ内の一つの領域を書き換えるだけ
で済むこともあります。

Next.jsは、定義とともにその負担も挙げています。厳密なSPAは、ページを
操作できるようになるまでに大量のJavaScriptを読み込む必要があることが
多く、一つのリクエストが返ってからでなければ次を開始できない、クライ
アント側のデータ取得の連鎖を管理するのも困難です。スクリプトを実行せ
ずにページを読むものにも、しわ寄せが及びます。すべてのルートに一つの
HTMLファイルを使うと、JavaScriptを実行しないクローラーは、どのURLを
要求しても同じ、ほとんど空の文書を受け取ります。Next.jsは、自身のブ
ラウザー専用コンポーネントにも同じ指摘をしています。スクリプトを実行
せずにページを索引化するものが受け取るのは、コンポーネントではなく
フォールバックです。

Next.jsの答えは、クライアント側のナビゲーションを残し、それ以外を移
すことです。JavaScriptのバンドルを自動的に分割し、異なるルートへの
HTMLの入口を複数生成するため、利用者はそのルートに不要なコードを読み
込まずに済みます。`next/link`コンポーネントはルートを先読みし、アプ
リのルーティング状態を、リンクや共有に使えるURLに保持しながら、完全
にクライアント側で描画するSPAと同じくらい素早く切り替わる操作感を実
現します。静的エクスポートはさらに進めて、ルートごとに描画済みのペー
ジを書き出します。利用者はクライアント用バンドルを待たずに内容を受け
取れ、ページ間のクライアント側遷移は、厳密なSPAと同じように速いまま
です。

また、一度選んだら変えられないわけでもありません。Next.jsは、静的サ
イト、またはクライアント側ですべてを描画する厳密なSPAとして始め、成
長に合わせてサーバー機能を追加するプロジェクトを説明しています。既存
のSPAも、最初から書き直すことなく移行できるとしています。

実際の活用例

以下のルーターは、この記事のために記述した、この考え方の最小限の動作
例です。ページに`<main>`要素があり、サーバーがアプリのすべてのパスに
同じHTML文書を返すことを前提としています。二つの画面は、アプリが実際
に表示する内容の代わりです。

```js
// router.js
const views = {
  "/": { title: "Orders", text: "Your recent orders." },
  "/settings": { title: "Settings", text: "Delivery preferences." },
};
const main = document.querySelector("main");

function show(path, moveFocus) {
  const view = views[path] ?? views["/"];
  const heading = document.createElement("h1");
  const body = document.createElement("p");
  heading.textContent = view.title;
  heading.tabIndex = -1;
  body.textContent = view.text;
  main.replaceChildren(heading, body);
  document.title = view.title;
  if (moveFocus) heading.focus();
}

document.addEventListener("click", (event) => {
  const link = event.target.closest("a[href]");
  const modified = event.metaKey || event.ctrlKey || event.shiftKey;
  if (!link || link.origin !== location.origin) return;
  if (modified || event.button !== 0) return;
  event.preventDefault();
  history.pushState(null, "", link.href);
  show(location.pathname, true);
});

window.addEventListener("popstate", () => show(location.pathname, true));
show(location.pathname, false);
```

クリックハンドラーは、同じオリジンへのリンクに対する、修飾キーを伴わ
ない通常の左クリックを引き受け、修飾キー付きのクリックは通過させま
す。そのため、新しいタブでリンクを開く操作も引き続き使えます。
`preventDefault()`はブラウザー自身のナビゲーションを止め、
`pushState()`はリンクのURLを使ってセッション履歴に新しい項目を記録し
ます。中央の引数は歴史的な理由だけで残っているため、空文字列になって
います。`show()`は画面を置き換え、文書のタイトルを設定し、新しい見出
しへフォーカスを移します。`tabIndex`を`-1`にすると、Tabキーの移動順
には含めず、スクリプトからフォーカスできるようになります。`popstate`
リスナーは、利用者が戻ったり進んだりしたときに対応する画面を再描画
し、最後の行は、ページを開いたURLの画面を描画します。これは、サー
バーが`/settings`にも`/`と同じ文書を返す場合だけ動作します。実際のア
プリでは、開始ページを黙って表示する代わりに、ページが見つからないこ
とを示す独自の画面を表示し、ファイルやサイト内のほかの部分へのリンク
には介入しないようにする必要があります。

創業者が現在NextMarinerの名義で取り組んでいる業務では、Next.js
16のフロントエンドが、実際の製品で生じるこうしたコストを示していま
す。そのポートフォリオ記事では、反応が速いと感じられ、実際に対話的に
操作できる状態を保つ必要があった認証付きダッシュボードを取り上げ、す
べてのデータをクライアントで取得すると何が起きるかを説明しています。
初回の読み込みが遅くなり、N+1のパターンが現れます。各コンポーネント
が起動して、それぞれ独自のリクエストを送り、やがて1ページが何度もの
往復通信の連鎖になるのです。これはNext.jsのガイドが警告するクライア
ント側のデータ取得のウォーターフォールが、実際に起きた例です。対策で
は、必要な箇所のクライアント側の対話機能を維持し、最初のデータ取得を
サーバーへ移しました。ダッシュボードと大きなディレクトリ一覧では、
`createPrefetchedServerPage`というファクトリーが、必要なデータをすで
に備えた各ページをクライアントへ渡します。記事は残りの状況も率直に説
明しています。ほかの認証付きページは今もクライアントで描画され、対応
の順番を待っています。つまり、移行が機能していて、次に対応するページ
も明確になっている段階を記録しており、移行が完了したという話ではあり
ません。

問題が起きるところ

戻るボタンを押すとアプリを離れてしまう。
スクリプトが`pushState()`を呼ばずに画面を切り替えると、その画面の項
目がセッション履歴に残りません。戻る操作は、利用者が見たすべての画面
を飛ばしてアプリの外へ出てしまい、再読み込みすると、最初にアプリを開
いたときのURLへ戻ります。利用者がページだと考える画面ごとに履歴へ項
目を追加し、入力中のフィルターなど、独立した履歴項目として残すべきで
ない変更には`replaceState()`を使い、`popstate`も処理してください。
Next.jsがルーティング状態をURLに保持するよう勧める理由も同じです。そ
れによって、画面にリンクし、共有できるからです。

特定の画面への直接リンクが、一つのファイルしか知らないサーバーへ届
く。
厳密なSPAでは、一つのHTMLファイルがすべてのルートを受け持ちますが、
アドレスバーには`/settings`が表示されています。再読み込みしたとき
や、共有されたリンクを開いたときにブラウザーが要求するのは、そのパス
です。`index.html`しかないサーバーは404を返します。アプリのすべての
パスに同じ文書を返すようサーバーを設定するか、ルートごとにファイルを
生成してください。Next.jsの静的エクスポートは後者です。`out`フォル
ダーに`index.html`、`404.html`、`blog/post-1.html`などを保持し、ガイ
ドは、拡張子のないURLを対応するファイルへ結び付けるnginxルール
`try_files
$uri $uri.html $uri/ =404;`を示しています。

フォーカスが古い画面の場所に残る。
`pushState()`が変更するのは、セッション履歴とURLだけです。スクリプト
が画面を切り替えても、キーボードフォーカスはクリックしたリンクに残る
か、それを保持していた要素を削除すると失われます。新しい画面が表示さ
れたことも、ページが通知しなければ支援技術には伝わりません。例のよう
に、タイトルを設定し、新しい画面の見出しへフォーカスを移してくださ
い。Navigation
APIは、この処理をより多く引き受けます。`intercept()`で処理するナビ
ゲーションは、既定で、`autofocus`を持つ最初の要素か、なければbodyへ
フォーカスを移します。ハンドラーが終わると、ブラウザーは利用者へ完了
を通知します。標準は、そこに支援技術も含まれるとしています。アプリ自
身でフォーカスを置く場合は、`focusReset:
"manual"`でこの動作を無効にします。

すべての負担が最初に集中する。
厳密なSPAは、何かを操作できるようになるまで大量のJavaScriptを読み込
む必要があることが多く、最初のデータリクエストも、そのコードが動いて
からでなければ始まりません。ルートごとにバンドルを分割して、現在の画
面に必要なものだけをダウンロードさせ、最初のリクエストはサーバー側で
開始してください。Next.jsの対応パターンでは、Server
Componentでデータ取得を開始し、完了を待たずにPromiseをClient
Componentへ渡し、そこで`use()`によって値を取り出します。アプリの残り
を描画する前にリクエストが始まるので、ガイドによれば、レスポンスは直
ちにストリーミングを開始でき、クライアントは、それぞれが前の完了を待
つリクエストの連鎖を避けられます。

参考資料

  * Next.jsでシングルページアプリケーションを構築する方法 —
厳密なSPAの定義、その負担、クライアント側のナビゲーションを維持しな
がら処理をサーバーへ移すNext.jsのパターンを説明しています。

  * HTML Standard：Historyインターフェース —
`pushState()`、`replaceState()`、セッション履歴の項目を追加、置換す
る仕組みを定めています。

  * HTML Standard：Navigation API —
`navigate`イベント、`intercept()`、それに伴うフォーカスとスクロール
の処理を定めています。

  * Next.jsアプリケーションの静的エクスポートを作成する方法 —
ルートごとのHTMLファイル、静的エクスポートではできないこと、nginxに
よる拡張子のないURLの配信を説明しています。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/single-page-application/	engineer.company	70
