Enrutamiento de modelo SPA

Para las aplicaciones de una sola página en AEM, la aplicación es responsable del enrutamiento. Este documento describe el mecanismo de enrutamiento, el contrato y las opciones disponibles.

Enrutamiento de proyectos

La aplicación es propietaria del enrutamiento y luego los desarrolladores del front-end del proyecto la implementan. Este documento describe el enrutamiento específico del modelo devuelto por el servidor AEM. La estructura de datos del modelo de página expone la dirección URL del recurso subyacente. El proyecto front-end puede utilizar cualquier biblioteca personalizada o de terceros que proporcione funcionalidades de enrutamiento. Una vez que una ruta espera un fragmento de modelo, una llamada a la función PageModelManager.getData() se puede realizar. Cuando la ruta de un modelo ha cambiado, se debe activar un evento para advertir a bibliotecas de escucha como el Editor de páginas.

Arquitectura

Para obtener una descripción detallada, consulte la PageModelManager del documento Modelo de SPA.

ModelRouter

La variable ModelRouter - cuando está habilitado - encapsula las funciones de la API History de HTML5 pushState y replaceState para garantizar que un fragmento determinado del modelo es accesible y se obtiene previamente. A continuación, notifica al componente frontal registrado que el modelo se ha modificado.

Enrutamiento manual frente al modelo automático

La variable ModelRouter automatiza la recuperación de fragmentos del modelo. Pero como cualquier herramienta automatizada viene con limitaciones. Cuando sea necesario, la variable ModelRouter puede deshabilitarse o configurarse para ignorar las rutas mediante meta propiedades (consulte la sección Meta propiedades de la sección Componente de página SPA documento). Los desarrolladores de front-end pueden implementar su propia capa de enrutamiento de modelo solicitando la PageModelManager para cargar cualquier fragmento de modelo determinado mediante la variable getData() función.

PRECAUCIÓN

La versión actual de ModelRouter solo admiten el uso de direcciones URL que apunten a la ruta de recurso real de los puntos de entrada del modelo Sling. No admite el uso de URL o alias de Vanity.

Contrato de enrutamiento

La implementación actual se basa en el supuesto de que el proyecto SPA utiliza la API de historial de HTML5 para enrutar a las diferentes páginas de aplicación.

Configuración

La variable ModelRouter admite el concepto de enrutamiento de modelo a medida que escucha pushState y replaceState llamadas a para recuperar previamente fragmentos de modelo. Internamente déclencheur el PageModelManager para cargar el modelo que corresponde a una URL determinada y activa un cq-pagemodel-route-changed que otros módulos pueden escuchar.

De forma predeterminada, este comportamiento se activa automáticamente. Para deshabilitarlo, el SPA debe renderizar la siguiente meta propiedad:

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

Tenga en cuenta que cada ruta del SPA debe corresponder a un recurso accesible en AEM (por ejemplo, " /content/mysite/mypage") desde el PageModelManager intentará cargar automáticamente el modelo de página correspondiente una vez seleccionada la ruta. Aunque, si es necesario, el SPA también puede definir una “lista de bloqueados” de rutas que el PageModelManager:

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

En esta página