RemotePage 元件

上次更新: 2023-11-07
  • 主題:
  • Developing
    檢視有關此主題的更多資訊
  • 建立對象:
  • Developer

在決定您要在外部SPA和AEM之間進行的整合層級時,您通常明顯需要能夠檢視和編輯AEM中的SPA。 RemotePage元件是僅用於此目的的自訂頁面元件。

概觀

RemotePage元件會從應用程式產生的擷取所有必要的資產 asset-manifest.json 和用來在AEM中轉譯SPA。

  • RemotePage可讓您將SPA的指令碼和樣式表插入AEM Page元件的內文中。
  • 虛擬前端元件允許在AEM SPA編輯器中將區段標示為可編輯。
  • 將託管在不同網域上的SPA放在一起,即可在AEM中編輯。

請參閱文章 在AEM內編輯外部SPA 以進一步瞭解AEM中可編輯的外部SPA。

要求

  • 在開發中啟用CORS

  • 在頁面屬性中設定遠端URL

  • 在AEM中轉譯SPA

  • Web應用程式必須使用類似下列其中一種的套件組合資產資訊清單,並在網域根目錄公開asset-manifest.json檔案,該檔案會在entrypoints屬性中列出所有要載入的CSS和JS檔案:

    • https://github.com/shellscape/webpack-manifest-plugin
    • https://github.com/webdeveric/webpack-assets-manifest
    • https://github.com/mugi-uno/parcel-plugin-bundle-manifest

    進入點

  • 應用程式必須能夠在 <div id="root"></div> 主體元素底下。 如果應用程式需要不同的標籤才能具現化,則必須在具有的Proxy元件的HTL指令碼中據以調整 sling:resourceSuperType="spa-project-core/components/remotepage.

限制

  • RemotePage元件預期實作會提供如下的資產資訊清單 可在此處找到。 不過,RemotePage元件僅通過測試可用於React架構(以及透過remote-page-next元件的Next.js),因此不支援從其他架構(例如Angular)從遠端載入應用程式。
  • 在AEM中執行遠端轉譯時,在應用程式的根HTML檔案中定義的內部CSS以及根DOM節點上的內嵌CSS將不可用。

技術細節

如同其他的AEM SPA專案,RemotePage元件是開放原始碼。 如需RemotePage元件的完整技術細節, 請參閱GitHub存放庫。

此頁面上的