SPA模型路由

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

項目路由

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

架構

如需詳細說明,請參閱SPA Blueprint檔案的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="disable"\>

請注意,SPA的每條路由都應對應至AEM中的可存取資源(例如" /content/mysite/mypage"),因為一旦選取路由,PageModelManager會自動嘗試載入對應的頁面模型。 不過,如有需要,SPA也可以定義應由PageModelManager忽略的路由的「塊清單」:

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

本頁內容