# @angular-extensions/elements 中文文档

规范地址：https://npmcn.com/package/%40angular-extensions/elements/

版本：22\.0\.0
npm 元数据更新时间：2026-08-20T17:26:31.024Z
中文译文更新时间：2026-11-06T04:11:29.914Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40angular-extensions/elements
原文对照：https://npmcn.com/package/%40angular-extensions/elements/?lang=original
项目主页：https://github.com/angular-extensions/elements#readme
源码仓库：https://github.com/angular-extensions/elements

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：107 kB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@angular/common \>=22，@angular/core \>=22，rxjs \>=7\.5\.0
- 首次发布：2019-07-12T18:43:09.064Z
- 最新版本发布：2026-08-20T17:26:30.628Z
- 近 30 天下载量：70406（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：76（近 12 个月 3 个）

## 中文简介

![](https://raw.github.com/angular-extensions/elements/master/projects/elements-demo/src/assets/logo/logo.svg?sanitize=true)

## 安装

```sh
npm install @angular-extensions/elements
```

也可以使用：`pnpm add @angular-extensions/elements`、`yarn add @angular-extensions/elements`、`bun add @angular-extensions/elements`

## README

![](https://raw.github.com/angular-extensions/elements/master/projects/elements-demo/src/assets/logo/logo.svg?sanitize=true)

# 维也纳展期要点

### 在您的 Angular 应用程序中, 懒惰地装入 Angular Elements 或任何其他网络组件的简单方式 !

以 [@tomastrajan (英语)](https://twitter.com/tomastrajan)

[![npm](https://img.shields.io/npm/v/@angular-extensions/elements.svg)](https://www.npmjs.com/package/@angular-extensions/elements) [![npm](https://img.shields.io/github/license/angular-extensions/elements.svg)](https://github.com/angular-extensions/elements/blob/master/LICENSE) [![npm](https://img.shields.io/npm/dm/@angular-extensions/elements.svg)](https://www.npmjs.com/package/@angular-extensions/elements) [![Build Status](https://travis-ci.org/angular-extensions/elements.svg?branch=master)](https://travis-ci.org/angular-extensions/elements) [![codecov](https://codecov.io/gh/angular-extensions/elements/branch/master/graph/badge.svg)](https://codecov.io/gh/angular-extensions/elements) [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org/) [![Twitter Follow](https://img.shields.io/twitter/follow/tomastrajan.svg?style=social&label=Follow)](https://twitter.com/tomastrajan)

## 文档

-   [文档](https://angular-extensions.github.io/elements/)
-   [开始](https://angular-extensions.github.io/elements/#/docs/getting-started)
-   [使用大小写](https://angular-extensions.github.io/elements/#/docs/use-cases)
-   [财务问题](https://angular-extensions.github.io/elements/#/docs/faq)
-   [API 密码](https://angular-extensions.github.io/elements/#/docs/api)
-   [实例](https://angular-extensions.github.io/elements/#/examples)
-   [博客文章](https://medium.com/@tomastrajan/the-best-way-to-lazy-load-angular-elements-97a51a5c2007)
-   [专题演讲(视频)](https://www.youtube.com/watch?v=X__jkPGYRUs)

## 快速启动

1.  安装 `npm i @angular-extensions/elements`
2.  添加 `import { LazyElementDirective } from '@angular-extensions/elements'`· ;
3.  附录 `LazyElementDirective` 页:1 `imports: []` 您的电话 `MyOrgComponent`
4.  添加新内容 `schemas: []` 属性为 `CUSTOM_ELEMENTS_SCHEMA` 值为 `@Component` 您的装饰器 `MyOrgComponent`
5.  使用 `*axLazyElement` 关于您想要在元素捆绑的url中装入并传递的元素的指令

构成部分实施实例

```typescript
import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import { LazyElementDirective } from '@angular-extensions/elements';

@Component({
  selector: 'your-org-feature',
  imports: [LazyElementDirective],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `
    <!-- will be lazy loaded and uses standard Angular template bindings -->
    <some-element
      *axLazyElement="elementUrl"
      [data]="data"
      (dataChange)="handleChange($event)"
    ></some-element>
  `,
})
export class MyOrgComponent {
  elementUrl = 'https://your-org.com/elements/some-element.js';

  data: SomeData;

  handleChange(change: Partial<SomeData>) {
    // ...
  }
}
```

## 支持的角版本

图书馆用下列版本的Angular进行了测试,意在使用 与相应的主要版本(`"@angular/core"": "^15.0.0"` 与 `"@angular-extensions/elements": "^15.0.0"` ) (中文(简体) ).

-   9.x(全IVY支持,使用制造器对安全部门改革非常小心)
-   8.x (部分IVY支持, `axLazyElement` 工作不过 `axLazyElementDynamic` 与IVY无关)
-   7.x 电话
-   6.x (例如: `npm i @angular-extensions/elements@^6.0.0`(中文(简体) )

## 内部解析图

![Internal dep graph](https://raw.githubusercontent.com/angular-extensions/elements/master/dep-graph.png)

## 成为贡献者

#### 缺少一个功能, 在文档中找到错误或打字吗 ?

请随便开张吧 [问题](https://github.com/angular-extensions/elements/issues) 或提交 [拉动请求](https://github.com/angular-extensions/elements/pulls) 让这个项目变得更好

<table><tbody><tr><td align="center"><a href="https://medium.com/@tomastrajan" rel="nofollow noopener noreferrer"><img alt="Tomas Trajan" src="https://avatars0.githubusercontent.com/u/3764868?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>托马斯·特拉扬</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=tomastrajan" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-design-tomastrajan" title="Design" rel="nofollow noopener noreferrer">🎨</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-example-tomastrajan" title="Examples" rel="nofollow noopener noreferrer">💡</a> <a href="https://github.com/angular-extensions/elements/commits?author=tomastrajan" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-ideas-tomastrajan" title="Ideas, Planning, &amp; Feedback" rel="nofollow noopener noreferrer">🤔</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-infra-tomastrajan" title="Infrastructure (Hosting, Build-Tools, etc)" rel="nofollow noopener noreferrer">🚇</a> <a href="https://github.com/angular-extensions/elements/commits?author=tomastrajan" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://medium.com/@overthesanity" rel="nofollow noopener noreferrer"><img alt="Artur Androsovych" src="https://avatars.githubusercontent.com/u/7337691?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>阿图尔·安德罗索维奇</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=arturovt" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/angular-extensions/elements/issues?q=author%3Aarturovt" title="Bug reports" rel="nofollow noopener noreferrer">🐛</a></td><td align="center"><a href="http://www.lambda-it.ch/" rel="nofollow noopener noreferrer"><img alt="Wayne Maurer" src="https://avatars2.githubusercontent.com/u/2899448?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>韦恩·莫雷尔</b></sub></a><br><a href="https://github.com/angular-extensions/elements/issues?q=author%3Awmaurer" title="Bug reports" rel="nofollow noopener noreferrer">🐛</a> <a href="https://github.com/angular-extensions/elements/commits?author=wmaurer" title="Code" rel="nofollow noopener noreferrer">💻</a></td><td align="center"><a href="https://www.santoshyadav.dev/" rel="nofollow noopener noreferrer"><img alt="Santosh Yadav" src="https://avatars3.githubusercontent.com/u/11923975?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>桑托什·亚达夫</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=santoshyadav198613" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-platform-santoshyadav198613" title="Packaging/porting to new platform" rel="nofollow noopener noreferrer">📦</a></td><td align="center"><a href="https://twitter.com/daviddalbusco" rel="nofollow noopener noreferrer"><img alt="David Dal Busco" src="https://avatars0.githubusercontent.com/u/16886711?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>戴维·达尔·布斯科</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=peterpeterparker" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-example-peterpeterparker" title="Examples" rel="nofollow noopener noreferrer">💡</a></td><td align="center"><a href="https://www.linkedin.com/in/mohammedzamakhan" rel="nofollow noopener noreferrer"><img alt="Zama Khan Mohammed" src="https://avatars3.githubusercontent.com/u/2327532?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>扎马汗·穆罕默德</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=mohammedzamakhan" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-ideas-mohammedzamakhan" title="Ideas, Planning, &amp; Feedback" rel="nofollow noopener noreferrer">🤔</a> <a href="https://github.com/angular-extensions/elements/commits?author=mohammedzamakhan" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td></tr><tr><td align="center"><a href="https://github.com/angelfraga" rel="nofollow noopener noreferrer"><img alt="Angel Fraga Parodi" src="https://avatars0.githubusercontent.com/u/11693938?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>天使弗拉加·帕罗迪</b></sub></a><br><a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-example-angelfraga" title="Examples" rel="nofollow noopener noreferrer">💡</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-ideas-angelfraga" title="Ideas, Planning, &amp; Feedback" rel="nofollow noopener noreferrer">🤔</a></td><td align="center"><a href="https://github.com/ye3i" rel="nofollow noopener noreferrer"><img alt="ye3i" src="https://avatars1.githubusercontent.com/u/5447242?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>对啊</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=ye3i" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-ideas-ye3i" title="Ideas, Planning, &amp; Feedback" rel="nofollow noopener noreferrer">🤔</a></td><td align="center"><a href="https://github.com/MagicCurlyHair" rel="nofollow noopener noreferrer"><img alt="Heorhi Shakanau" src="https://avatars3.githubusercontent.com/u/38192464?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>沙克瑙河畔沙克瑙</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=MagicCurlyHair" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-ideas-MagicCurlyHair" title="Ideas, Planning, &amp; Feedback" rel="nofollow noopener noreferrer">🤔</a></td><td align="center"><a href="http://www.plets.me/" rel="nofollow noopener noreferrer"><img alt="Felipe Plets" src="https://avatars3.githubusercontent.com/u/119980?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>费利佩·普莱茨</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=felipeplets" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-design-felipeplets" title="Design" rel="nofollow noopener noreferrer">🎨</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-example-felipeplets" title="Examples" rel="nofollow noopener noreferrer">💡</a> <a href="https://github.com/angular-extensions/elements/commits?author=felipeplets" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://npmcn.com/package/%40angular-extensions/elements/#readme-ideas-felipeplets" title="Ideas, Planning, &amp; Feedback" rel="nofollow noopener noreferrer">🤔</a> <a href="https://github.com/angular-extensions/elements/commits?author=felipeplets" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://github.com/jkubiszewski" rel="nofollow noopener noreferrer"><img alt="jkubiszewski" src="https://avatars.githubusercontent.com/u/5447242?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>库比谢夫斯基</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=jkubiszewski" title="Code" rel="nofollow noopener noreferrer">💻</a></td><td align="center"><a href="https://github.com/gshokanov" rel="nofollow noopener noreferrer"><img alt="Heorhi Shakanau" src="https://avatars.githubusercontent.com/u/38192464?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>沙克瑙河畔沙克瑙</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=gshokanov" title="Code" rel="nofollow noopener noreferrer">💻</a></td></tr><tr><td align="center"><a href="https://github.com/NagornovAlex" rel="nofollow noopener noreferrer"><img alt="NagornovAlex" src="https://avatars.githubusercontent.com/u/3100132?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>纳戈尔诺-亚历山大</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=NagornovAlex" title="Code" rel="nofollow noopener noreferrer">💻</a></td><td align="center"><a href="https://www.josephndavis.com/" rel="nofollow noopener noreferrer"><img alt="Joseph Davis" src="https://avatars.githubusercontent.com/u/16785168?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>约瑟夫·戴维斯</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=Nerrdii" title="Code" rel="nofollow noopener noreferrer">💻</a></td><td align="center"><a href="https://github.com/Arooba-git" rel="nofollow noopener noreferrer"><img alt="Arooba Shahoor" src="https://avatars.githubusercontent.com/u/56495631?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>阿罗巴·沙胡尔</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=Arooba-git" title="Code" rel="nofollow noopener noreferrer">💻</a></td><td align="center"><a href="https://github.com/twixthehero" rel="nofollow noopener noreferrer"><img alt="Maximilian Wright" src="https://avatars.githubusercontent.com/u/1883172?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>马克西米利安·赖特</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=twixthehero" title="Documentation" rel="nofollow noopener noreferrer">📖</a></td><td align="center"><a href="https://github.com/apokralipsa" rel="nofollow noopener noreferrer"><img alt="Jakub Stawiarski" src="https://avatars.githubusercontent.com/u/7910183?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>雅库布·斯塔维阿尔斯基</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=apokralipsa" title="Code" rel="nofollow noopener noreferrer">💻</a></td><td align="center"><a href="https://github.com/9kubczas4" rel="nofollow noopener noreferrer"><img alt="Paweł Kubiak" src="https://avatars.githubusercontent.com/u/43759569?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>库比亚克</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=9kubczas4" title="Code" rel="nofollow noopener noreferrer">💻</a></td></tr><tr><td align="center"><a href="https://github.com/volvachev" rel="nofollow noopener noreferrer"><img alt="Egor Volvachev" src="https://avatars.githubusercontent.com/u/34657605?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>埃戈尔·沃尔瓦乔夫</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=volvachev" title="Code" rel="nofollow noopener noreferrer">💻</a></td><td align="center"><a href="https://github.com/DanielBou99" rel="nofollow noopener noreferrer"><img alt="Daniel Bou" src="https://avatars.githubusercontent.com/u/43351001?v=4?s=85" width="85px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>丹尼尔·布</b></sub></a><br><a href="https://github.com/angular-extensions/elements/commits?author=DanielBou99" title="Code" rel="nofollow noopener noreferrer">💻</a></td></tr></tbody></table>

## 发起人

> 您现在正在一个 **企业多雷波环境** 并且发现自己认为你能够提供如此多的价值 除非你有更好的总体规划 跟踪进展 并且把事情做好?

尝试 _[倾斜板](https://omniboard.dev/),是主要软件工程师和建筑师的最佳工具_ 帮助他们获得一个概览 驱动更改 **企业多雷波环境** 通过查询和追踪他们的代码基础!

免费计划让你用第一个仪表板 来全面概述你的所有项目 追踪到三个不同的东西!

[![Omniboard.dev - getting started in less than 5 minutes](https://app.omniboard.dev/assets/videos/omniboard-getting-started.png)](http://www.youtube.com/watch?feature=player_embedded&v=uDnNE9FuLwc)

## 常见问题

### 如何安装 @angular-extensions/elements？

在项目目录运行 npm install @angular-extensions/elements，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@angular/common（\>=22）、@angular/core（\>=22）、rxjs（\>=7\.5\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @angular-extensions/elements 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @angular-extensions/elements 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @angular-extensions/elements 可以商用吗？

@angular-extensions/elements 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @angular-extensions/elements 的下载量有多少？

根据 npm 官方下载统计，@angular-extensions/elements 在 2026/10/06 – 2026/11/04 这 30 天内被下载 70,406 次，日均约 2,347 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @angular-extensions/elements 还在维护吗？

最新版本 22\.0\.0 发布于 2026/08/21（2 个月前）；至今共发布 76 个版本，其中过去 12 个月发布了 3 个；首次发布于 2019/07/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

