Componente RemotePage remote-page-component

Quando decidi quale livello di integrazione desideri avere tra l'applicazione a pagina singola esterna e AEM, spesso è chiaro che devi essere in grado di visualizzare e modificare l'applicazione a pagina singola in AEM. Il componente RemotePage è un componente pagina personalizzato appositamente per questo scopo.

IMPORTANT
L'editor per applicazioni a pagina singola (o editor SPA) è stato dichiarato obsoleto per i nuovi progetti. Continua a essere supportato da Adobe per i progetti esistenti, ma non dovrebbe essere utilizzato per i nuovi progetti. Gli editor preferiti per la gestione dei contenuti headless in AEM sono ora i seguenti:

Panoramica overview

Il componente RemotePage recupera tutte le risorse necessarie da asset-manifest.json generato dall'applicazione e lo utilizza per il rendering dell'applicazione a pagina singola in AEM.

  • RemotePage consente di inserire gli script e i fogli di stile di un’applicazione a pagina singola nel corpo di un componente AEM Page.
  • I componenti front-end virtuali consentono di contrassegnare le sezioni come modificabili nell’editor SPA di AEM.
  • Insieme, un’applicazione a pagina singola ospitata su un dominio diverso può essere resa modificabile in AEM.

Consulta l'articolo Modifica di un'applicazione a pagina singola esterna all'interno di AEM per ulteriori dettagli sulle applicazioni a pagina singola esterne modificabili in AEM.

Requisiti requirements

  • Abilitare CORS nello sviluppo

  • Configurare l’URL remoto nelle Proprietà pagina

  • Eseguire il rendering dell’applicazione a pagina singola in AEM

  • L'applicazione Web deve utilizzare un manifesto della risorsa del bundler come uno dei seguenti ed esporre un file asset-manifest.json 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 l'elemento body. Se è previsto un markup diverso per la creazione dell'istanza dell'app, è necessario regolarlo di conseguenza negli script HTL del componente proxy con sling:resourceSuperType="spa-project-core/components/remotepage.

Limitazioni limitations

  • Il componente RemotePage prevede che l'implementazione fornisca un manifesto di 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 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 in AEM.

Dettagli tecnici technical-details

Come il resto del progetto SPA di AEM, il componente RemotePage è open source. Per informazioni tecniche complete sul componente RemotePage, consulta l'archivio GitHub.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab