@ant-design/icons-angular

中文文档
22.1.1发布于 2026/09/18MITTypeScriptES Module近 30 天下载 56.4万

Angular 的蚂蚁设计图标

中文使用文档
文档目录8 节
  1. 安装
  2. 使用量
  3. 命名空间
  4. 发展
  5. 设置
  6. 演示
  7. 构建
  8. 延长

Angular 的蚂蚁设计图标

NPM version NPM downloads

安装

ng add @ant-design/icons-angular

# or npm install @ant-design/icons-angular

使用量

您应该导入 IconDirective 在您的组件.

import { IconDirective } from '@ant-design/icons-angular';

@Component({
  imports: [ IconDirective ]
})
export class AppComponent {}

注册您需要的图标 IconService (所有或明确,我们称之为 静态加载:

注意点! 我们强烈建议大家不要登记所有图标,这会大大增加捆绑大小.

import { Component, inject } from '@angular/core';
import { IconService } from '@ant-design/icons-angular';
import { AccountBookFill } from '@ant-design/icons-angular/icons'
// import * as AllIcons from 'ant-icons-angular/icons';

@Component({
  // ...
})
export class AppComponent {
  readonly iconService = inject(IconService);
  
  constructor() {
    // Import all. NOT RECOMMENDED. ❌
    // const antDesignIcons = AllIcons as {
      // [key: string]: IconDefinition;
    // };
    // this.iconService.addIcon(...Object.keys(antDesignIcons).map(key => antDesignIcons[key]));

    // Import what you need! ✔️
    this.iconService.addIcon(...[ AccountBookFill ]);
    this.iconService.twoToneColor = { primaryColor: '#1890ff' };
  }
}

您也可以在 app.config.ts数字 :

import { ApplicationConfig } from '@angular/core';
import { provideAntIcons } from '@ant-design/icons-angular';
import { AccountBookFill } from '@ant-design/icons-angular/icons';

export const appConfig: ApplicationConfig = {
  providers: [
    provideAntIcons([ AccountBookFill ])
  ]
};

当您想要制作图标时 :

<span antIcon type="ant-cloud" theme="outline"></span>

请查看演示详情.

对于由Ant Design提供的图标,我们提供 动态加载 减少捆绑大小的策略. 刚刚配置你的 angular.json 甚至不需要注册 图标! 检查 examples 文件夹和 angular.json 更多细节.

命名空间

命名空间允许用户用简单的API来注册自己的图标,同时支持动态加载和静态加载.

如果你想添加一个 panda 图标 animal 名称空间 :

  • 静态加载时,可以拨打 addIconLiteral('animal:panda', '<svg>...</svg>')· ;
  • 用于动态加载,只需放入 panda.svg 下级 assets/animal并让一只熊猫像: <span antIcon type="animal:panda">。 。 。 .

请查看演示详情.

发展

您可以找到源代码 这里。 。 。 .

设置

安装依赖性 @ant-design/icons-angular运行 npm run generate。 。 。 .

演示

运行 npm run generate 接下来 npm run start。 。 。 .

构建

运行 npm run build:lib。 。 。 .

延长

您可以简单地通过创建扩展指令或服务来扩展此软件包 IconDirective 财务报告和审定财务报表 IconService值得一提的是 _changeIcon 方法返回 a Promise<svg> 用于添加额外的修改.

纳克-佐罗-南特 这是扩展这个软件包的好例子.

版本与发布记录

@ant-design/icons-angular 共发布 62 个版本,首次发布于 2018/09/29;过去 12 个月发布了 9 个版本。

版本发布日期距今
22.1.1latest2026/09/181 个月前
22.1.02026/08/172 个月前
22.0.02026/06/055 个月前
22.0.0-beta.4beta2026/06/055 个月前
22.0.0-beta.32026/06/055 个月前
22.0.0-beta.22026/06/055 个月前

其他发布通道:next → 10.0.0-beta.0,beta → 22.0.0-beta.4。

关于 @ant-design/icons-angular 的常见问题

@ant-design/icons-angular 是什么?

Angular 的蚂蚁设计图标

如何安装 @ant-design/icons-angular?

在项目目录运行 npm install @ant-design/icons-angular,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:rxjs(^6.5.3 || ^7.4.0)、@angular/core(^22.0.0)、@angular/common(^22.0.0)、@angular/platform-browser(^22.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@ant-design/icons-angular 支持 TypeScript 吗?

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

@ant-design/icons-angular 支持 ESM 还是 CommonJS?

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

@ant-design/icons-angular 可以商用吗?

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

@ant-design/icons-angular 的下载量有多少?

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

@ant-design/icons-angular 还在维护吗?

最新版本 22.1.1 发布于 2026/09/18(1 个月前);至今共发布 62 个版本,其中过去 12 个月发布了 9 个;首次发布于 2018/09/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。