単一ページアプリケーション(SPA)により、Web サイトのユーザーに魅力的なエクスペリエンスを提供することができます。開発者は SPA フレームワークを使用してサイトを構築したいと考え、作成者はそうして構築されたサイトのコンテンツを AEM 内でシームレスに編集したいと考えています。
SPA エディターには、AEM 内で SPA をサポートするための包括的なソリューションが用意されています。この記事では、基本的な SPA アプリケーションを使用したオーサリングの手順を説明し、基礎となる AEM SPA エディターとの関連を示します。
SPA Editor は、SPAフレームワークベースのクライアントサイドレンダリング (React やAngularなど ) が必要なプロジェクトで推奨されるソリューションです。
この記事では、SPA エディターのガイドに進む前に、簡単な SPA アプリケーションを使用して基本的なコンテンツ編集のデモを行うことで、SPA の基本的な概念について説明します。次に、ページの構築、SPA アプリケーションと AEM SPA エディターとの関連とやり取りの仕組みについて説明します。
この概要とガイドの目標は、SPA が注目される理由、その一般的な動作、AEM エディターでの SPA の処理方法、標準の AEM アプリケーションとの違いを AEM 開発者に示すことです。
このガイドは、標準的な AEM 機能と、サンプルの WKND SPA Project アプリに基づいています。このチュートリアルを行うには、次の機能を使用できる必要があります。
wknd-spa-react.all.classic-X.Y.Z-SNAPSHOT.zip
のようになります。wknd-spa-sample-images-X.Y.Z.zip
のようになります。このドキュメントでは、WKND SPA プロジェクトアプリをデモンストレーション用としてのみ使用します。どのプロジェクト作業にも使用しないでください。
任意のAEMプロジェクトでは、 AEMプロジェクトアーキタイプ は、React またはAngularを使用するSPAプロジェクトをサポートし、SPA SDK を使用します。
単一ページアプリケーション(SPA)は、クライアントサイドでレンダリングされ、主に JavaScript 主導であり、Ajax 呼び出しに依存してデータを読み込み、ページを動的に更新する点で、従来のページとは異なります。ほぼすべてのコンテンツは、1 回のページ読み込みで 1 回取得され、ユーザーによるページとのやり取りに基づいて、必要に応じて追加のリソースが非同期に読み込まれます。
これにより、ページを更新する必要が減り、シームレスで高速な、ネイティブアプリのエクスペリエンスに近いものをユーザーに提供できます。
AEM SPA エディターを使用すると、フロントエンド開発者は AEM のサイトに統合できる SPA を作成でき、コンテンツ作成者は SPA コンテンツを他の AEM コンテンツと同様に簡単に編集できます。
より速く、流動的で、よりネイティブアプリケーションに近い SPA は、Web ページの訪問者だけでなく、SPA の仕組みの性質上、マーケターや開発者にとっても非常に魅力的なエクスペリエンスとなります。
訪問者数
マーケター
開発者
SPAの背後にある主な考え方は、SPAがネイティブアプリケーションの応答性に近づくように、サーバー呼び出しによる遅延を最小限に抑えるために、サーバーの呼び出しと依存関係を減らすことです。
従来のシーケンシャルな Web ページでは、そのページに必要なデータのみが読み込まれます。つまり、訪問者が別のページに移動すると、サーバーが追加のリソースを呼び出します。訪問者がページ上の要素を操作する際に、追加の呼び出しが必要になる場合があります。これらの複数の呼び出しでは、ページが訪問者のリクエストに追いつく必要があるので、遅いという感覚を与える可能性があります。
訪問者がモバイルやネイティブアプリから期待する動作に近い、より流動的なエクスペリエンスを実現するために、SPA は、最初の読み込み時に訪問者に必要なすべてのデータを読み込みます。最初は少し時間がかかる場合がありますが、その後はサーバーコールを追加する必要はありません。
クライアントサイドでレンダリングすると、ページ要素の反応が速くなり、訪問者によるページとのやり取りが即時に行われます。ページの速度を最大化するために、必要になる可能性のある追加データはすべて非同期で呼び出されます。
AEM での SPA の動作の技術的な詳細については、AEM での SPA の概要の記事を参照してください。
SPA Editor のデザイン、アーキテクチャ、技術的なワークフローについて詳しくは、SPA Editor の概要の記事を参照してください。
AEM SPA Editor を使用するSPAが構築されている場合、コンテンツ作成者は、コンテンツの編集と作成の際に違いを認識しません。 共通の AEM 機能を利用でき、作成者のワークフローに変更を加える必要はありません。
AEM で WKND SPA Project アプリを編集します。
http://<host>:<port>/editor.html/content/wknd-spa-react/us/en/home.html
見出しコンポーネントを選択すると、他のコンポーネントと同様にツールバーが表示されます。「編集」を選択します。
AEM内でコンテンツを通常どおりに編集します。変更が保持されます。
インプレーステキストエディターと SPA について詳しくは、SPA Editor の概要を参照してください。
アセットブラウザーを使用して、新しい画像を画像コンポーネントにドラッグ&ドロップします。
変更が保持されます。
追加のコンポーネントをページにドラッグ&ドロップしたり、コンポーネントを並べ替えたり、レイアウトを変更したりするなどのオーサリングツールは、SPA 以外のどの アプリケーションでもサポートされます。
SPA エディターは、アプリケーションの DOM を変更しません。SPA 自体が DOM を管理します。
この機能を確認するには、この記事の次の節、SPA アプリと AEM SPA エディターに進みます。
SPA がエンドユーザーにとってどのように動作するかを体験してから SPA ページを調べると、SPA アプリと AEM の SPA Editor が連携する仕組みをより深く理解できます。
WKND SPA Project アプリを公開サーバーで読み込むか、ページエディターのページ情報メニューから「公開済みとして表示」オプションを使用して読み込みます。
http://<host>:<port>/content/wknd-spa-react/us/en/home.html
子ページへのナビゲーション、天気ウィジェット、記事などを含むページ構造があります。
メニューを使用して子ページに移動し、ページが読み込まれるのを確認します。更新は必要ありません。
ブラウザーに組み込まれている開発者ツールを開き、子ページを移動しながらネットワークアクティビティを監視します。
アプリ内でページ間を移動する際のトラフィック量は非常に少なくなります。ページのリロードは行われず、新しい画像のみが要求されます。
SPA はコンテンツとルーティングを完全にクライアントサイドで管理します。
子ページをナビゲートする際にページがリロードされないとすると、どのように読み込まれるのでしょうか。
次の節の SPA アプリケーションの読み込みでは、SPA を読み込む仕組みと、コンテンツを同期や非同期で読み込み方法を詳しく説明します。
読み込みがまだの場合は、WKND SPA アプリケーションを公開サーバーに読み込むか、ページエディターのページ情報メニューから「公開済みとして表示」オプションを使用して読み込みます。
http://<host>:<port>/content/wknd-spa-react/us/en/home.html
ブラウザーの組み込みツールを使用して、ページのソースを表示します。
ソースのコンテンツは非常に制限されています。
clientlib-react.min.js
などの様々なスクリプトの呼び出しで構成されます。ブラウザーに組み込まれているツールを使用して、ページを調べます。完全に読み込まれた DOM のコンテンツを表示します。
開発者ツールの「ネットワーク」タブに切り替えて、ページをリロードします。
イメージリクエストを無視した場合、ページに対して読み込まれるプライマリリソースは、ページ自体、CSS、React JavaScript、その依存関係、およびページの JSON データです。
react.model.json
を新しいタブに読み込みます。
http://<host>:<port>/content/wknd-spa-react/us/en/home.model.json
AEM SPA エディターは、AEM コンテンツサービスを利用して、ページのコンテンツ全体を JSON モデルとして配信します。
特定のインターフェイスを実装することで、Sling Model は SPA に必要な情報を提供します。JSON データの配信は、各コンポーネントに下方向にデリゲートされます(ページから段落、コンポーネントなど)。
各コンポーネントは、表示内容とレンダリング方法を選択します(HTL を使用するサーバーサイド、または React を使用するクライアントサイド)。この記事では、React を使用したクライアントサイドのレンダリングについて説明します。
このモデルでは、ページを同期して読み込むように複数のページをグループ化できるので、必要なページ再読み込み数を減らせます。
WKND SPA Project アプリケーションの例では、訪問者は一般的にこれらのすべてのページを訪問するので、home
、page-1
、page-2
、page-3
ページは同期して読み込まれます。
この動作は必須ではなく、完全に定義可能です。
この動作の違いを表示するには、 ページを再読み込みし、開発者ツールのネットワークアクティビティをクリアします。ページメニューの page-1
に移動し、page-1
のイメージのリクエストが唯一のネットワークアクティビティであることを確認します。page-1
自体は読み込む必要はありません。
サンプルの WKND SPA Project アプリケーションを使用すると、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 Editor は、どの編集可能な設定がコンポーネントに関連付けられているかを判断し、正しいフレームやツールバーなどを読み込むようにします。
また、プレースホルダのマーキングやアセットのドラッグ&ドロップ機能用に、いくつかの特定のクラス名が追加されています。
これは、編集可能な各コンポーネントに cq
要素が挿入される AEM のサーバーサイドレンダリングページからの、動作の変更点です。
SPA のこのアプローチにより、カスタム要素を挿入する必要がなくなります。依存するのは追加のデータ属性のみのため、フロントエンド開発者にとってマークアップが簡単になります。
AEM での SPA の編集エクスペリエンスと、SPA と SPA エディターとの関係を理解したら、SPA の構築方法を深く掘り下げます。