O componente RemotePage

Ao decidir que nível de integração você gostaria de ter entre suas SPA externas e AEM, geralmente fica claro que é necessário visualizar e editar o SPA dentro do 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 seguintes e expor um arquivo asset-manifest.json na raiz de domínio que lista em entrypoints property 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

      exemplo da propriedade entrypoints

  • O aplicativo deve ser capaz de inicializar em um <div id="root"></div> abaixo do elemento body. 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