Componente RemotePage

Quando si decide quale livello di integrazione vorresti avere una relazione tra il tuo SPA esterno e l'AEM, spesso è chiaro che devi essere in grado di visualizzare e modificare l'SPA all'interno dell'AEM. Il componente RemotePage è un componente pagina personalizzato appositamente per questo scopo.

Panoramica

Il componente RemotePage recupera tutte le risorse necessarie dal file asset-manifest.json e lo usa per rendere l'SPA all'interno dell'AEM.

  • RemotePage consente di inserire gli script e i fogli di stile di un SPA nel corpo di un componente Pagina AEM.
  • I componenti front-end virtuali consentono di contrassegnare le sezioni come modificabili nell’editor SPA dell’AEM.
  • Insieme, un SPA ospitato su un dominio diverso può essere reso modificabile in AEM.

Vedi l’articolo Modifica di un SPA esterno all’interno dell’AEM per maggiori dettagli sull'SPA esterno modificabile nell'AEM.

Requisiti

  • Abilitare CORS nello sviluppo
  • Configurare l’URL remoto nelle Proprietà pagina
  • Rendere l’SPA nell’AEM
  • L’applicazione web deve utilizzare un manifesto della risorsa del bundler come uno dei seguenti ed esporre un asset-manifest.json file nella directory principale del dominio che elenca in un entrypoints property tutti i file CSS e JS da caricare:

    • https://github.com/shellscape/webpack-manifest-plugin

    • https://github.com/webdeveric/webpack-assets-manifest

    • https://github.com/mugi-uno/parcel-plugin-bundle-manifest

      esempio di proprietà entrypoints

  • L’applicazione deve essere in grado di inizializzare in un <div id="root"></div> sotto il body elemento. Se è previsto un markup diverso per la creazione dell’istanza da parte dell’app, questo deve essere regolato di conseguenza negli script HTL del componente proxy che ha sling:resourceSuperType="spa-project-core/components/remotepage.

Limitazioni

  • Il componente RemotePage prevede che l’implementazione fornisca un manifesto delle risorse come quello trovato qui. Il componente RemotePage, tuttavia, è stato testato per funzionare solo con il framework React (e Next.js tramite il componente remote-page-next ) e pertanto non supporta il caricamento remoto di applicazioni da altri framework, come ad Angular.
  • I CSS interni definiti nel file HTML principale dell’applicazione e i CSS in linea sul nodo DOM principale non saranno disponibili durante il rendering remoto nell’AEM.

Dettagli tecnici

Come il resto del progetto SPA dell’AEM, il componente RemotePage è open source. Per informazioni tecniche complete sul componente RemotePage, vedi l’archivio GitHub.

In questa pagina