Componente de página SPA

Última actualización: 2023-06-29

SPA El componente de página para una no proporciona los elementos HTML de sus componentes secundarios a través de un archivo JSP o HTL y objetos de recurso. Esta operación se delega al marco de trabajo de las SPA. La representación de los componentes secundarios se obtiene como una estructura de datos JSON (es decir, el modelo ). SPA A continuación, se añaden los componentes de la a la página según el modelo JSON proporcionado. Como tal, la composición inicial del cuerpo del componente de página difiere de sus homólogos HTML procesados previamente.

Administración de modelos de página

La resolución y la administración del modelo de página se delegan a un PageModelManager módulo. SPA El usuario debe interactuar con la variable PageModelManager Cuando se inicializa para recuperar el modelo de página inicial y registrarse para las actualizaciones de modelo, producido principalmente cuando el autor está editando la página a través del Editor de páginas. El PageModelManager SPA es accesible para el proyecto de como paquete npm. AEM SPA Siendo intérprete entre la y la, la PageModelManager SPA está pensado para acompañar a los.

Para permitir la creación de la página, una biblioteca de cliente denominada cq.authoring.pagemodel.messaging SPA debe añadirse para proporcionar un canal de comunicación entre el editor de páginas y el editor de páginas de la. SPA Si el componente de página de la página de la hereda del componente wcm/core de la página, existen las siguientes opciones para realizar la variable cq.authoring.pagemodel.messaging categoría de biblioteca de cliente disponible:

  • Si la plantilla es editable, agregue la categoría de biblioteca de cliente a la directiva de página.
  • Añada la categoría de biblioteca de cliente mediante la variable customfooterlibs.html del componente de página.

No olvide limitar la inclusión de la variable cq.authoring.pagemodel.messaging al contexto del editor de páginas.

Tipo de datos de comunicación

El tipo de datos de comunicación se establece como un elemento de HTML AEM dentro del componente Página de la página de la mediante la variable data-cq-datatype atributo. Cuando el tipo de datos de comunicación está establecido en JSON, las solicitudes de GET llegan a los extremos del modelo Sling de un componente. Una vez que se produce una actualización de estado en el editor de páginas, la representación JSON del componente actualizado se envía a la biblioteca del Modelo de página. SPA A continuación, la biblioteca de modelo de página advierte a los usuarios de las actualizaciones que se han realizado en su.

Componente de página SPA -body.html

<div id="page"></div>

SPA Además de ser una buena práctica para no retrasar la generación de DOM, el marco de trabajo de la requiere que se añadan los scripts al final del cuerpo.

Componente de página SPA -customfooterlibs.html

<sly data-sly-use.clientLib="${'/libs/granite/sightly/templates/clientlib.html'}"></sly>
<sly data-sly-test="${wcmmode.edit || wcmmode.preview}"
     data-sly-call="${clientLib.js @ categories='cq.authoring.pagemodel.messaging'}"></sly>
<sly data-sly-call="${clientLib.js @ categories='we-retail-journal-react'}"></sly>

SPA Las propiedades del recurso meta que describen el contenido de la:

Componente de página SPA -customheaderlibs.html

<meta property="cq:datatype" data-sly-test="${wcmmode.edit || wcmmode.preview}" content="JSON"/>
<meta property="cq:wcmmode" data-sly-test="${wcmmode.edit}" content="edit"/>
<meta property="cq:wcmmode" data-sly-test="${wcmmode.preview}" content="preview"/>
<meta property="cq:pagemodel_root_url" data-sly-use.page="com.adobe.cq.sample.spa.journal.models.AppPage" content="${page.rootUrl}"/>
<sly data-sly-use.clientlib="/libs/granite/sightly/templates/clientlib.html">
    <sly data-sly-call="${clientlib.css @ categories='we-retail-journal-react'}"/>
</sly>
NOTA

El selector de modelo predeterminado se establece de forma estática al solicitar la representación del modelo Sling de un componente.

Metapropiedades

  • cq:wcmmode: modo WCM de los editores (por ejemplo, página, plantilla)
  • cq:pagemodel_root_url: URL del modelo raíz de la aplicación. Crucial al acceder directamente a una página secundaria, ya que el modelo de página secundaria es un fragmento del modelo raíz de la aplicación. El PageModelManager a continuación, recompone sistemáticamente el modelo inicial de aplicación como si entrara en la aplicación desde su punto de entrada raíz.
  • cq:pagemodel_router: habilite o deshabilite la variable ModelRouter de la PageModelManager biblioteca
  • cq:pagemodel_route_filters: Lista separada por comas o expresiones regulares para proporcionar rutas al ModelRouter debe ignorarlo.

Sincronización de superposición del editor de páginas

La sincronización de las superposiciones está garantizada por el mismo Observador de mutaciones proporcionado por el cq.authoring.page categoría.

Configuración de la estructura exportada de JSON del modelo Sling

SPA AEM Cuando las capacidades de enrutamiento están habilitadas, se supone que la exportación JSON de la aplicación contiene las diferentes rutas de la aplicación gracias a la exportación JSON del componente de navegación de la. AEM SPA La salida JSON del componente de navegación de la se puede configurar en la directiva de contenido de la página raíz de la página a través de las dos propiedades siguientes:

  • structureDepth: Número correspondiente a la profundidad del árbol exportado
  • structurePatterns: Regex de una matriz de expresiones regulares correspondientes a la página que se va a exportar

En esta página