讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

如何在 Ember 应用中集成并启动 Angular Web 组件

小枫吖_9528

小枫吖_9528

发布时间:2026-11-22 22:38:06

|

875人浏览过

|

来源于php中文网

原创

如何在 Ember 应用中集成并启动 Angular Web 组件

本文介绍如何安全、可靠地将 angular 应用作为 web component 集成到 ember 项目中,规避直接 dom 挂载导致的 ng05104 错误,并提供 angular 16+ 的标准化构建与注册方案。

本文介绍如何安全、可靠地将 angular 应用作为 web component 集成到 ember 项目中,规避直接 dom 挂载导致的 ng05104 错误,并提供 angular 16+ 的标准化构建与注册方案。

在 Ember 应用中直接通过 <app-root></app-root> 标签启动 Angular 主模块会失败(报错 NG05104: The selector "app-root" did not match any elements),根本原因在于:Angular 的默认 platformBrowserDynamic().bootstrapModule() 依赖 DOM 元素在调用时已存在且可查,而 Ember 的渲染生命周期(尤其是使用 Glimmer 或懒加载路由时)可能导致 <app-root></app-root> 节点尚未挂载或已被动态管理,造成 Angular 启动时机不匹配。

✅ 正确解法是将 Angular 应用封装为自定义 Web Component(Custom Element),利用浏览器原生的组件注册机制,使其具备独立生命周期、样式隔离和跨框架兼容性。该方式不依赖特定宿主框架的 DOM 状态,由浏览器统一调度实例化。

✅ Angular 端:构建 Web Component(Angular 16+)

  1. 启用自定义元素支持
    在 main.ts 中,使用 createCustomElement(需 @angular/elements)或更推荐的 bootstrapApplication + defineCustomElement(Angular 16.2+ 原生支持):
// main.ts
import { bootstrapApplication } from '@angular/platform-browser';
import { AppComponent } from './app/app.component';
import { config } from './app/app.config';
import { defineCustomElement } from '@angular/core';

// 1. 构建应用配置(含 providers)
const appConfig = config();

// 2. 定义自定义元素(注意:需确保 AppComponent 是 standalone)
const AngularWebComponent = defineCustomElement(AppComponent, {
  injector: appConfig.providers,
});

// 3. 注册到全局 CustomElementsRegistry
customElements.define('angular-web-app', AngularWebComponent);

⚠️ 前提:AppComponent 必须是 Standalone Component(即无 NgModule),否则需先迁移至 Standalone 模式。

  1. 更新 index.html(Angular 构建输出)
    不再需要 <app-root></app-root>;构建后生成的 main.js 会自动注册 <angular-web-app></angular-web-app> 元素。

  2. 构建命令

    ng build --configuration production --output-path dist/angular-widget

✅ Ember 端:安全集成 Web Component

  • 将 Angular 构建产物(dist/angular-widget/*.js)复制到 Ember 的 public/ 目录下(如 public/assets/angular-widget/);
  • 在 app/index.html 中按需加载脚本(建议 defer 或在 DOMContentLoaded 后加载):
<!-- public/index.html -->
<script 
  src="/assets/angular-widget/main.js" 
  type="module" 
  defer>
</script>
  • 在任意 Ember 模板中使用(无需等待 Ember 渲染完成):
<!-- app/templates/application.hbs -->
<div class="angular-integration">
  <angular-web-app 
    data-user-id={{this.currentUser.id}}
    data-theme="dark">
  </angular-web-app>
</div>

? 提示:可通过 data-* 属性向 Angular 组件传参(需在 AppComponent 中通过 inject(ElementRef) 读取 element.dataset);如需双向通信,可基于 CustomEvent 发布/订阅。

? 注意事项与最佳实践

  • ❌ 避免在 Ember 中手动调用 platformBrowserDynamic().bootstrapModule() —— 这会破坏 Web Component 封装性且易触发 NG05104;
  • ✅ 使用 type="module" 加载 Angular 构建产物,确保 ES Module 兼容性;
  • ? 样式隔离:Web Component 默认启用 Shadow DOM({ shadow: true }),若需穿透样式,可在 defineCustomElement 中显式设置 shadow: false,但需自行处理 CSS 冲突;
  • ? 性能优化:对非首屏 Angular 组件,可结合 IntersectionObserver 实现懒加载 Web Component;
  • ? 测试建议:分别验证 Angular Web Component 的独立行为(<angular-web-app></angular-web-app> 单独 HTML 页面)与 Ember 集成后的交互逻辑。

通过 Web Component 方案,Angular 应用真正成为“框架无关”的可嵌入单元,既解决启动错误,又为未来迁移到其他技术栈(如 React、Vue 或纯 HTML)保留扩展能力。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

7995

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

4372

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

4010

2023.07.31

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

4039

2023.08.01

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

5419

2023.08.11

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

3981

2023.08.11

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

3789

2023.08.31

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

3228

2023.09.01

CVE-2026-114938高危漏洞修复
CVE-2026-114938高危漏洞修复

Java4Shell是OpenJDK Base64解码路径中的远程代码执行漏洞,编号CVE-2026-114938,2026年11月17日披露,官方已发布17.0.21.1、21.0.13.1等修复版本,建议优先升级 。本专题围绕Java4Shell(CVE-2026-114938)持续更新,从漏洞原理、受影响版本、受影响产品到修复与自查一站式汇总,适合Java开发、运维与安全人员快速定位风险。ARM64环境不受影响,x86-64环境请

0

2026.11.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn