SPA の概要およびガイド spa-introduction
単一ページアプリケーション(SPA)により、Web サイトのユーザーに魅力的なエクスペリエンスを提供することができます。 開発者は SPA フレームワークを使用してサイトを構築したいと考え、作成者はそうして構築されたサイトのコンテンツを AEM 内でシームレスに編集したいと考えています。
SPA エディターには、AEM 内で SPA をサポートするための包括的なソリューションが用意されています。 この記事では、基本的な SPA アプリケーションを使用したオーサリングの手順を説明し、基礎となる AEM SPA エディターとの関連を示します。
- ヘッドレスコンテンツを視覚的に編集するユニバーサルエディター。
- ヘッドレスコンテンツをフォームベースで編集するコンテンツフラグメントエディター。
はじめに introduction
記事の目的 article-objective
この記事では、まず SPA の基本的な概念を説明し、その後、簡単な SPA アプリケーションを使用して基本的なコンテンツ編集をデモしながら、SPA エディターのウォークスルーを行います。 次に、ページの構築、SPA アプリケーションと AEM SPA エディターとの関連とやり取りの仕組みについて説明します。
この概要とガイドの目的は、SPA がなぜ重要なのか、その一般的な動作、SPA が AEM SPA エディターによってどのように処理されるのか、そして標準的な AEM アプリケーションとどのように異なるのかを、AEM 開発者に示すことです。
要件 requirements
このガイドは、標準的な AEM 機能と、サンプルの WKND SPA Project アプリに基づいています。 このチュートリアルに沿って操作を進めるには、次の項目を利用できる必要があります。
-
- ローカル開発環境として実行する必要があります。
- システムの管理者権限が必要です。
-
GitHubで利用可能なサンプル WKND SPA プロジェクトアプリ
wknd-spa-react.all-X.Y.Z-SNAPSHOT.zipに類似した名前の React アプリの最新リリースをダウンロードします。wknd-spa-sample-images-X.Y.Z.zipに類似した名前のアプリの最新サンプル画像をダウンロードします。- パッケージマネージャーを使用して、AEM の他のパッケージと同様に両方のパッケージをインストールします。
- このチュートリアルの目的では、Maven を使用してアプリをインストールする必要はありません。
SPA とは? what-is-a-spa
単一ページアプリケーション(SPA)は、クライアントサイドでレンダリングされ、主に JavaScript 主導であり、Ajax 呼び出しに依存してデータを読み込み、ページを動的に更新する点で、従来のページとは異なります。 ほぼすべてのコンテンツは、1 回のページ読み込みで 1 回取得され、ユーザーによるページとのやり取りに基づいて、必要に応じて追加のリソースが非同期に読み込まれます。
これにより、ページを更新する必要が減り、シームレスで高速な、ネイティブアプリのエクスペリエンスに近いものをユーザーに提供できます。
AEM SPA エディターを使用すると、フロントエンド開発者は AEM のサイトに統合できる SPA を作成でき、コンテンツ作成者は SPA コンテンツを他の AEM コンテンツと同様に簡単に編集できます。
SPA が注目される理由 why-a-spa
より速く、流動的で、よりネイティブアプリケーションに近い SPA は、Web ページの訪問者だけでなく、SPA の仕組みの性質上、マーケターや開発者にとっても非常に魅力的なエクスペリエンスとなります。
訪問者数 visitors
- 訪問者は、コンテンツとのやり取りでネイティブなエクスペリエンスを求めています。
- ページが速くなればなるほど、コンバージョンが発生する可能性が高いという明確なデータがあります。
マーケター marketers
- マーケターは、リッチでネイティブに近いエクスペリエンスをオファーして、訪問者のコンテンツに対する十分なエンゲージを獲得したいと考えています。
- パーソナライゼーションは、これらのエクスペリエンスをさらに魅力的にします。
デベロッパー向け developers
- 開発者は、コンテンツとプレゼンテーションの間の懸念事項を明確に分けておきたいと考えています。
- 明確に分離することで、システムの拡張性が向上し、独立したフロントエンド開発が可能になります。
SPA の仕組み? how-does-a-spa-work
SPA の背後にある主な考え方は、SPA がネイティブアプリケーションの応答性に近づくように、サーバーに起因する遅延を最小限に抑えるために、サーバーへの呼び出しと依存性を低減することです。
従来のシーケンシャルな Web ページでは、そのページに必要なデータのみが読み込まれます。 つまり、訪問者が別のページに移動すると、サーバーが追加のリソースを呼び出します。 訪問者がページ上の要素を操作する際に、追加の呼び出しが必要になる場合があります。 これらの複数の呼び出しにより、ページが訪問者のリクエストに追いつく必要があるため、ラグや遅延が生じているように感じられる場合があります。
訪問者がモバイルやネイティブアプリから期待する動作に近い、より流動的なエクスペリエンスを実現するために、SPA は、最初の読み込み時に訪問者に必要なすべてのデータを読み込みます。 最初は少し時間がかかる場合がありますが、その後はサーバーコールを追加する必要はありません。
クライアントサイドでレンダリングすると、ページ要素の反応が速くなり、訪問者によるページとのやり取りが即時に行われます。 ページの速度を最大化するために、必要になる可能性のある追加データはすべて非同期で呼び出されます。
SPA でのコンテンツ編集エクスペリエンス content-editing-experience-with-spa
AEM SPA エディターを活用する SPA が構築されている場合、コンテンツ作成者はコンテンツの編集と作成の際に違いを認識しません。 共通の AEM 機能を利用でき、作成者のワークフローに変更を加える必要はありません。
-
AEM で WKND SPA Project アプリを編集します。
http://localhost:4502/editor.html/content/wknd-spa-react/us/en/home.html
-
テキストコンポーネントを選択すると、他のコンポーネントと同様にツールバーが表示されます。 「編集」を選択します。
-
AEM 内でコンテンツを通常どおりに編集します。変更内容が保持されることに注意してください。
-
アセットブラウザーを使用して、新しい画像を画像コンポーネントにドラッグ&ドロップします。
-
変更が保持されます。
追加のコンポーネントをページにドラッグ&ドロップしたり、コンポーネントを並べ替えたり、レイアウトを変更したりするなどのオーサリングツールは、SPA 以外のどの AEM アプリケーションでもサポートされます。
SPA アプリと AEM SPA エディター spa-apps-and-the-aem-spa-editor
ユーザーにとってSPAがどのように動作するかを経験してから、SPA ページを調査すると、SAP アプリが AEM の SPA エディターと連携する仕組みをより深く理解できます。
SPA アプリケーションの使用 using-an-spa-application
-
WKND SPA Project アプリを公開サーバーで読み込むか、ページエディターの ページ情報 メニューから「公開済みとして表示」オプションを使用して読み込みます。
http://<host>:<port>/content/wknd-spa-react/us/en/home.html
子ページへのナビゲーション、メニュー、記事カードなど、ページ構造をメモしておきます。
-
メニューを使用して子ページに移動し、ページが読み込まれるのを確認します。更新は必要ありません。
-
ブラウザーのビルトインの開発者ツールを開き、子ページを移動しながらネットワークアクティビティを監視します。
アプリ内でページ間を移動する際のトラフィック量は非常に少なくなります。 ページのリロードは行われず、新しい画像のみが要求されます。
SPA はコンテンツとルーティングを完全にクライアントサイドで管理します。
子ページをナビゲートする際にページがリロードされないとすると、どのように読み込まれるのでしょうか。
次の節 SPA アプリケーションの読み込みでは、SPA の読み込みの仕組みと、コンテンツの同期および非同の読み込み方法を詳しく説明します。
SPA アプリケーションの読み込み loading-a-spa-application
-
読み込みがまだの場合は、WKND SPA アプリケーションを公開サーバーに読み込むか、ページエディターの ページ情報 メニューから「公開済みとして表示」オプションを使用して読み込みます。
http://<host>:<port>/content/wknd-spa-react/us/en/home.html
-
ブラウザーのビルトインのツールを使用して、ページのソースを表示します。
-
ソースのコンテンツは制限されます。
- ページの本文にはコンテンツが含まれていません。 ページは主に、スタイルシートと、
clientlib-react.min.jsなどの様々なスクリプトの呼び出しで構成されます。 - これらのスクリプトは、このアプリケーションのプライマリドライバーであり、すべてのコンテンツのレンダリングを担当します。
- ページの本文にはコンテンツが含まれていません。 ページは主に、スタイルシートと、
-
ブラウザーのビルトインのツールを使用して、ページを調べます。 完全に読み込まれた DOM のコンテンツを表示します。
-
インスペクターの「ネットワーク」タブに切り替えて、ページを再読み込みします。
イメージリクエストを無視した場合、ページに対して読み込まれるプライマリリソースは、ページ、CSS、React Javascript、その依存関係およびページの JSON データです。
-
home.model.jsonを新しいタブに読み込みます。http://<host>:<port>/content/wknd-spa-react/us/en/home.model.json
AEM SPA エディターは、AEM コンテンツサービスを利用して、ページのコンテンツ全体を JSON モデルとして配信します。
特定のインターフェイスを実装することで、Sling Model は SPA に必要な情報を提供します。 JSON データの配信は、ページ、段落、コンポーネントといった各コンポーネントへと順に委譲されます。
各コンポーネントは、表示内容とレンダリング方法を選択します(HTL を使用するサーバーサイド、または React や Angular を使用するクライアントサイド)。 この記事では、React を使用したクライアントサイドのレンダリングについて説明します。
-
このモデルでは、複数のページをグループ化して同期的に読み込むことができるため、必要なページ再読み込みの回数を減らせます。
WKND SPA Project アプリケーションの例では、訪問者は一般的にこれらのすべてのページを訪問するので、
home、page-1、page-2、page-3ページは同期して読み込まれます。この動作は必須ではなく、完全に定義可能です。
-
この動作の違いを表示するには、
homeページを再読み込みし、インスペクターのネットワークアクティビティをクリアします。 ページメニューのpage-1に移動し、page-1のイメージのリクエストが唯一のネットワークアクティビティであることを確認します。page-1自体は読み込む必要はありません。
SPA エディターとのインタラクション interaction-with-the-spa-editor
サンプルの WKND SPA プロジェクトアプリケーションを使用すると、JSON コンテンツ配信のためのコンテンツサービスとリソースの非同期読み込みを利用して、アプリケーションが公開時にどのように動作し、読み込まれるかが明確にわかります。
また、コンテンツ作成者は、SPA エディターを使用したコンテンツを AEM 内でシームレスに作成できます。
次のセクションでは、SPA エディターが SPA 内のコンポーネントを AEM コンポーネントに関連付け、このシームレスな編集エクスペリエンスを実現できるようにするためのコントラクトについて説明します。
-
エディターで WKND SPA Project アプリケーションを読み込み、プレビューモードに切り替えます。
http://<host>:<port>/editor.html/content/wknd-spa-react/us/en/home.html -
ブラウザーのビルトインの開発者ツールを使用して、ページのコンテンツを調べます。 選択ツールを使用して、ページ上の編集可能なコンポーネントを選択し、その要素の詳細を表示します。
コンポーネントには新しいデータ属性
data-cq-data-pathがあります。
例:
data-cq-data-path="/content/wknd-spa-react/us/en/home/jcr:content/root/responsivegrid/textこのパスは、各コンポーネントの編集コンテキスト設定オブジェクトの取得と関連付けを可能にします。
これは、SPA 内の編集可能なコンポーネントとして、エディターが認識するために必要なマークアップ属性です。 この属性に基づいて、SPA エディターは、どの編集可能な設定がコンポーネントに関連付けられているかを判断し、正しいフレームやツールバーなどが読み込まれます。
また、プレースホルダのマーキングやアセットのドラッグ&ドロップ機能用に、いくつかの特定のクラス名が追加されています。
note NOTE この動作は、編集可能な各コンポーネントに cq要素が挿入される AEM のサーバーサイドレンダリングページとは異なります。SPA エディターのこの手法により、カスタム要素を挿入する必要がなくなり、依存するのは追加のデータ属性のみなので、フロントエンド開発者にとってマークアップが簡単になります。
AEM におけるヘッドフルとヘッドレス headful-headless
SPA は、AEM の外部で開発されて保守される SPA を含む、AEM 内の柔軟なレベルの統合で有効にできます。 さらに、SPA は AEM 内で活用でき、AEM を使用して、追加のエンドポイントにヘッドレスにコンテンツを配信することもできます。
次の手順 next-steps
AEM での SPA の編集エクスペリエンスと、SPA と SPA エディターとの関係を理解したら、SPA の構築方法を深く掘り下げます。
- React を使用した AEM での SPA の概要では、SPA エディターで動作する基本的な SPA の構築方法を示しています
- Angular を使用した AEM での SPA の概要では、Angular を使用して SPA エディターで動作する基本的な SPA の構築方法を示しています
- SPA エディターの概要では、AEM と SPA 間の通信モデルをより深く分析しています。
- AEM 向け SPA の開発では、フロントエンド開発者を AEM 向け SPA の開発に関与させる方法、および SPA と AEM アーキテクチャとのやり取りについて説明しています。