https://github.com/ng-zorro/ng-zorro-antd
Angular UI Component Library based on Ant Design
https://github.com/ng-zorro/ng-zorro-antd
angular angular-components angular-directives angular-ui-components ant ant-design antd enterprise frontend ivy ng-zorro ngx typescript ui-components
Last synced: 6 days ago
JSON representation
Angular UI Component Library based on Ant Design
- Host: GitHub
- URL: https://github.com/ng-zorro/ng-zorro-antd
- Owner: NG-ZORRO
- License: mit
- Created: 2017-08-08T14:59:33.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-04-16T09:05:34.000Z (7 days ago)
- Last Synced: 2025-04-17T02:46:05.002Z (6 days ago)
- Topics: angular, angular-components, angular-directives, angular-ui-components, ant, ant-design, antd, enterprise, frontend, ivy, ng-zorro, ngx, typescript, ui-components
- Language: TypeScript
- Homepage: https://ng.ant.design
- Size: 24.1 MB
- Stars: 8,981
- Watchers: 239
- Forks: 4,006
- Open Issues: 890
-
Metadata Files:
- Readme: README-zh_CN.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
NG-ZORRO
`ng-zorro-antd` 是 Ant Design 的 Angular 实现，主要用于研发企业级中后台产品。全部代码开源并遵循 MIT 协议，任何企业、组织及个人均可免费使用。
[](https://dev.azure.com/ng-zorro/NG-ZORRO/_build)
[](https://codecov.io/gh/NG-ZORRO/ng-zorro-antd)
[](https://github.com/NG-ZORRO/ng-zorro-antd/releases)
[](https://www.npmjs.org/package/ng-zorro-atnd)
[](https://npmjs.org/package/ng-zorro-antd)
[](https://github.com/NG-ZORRO/ng-zorro-antd/blob/master/LICENSE)
[](https://discord.com/channels/748677963142135818/764322550712893451)
[](https://marketplace.visualstudio.com/items?itemName=cipchk.ng-zorro-vscode)
[](https://github.com/prettier/prettier)
[](https://twitter.com/ng_zorro)
[](http://ng.ant.design)
[English](README.md) | 简体中文
## ✨ 特性
- 提炼自企业级中后台产品的交互语言和视觉风格。
- 开箱即用的高质量 Angular 组件，与 Angular 保持同步升级。
- 使用 TypeScript 构建，提供完整的类型定义文件。
- 支持 OnPush 模式，性能卓越。
- 数十个国际化语言支持。
- 深入每个细节的主题定制能力。
## ☀️ 授权协议
[](https://github.com/NG-ZORRO/ng-zorro-antd/blob/master/LICENSE)
[](https://app.fossa.com/projects/git%2Bgithub.com%2FNG-ZORRO%2Fng-zorro-antd?ref=badge_shield)
## 🖥 支持环境
- Angular `^19.0.0` [](https://www.npmjs.org/package/ng-zorro-antd)
- 支持服务端渲染
- 现代浏览器，[浏览器支持](https://angular.cn/reference/versions#browser-support)
- [Electron](http://electron.atom.io/)
| [
](http://godban.github.io/browsers-support-badges/)Edge | [
](http://godban.github.io/browsers-support-badges/)Firefox | [
](http://godban.github.io/browsers-support-badges/)Chrome | [
](http://godban.github.io/browsers-support-badges/)Safari | [
](http://godban.github.io/browsers-support-badges/)Opera | [
](http://godban.github.io/browsers-support-badges/)Electron |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| last 2 versions | last 2 versions | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
## 🎨 设计规范
`ng-zorro-antd` 与 Ant Design 设计规范定期同步，你可以在线查看[同步日志](https://nz-styles-syncer.now.sh/)。
## 📦 安装
我们强烈推荐官方的 `@angular/cli` 工具链辅助进行开发，在实际项目开发中，它可以很好的满足对 TypeScript 代码的构建、调试、代理、打包部署等一系列工程化的需求。
```bash
$ ng new PROJECT_NAME
$ cd PROJECT_NAME
$ ng add ng-zorro-antd
```
> 如果你想了解更多CLI工具链的功能和命令，建议访问 [Angular CLI](https://github.com/angular/angular-cli) 了解更多
## 🔨 使用
将想要使用的组件模块引入到你的组件中。
```ts
import { NzButtonModule } from 'ng-zorro-antd/button';
@Component({
imports: [ NzButtonModule ]
})
export class AppComponent {}
```
> `@angular/cli` 的用户不需要担心下面这项设置，但知道也挺有好处。
然后在 `angular.json` 文件中引入样式和 SVG icon 资源。
```diff
{
"assets": [
+ {
+ "glob": "**/*",
+ "input": "./node_modules/@ant-design/icons-angular/src/inline-svg/",
+ "output": "/assets/"
+ }
],
"styles": [
+ "node_modules/ng-zorro-antd/ng-zorro-antd.min.css"
]
}
```
参考[快速上手](https://ng.ant.design/docs/getting-started/zh)以了解更多。
## 🔗 链接
* [ng-zorro-antd-mobile](https://github.com/NG-ZORRO/ng-zorro-antd-mobile)
* [ng-alain](https://github.com/ng-alain/ng-alain)
* [VSCode 的 snippet 扩展](https://marketplace.visualstudio.com/items?itemName=cipchk.ng-zorro-vscode)
## ⌨️ 开发
```bash
$ git clone [email protected]:NG-ZORRO/ng-zorro-antd.git
$ cd ng-zorro-antd
$ npm install
$ npm run start
```
浏览器会自动打开。
## 🤝 如何贡献
[](https://github.com/NG-ZORRO/ng-zorro-antd/pulls)
在任何形式的参与前，请先阅读 [贡献者文档](https://github.com/NG-ZORRO/ng-zorro-antd/blob/master/CONTRIBUTING.md)。如果你希望参与贡献，欢迎 [Pull Request](https://github.com/NG-ZORRO/ng-zorro-antd/pulls)，或给我们 [报告 Bug](http://ng.ant.design/issue-helper/#/new-issue)。
> 强烈推荐阅读 [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way)(**本指南不提供此项目的实际支持服务！**)、[《如何向开源社区提问题》](https://github.com/seajs/seajs/issues/545) 和 [《如何有效地报告 Bug》](http://www.chiark.greenend.org.uk/%7Esgtatham/bugs-cn.html)、[《如何向开源项目提交无法解答的问题》](https://zhuanlan.zhihu.com/p/25795393)，更好的问题更容易获得帮助。
感谢 [JetBrains](https://www.jetbrains.com/?from=ng-zorro-antd) 提供的免费开源 License 赞助
[](https://www.jetbrains.com/?from=ng-zorro-antd)
## ❓ 社区互助
如果您在使用的过程中碰到问题，可以通过下面几个途径寻求帮助，同时我们也鼓励资深用户通过下面的途径给新人提供帮助。
通过 Stack Overflow 或者 Segment Fault 提问时，建议加上 `ng-zorro-antd` 标签。
1. [Stack Overflow](https://stackoverflow.com/questions/tagged/ng-zorro-antd)（English）
2. [Segment Fault](https://segmentfault.com/t/ng-zorro)（中文）
3. [](https://discord.com/channels/748677963142135818/764322550712893451)
4. 加入钉钉 NG-ZORRO 自助服务群（中文）
## 🎉 谁在使用
- [阿里巴巴](https://www.alibaba.com/)
- [阿里云](https://www.aliyun.com/)
- [思特沃克](https://www.thoughtworks.com/)
- [招商银行](http://www.cmbchina.com/)
- [共道科技](https://www.gongdao.com/)
- [优速快递](http://www.uce.cn/)
- [轻流](https://qingflow.com/)
- [航天信息股份有限公司](http://www.aisino.com/)
- [达观数据](http://datagrand.com/)
- [Ververica](https://www.ververica.com/)
- [Apache Flink](https://flink.apache.org/)
- [Apache Zeppelin](https://zeppelin.apache.org/)
- [Apache Submarine](https://submarine.apache.org/)
- [Apache Metron](https://metron.apache.org/)
- [Process Automation Group](http://pag.company/)
- [ScentBird](https://www.scentbird.com/)
- [Southern Institute of Technology](https://www.sit.ac.nz/)
- [Hapify (Dynamic boilerplates tool)](https://hub.hapify.io/)
> 我们在这里列出了部分使用者，如果你的公司和产品使用了 NG-ZORRO，欢迎到 [这里](https://github.com/NG-ZORRO/ng-zorro-antd/issues/1142) 留言。