O componente RemotePage

Ao decidir qual nível de integração você gostaria de ter entre seu SPA externo e o AEM, geralmente fica claro que é necessário visualizar e editar o SPA no AEM. O Componente RemotePage é um componente de página personalizado apenas para essa finalidade.

Visão geral

O componente RemotePage obtém todos os ativos necessários do asset-manifest.json gerado pelo aplicativo e o usa para renderizar o SPA no AEM.

  • A RemotePage permite inserir os scripts e as folhas de estilos de um SPA no corpo de um componente Página AEM.
  • Os Componentes do Frente Virtual permitem marcar seções como editáveis AEM Editor de SPA.
  • Juntos, um SPA hospedado em um domínio diferente pode ser editado no AEM.

Consulte o artigo Editar um SPA externo no AEM para obter mais detalhes sobre SPA editáveis e externas no AEM.

Requisitos

  • Habilitar CORS no desenvolvimento

  • Configurar o URL remoto nas Propriedades da página

  • Renderizar a SPA em AEM

  • A aplicação Web deve usar um manifesto de ativo do pacote como um dos itens a seguir e expor um arquivo asset-manifest.json na raiz do domínio que lista em uma propriedade de pontos de entrada todos os arquivos CSS e JS que devem ser carregados:

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

    Entrypoints

  • O aplicativo deve ser capaz de inicializar em um <div id="root"></div> abaixo do elemento de corpo. Se uma marcação diferente for esperada para o aplicativo instanciar, ela deverá ser ajustada adequadamente nos scripts HTL do componente proxy que tem um sling:resourceSuperType="spa-project-core/components/remotepage.

Limitações

  • A implementação atual do componente RemotePage suporta apenas aplicações de Reação Remota.
  • O CSS interno definido no arquivo HTML raiz do aplicativo, bem como o CSS em linha no nó DOM raiz, não estarão disponíveis ao fazer a renderização remota no AEM.

Detalhes técnicos

Como o resto do projeto de SPA de AEM, o Componente RemotePage é de código aberto. Para obter os detalhes técnicos completos do Componente RemotePage, consulte o repositório GitHub.

Nesta página