SPA模型路由

對於AEM中的單頁應用程式,應用程式負責路由。 本文檔介紹了路由機制、合同和可用選項。

項目路由

應用程式擁有路由,然後由項目前端開發人員實施。 本檔案說明AEM伺服器傳回之模型的特定路由。 頁面模型資料結構會公開基礎資源的URL。 前端專案可使用任何提供路由功能的自訂或協力廠商程式庫。 一旦路由需要模型片段,就會呼叫 PageModelManager.getData() 函式。 當模型路由變更時,必須觸發事件,以警告監聽程式庫,例如頁面編輯器。

架構

如需詳細說明,請參閱 PageModelManager 區段。

ModelRouter

ModelRouter — 啟用時 — 封裝HTML5歷史API函式 pushStatereplaceState 以確保預先擷取並存取指定的模型片段。 然後,它通知已註冊的前端元件,模型已被修改。

手動與自動模型路由

ModelRouter 自動擷取模型片段。 但是,如同任何自動化工具一樣,它有其局限性。 當需要時 ModelRouter 可以禁用或配置為使用元屬性忽略路徑(請參閱 SPA頁面元件 檔案)。 然後,前端開發人員可以請求 PageModelManager 載入模型的任何給定片段,使用 getData() 函式。

注意

的目前版本 ModelRouter 僅支援使用URL,指向Sling Model登入點的實際資源路徑。 不支援使用虛名URL或別名。

傳送合同

目前的實作以SPA專案使用HTML5歷史記錄API來路由至不同應用程式頁面的假設為基礎。

設定

ModelRouter 支援模型路由的概念,當它監聽時 pushStatereplaceState 預先擷取模型片段的呼叫。 在內部觸發 PageModelManager 載入與指定URL對應的模型,並引發 cq-pagemodel-route-changed 其他模組可監聽的事件。

依預設,會自動啟用此行為。 若要停用,SPA應呈現下列中繼屬性:

<meta property="cq:pagemodel_router" content="disabled"\>

請注意,SPA的每條路徑都應對應至AEM中可存取的資源(例如「 /content/mysite/mypage") PageModelManager 將在選取路由後,自動嘗試載入相應的頁面模型。 不過,如有需要,SPA也可以定義路由的「封鎖清單」,這些路由應被 PageModelManager:

<meta property="cq:pagemodel_route_filters" content="route/not/found,^(.*)(?:exclude/path)(.*)"/>

本頁內容