RemotePage 组件 remote-page-component
在决定您希望在外部SPA与AEM之间进行何种级别的集成时,通常很明显您需要能够查看和编辑AEM中的SPA。 RemotePage组件只是用于此目的的自定义页面组件。
概述 overview
RemotePage组件从应用程序生成的asset-manifest.json
中获取所有必需的资源,并使用此资源在AEM中呈现SPA。
- RemotePage允许您将SPA的脚本和样式表插入AEM Page组件的正文中。
- 虚拟前端组件允许在AEM SPA编辑器中将部分标记为可编辑。
- 托管在不同域上的SPA可以一起在AEM中编辑。
有关AEM中可编辑的外部SPA的更多详细信息,请参阅文章在AEM中编辑外部SPA。
要求 requirements
-
在开发中启用CORS
-
在页面属性中配置远程URL
-
在AEM中渲染SPA
-
Web应用程序必须使用类似于以下内容的绑定器资产清单,并在域根目录处公开一个
asset-manifest.json
文件,该文件在entrypoints property
中列出了所有要加载的CSS和JS文件:-
https://github.com/shellscape/webpack-manifest-plugin
-
https://github.com/webdeveric/webpack-assets-manifest
-
https://github.com/mugi-uno/parcel-plugin-bundle-manifest
-
-
应用程序必须能够在
body
元素下的<div id="root"></div>
中初始化。 如果应用程序需要不同的标记才能实例化,则必须在具有sling:resourceSuperType="spa-project-core/components/remotepage
的代理组件的HTL脚本中相应地调整此标记。
限制 limitations
- RemotePage组件希望该实施提供与此处所找到的类似的资产清单。但是,RemotePage组件仅经过测试可用于React框架(和通过remote-page-next组件的Next.js),因此不支持从其他框架(如Angular)远程加载应用程序。
- 在AEM中执行远程渲染时,在应用程序的根HTML文件中定义的内部CSS和根DOM节点上的内联CSS将不可用。
技术详细信息 technical-details
与AEM SPA项目的其余部分一样,RemotePage组件是开源的。 有关RemotePage组件的完整技术详细信息,请参阅GitHub存储库。