Skip to content

Commit d7fbc90

Browse files
LafferyLaffery
authored
chore(release): release 21.0.0 (#9635)
1 parent 6d948cd commit d7fbc90

27 files changed

Lines changed: 315 additions & 225 deletions

‎CHANGELOG.md‎

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,80 @@
1+
## [21.0.0](https://github.com/NG-ZORRO/ng-zorro-antd/compare/20.4.4...21.0.0) (2026-01-09)
2+
3+
### Code Refactoring
4+
5+
- migrate to native animation API, feel free to remove the `@angular/animations` dependency
6+
7+
### Features
8+
9+
- **color-picker:** support `nzPresets` ([#9341](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9341)) ([d59ec99](https://github.com/NG-ZORRO/ng-zorro-antd/commit/d59ec995b42726470ebaea39ec7a52f5c9c5e58d))
10+
- **core:** add `provideNzNoAnimation` ([#9555](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9555)) ([c945e81](https://github.com/NG-ZORRO/ng-zorro-antd/commit/c945e81ce5966f34e7a96a8bccbf628a5b8d8c06))
11+
- **date-picker:** output date range in correct order ([#9518](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9518)) ([d0b3185](https://github.com/NG-ZORRO/ng-zorro-antd/commit/d0b3185fb2ae891a164d3b4f28e4f68add8e166b))
12+
- **float-button:** add pop animation to float button menu ([#9413](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9413)) ([b40ad91](https://github.com/NG-ZORRO/ng-zorro-antd/commit/b40ad91b26aee48fc86d92da48071751f8345ab4))
13+
- **input-number:** supports mouse wheel control ([#9591](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9591)) ([6ce3545](https://github.com/NG-ZORRO/ng-zorro-antd/commit/6ce354537ec59bd0c480eed61bb8f663d2429189))
14+
- **input,input-number:** add additional options for `focus` method ([#9595](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9595)) ([c336711](https://github.com/NG-ZORRO/ng-zorro-antd/commit/c3367110ccd53c5debd74799070ac6565c13c483))
15+
- **qrcode:** support `nzType` and `nzBoostLevel`, delete array usage of `nzPadding` ([#9535](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9535)) ([5419b51](https://github.com/NG-ZORRO/ng-zorro-antd/commit/5419b51781478369afe3c01fe24374f2f62eeffe))
16+
- **tree-view:** upgrade tree view component ([#9003](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9003)) ([ae9ad57](https://github.com/NG-ZORRO/ng-zorro-antd/commit/ae9ad576292671f3228361733b47e890d425e713))
17+
- **upload:** add `nzMaxCount` feature ([#9424](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9424)) ([0bf13c3](https://github.com/NG-ZORRO/ng-zorro-antd/commit/0bf13c3fa5e41289315cf4d9642ed5aa7005af9e))
18+
19+
### Bug Fixes
20+
21+
- **i18n:** add missing translations to `fa_IR` ([#9615](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9615)) ([1e8845d](https://github.com/NG-ZORRO/ng-zorro-antd/commit/1e8845d245ce7a98850390c61e65b301fb8fcc05))
22+
- **popconfirm:** allow null for `nzIcon` hide icon ([#9569](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9569)) ([760b587](https://github.com/NG-ZORRO/ng-zorro-antd/commit/760b58745a1b377d4008825a3d4c157d8a1bd590))
23+
- **select:** disable `nzAutoClearSearchValue` in single mode ([#9605](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9605)) ([4720c21](https://github.com/NG-ZORRO/ng-zorro-antd/commit/4720c2175dd2bc937d8ccbf66ab804c4782f23d4))
24+
- **tree:** no `preventDefault` when right-clicking the node title ([#9532](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9532)) ([900efad](https://github.com/NG-ZORRO/ng-zorro-antd/commit/900efad5b0a04b1a0aca2c68728f01ed8dc4ef3b))
25+
26+
### ⚠ BREAKING CHANGES
27+
28+
- **back-top:** removed, please use `float-button` instead
29+
- **color-picker:** change DOM structure to be simpler, and remove no unnecessary payload of `nzClick` output
30+
- **input-number-legacy:** removed, please use `input-number` instead
31+
- **qrcode:** change the type of `nzPadding` from `number | number[]` to `number` ([#9535](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9535))
32+
- **statistic:** rename `NzStatisticNumberComponent` to `NzStatisticContentValueComponent`
33+
- **tabs:** remove deprecated `nz-tabset` selector ([#9613](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9613))
34+
- **tree-view:** `nzTreeControl` has been removed, please use `nzLevelAccessor` or `nzChildrenAccessor` instead
35+
- **watermark:** change import path from `ng-zorro-antd/water-mark` to `ng-zorro-antd/watermark`
36+
37+
Remove the following APIs which were marked as deprecated in the previous version:
38+
39+
| Module | API |
40+
| ----------------------------------- | -------------------------------------- |
41+
| `ng-zorro-antd/back-top` | `*` |
42+
| `ng-zorro-antd/dropdown` | `NzDropdownButtonDirective` |
43+
| `ng-zorro-antd/input-number-legacy` | `*` |
44+
| `ng-zorro-antd/core` | `NzHighlightModule` |
45+
| `ng-zorro-antd/auto-complete` | `NZ_AUTOCOMPLETE_VALUE_ACCESSOR` |
46+
| `ng-zorro-antd/checkbox` | `nz-checkbox-wrapper` |
47+
| `ng-zorro-antd/date-picker` | `NzDatePickerComponent#nzBorderless` |
48+
| `ng-zorro-antd/input` | `NzInputDirective#nzBorderless` |
49+
| `ng-zorro-antd/input-number` | `NzInputNumberComponent#nzBordered` |
50+
| `ng-zorro-antd/mention` | `NZ_MENTION_TRIGGER_ACCESSOR` |
51+
| `ng-zorro-antd/select` | `NzSelectComponent#nzBorderless` |
52+
| `ng-zorro-antd/time-picker` | `NzTimePickerComponent#nzBorderless` |
53+
| `ng-zorro-antd/tooltip` | `NzToolTipModule` `NzToolTipComponent` |
54+
55+
Unify and standardize component naming, involving the following name changes:
56+
57+
| Module | Original | Current |
58+
| ----------- | ----------------------------- | ----------------------------- |
59+
| `core` | `NzConfig#backTop` | `NzConfig#floatButton` |
60+
| `core` | `NzConfig#dropDown` | `NzConfig#dropdown` |
61+
| `dropdown` | `NzDropDownModule` | `NzDropdownModule` |
62+
| `dropdown` | `NzDropDownADirective` | `NzDropdownADirective` |
63+
| `menu` | `NzIsMenuInsideDropDownToken` | `NzIsMenuInsideDropdownToken` |
64+
| `watermark` | `NzWaterMarkModule` | `NzWatermarkModule` |
65+
| `watermark` | `NzWaterMarkComponent` | `NzWatermarkComponent` |
66+
67+
### Deprecations
68+
69+
The following APIs are marked as **deprecated** in v20 and will be removed in the next major version.
70+
Please refer to related documentation for better alternatives.
71+
72+
| Module | API |
73+
| ------------------------ | ----------------------------------------------------------------- |
74+
| `ng-zorro-antd/collapse` | `nz-collapse-panel[nzDisabled]` |
75+
| `ng-zorro-antd/input` | `textarea[nzAutosize]`, `nz-input-group`, `[nz-input-group-slot]` |
76+
| `ng-zorro-antd/upload` | `nz-upload[nzTransformFile]`, `NzUploadTransformFileType` |
77+
178
## [20.4.4](https://github.com/NG-ZORRO/ng-zorro-antd/compare/20.4.3...20.4.4) (2025-12-12)
279

380
### Bug Fixes

‎components/input/doc/index.en-US.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
category: Components
33
type: Data Entry
44
title: Input
5-
tag: Update
5+
tag: updated
66
cover: 'https://gw.alipayobjects.com/zos/alicdn/xS9YEJhfe/Input.svg'
77
description: Through mouse or keyboard input content, it is the most basic form field wrapper.
88
---

‎components/input/doc/index.zh-CN.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ category: Components
33
subtitle: 输入框
44
type: 数据录入
55
title: Input
6-
tag: 更新
6+
tag: updated
77
cover: 'https://gw.alipayobjects.com/zos/alicdn/xS9YEJhfe/Input.svg'
88
description: 通过鼠标或键盘输入内容，是最基础的表单域的包装。
99
---

‎components/package.json‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "ng-zorro-antd",
3-
"version": "21.0.0-beta.0",
3+
"version": "21.0.0",
44
"license": "MIT",
55
"description": "An enterprise-class UI components based on Ant Design and Angular",
66
"schematics": "./schematics/collection.json",
@@ -33,7 +33,6 @@
3333
"date-fns": "^2.16.1"
3434
},
3535
"peerDependencies": {
36-
"@angular/animations": "^21.0.0",
3736
"@angular/common": "^21.0.0",
3837
"@angular/forms": "^21.0.0",
3938
"@angular/core": "^21.0.0",

‎components/tree-view/doc/index.en-US.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
category: Components
33
type: Data Display
44
title: TreeView
5-
tag: Update
5+
tag: updated
66
cover: 'https://gw.alipayobjects.com/zos/alicdn/Xh-oWqg9k/Tree.svg'
77
description: Tree view component with better performance and customizability.
88
---

‎components/tree-view/doc/index.zh-CN.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ category: Components
33
type: 数据展示
44
title: TreeView
55
subtitle: 树视图
6-
tag: 更新
6+
tag: updated
77
cover: 'https://gw.alipayobjects.com/zos/alicdn/Xh-oWqg9k/Tree.svg'
88
description: 树视图组件，相比封装好的 Tree 组件具有更高的定制度和更好的性能。
99
---

‎components/version/version.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,4 +5,4 @@
55

66
import { Version } from '@angular/core';
77

8-
export const VERSION = new Version('21.0.0-beta.0');
8+
export const VERSION = new Version('21.0.0');

‎docs/animations.en-US.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
order: 8
33
title: Animations Switch
4+
tag: updated
45
---
56

67
> Since v21, NG-ZORRO uses [native animation](https://angular.dev/guide/animations) to implement animation effects. You can remove the `@angular/animations` dependency as needed.

‎docs/animations.zh-CN.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
order: 8
33
title: 动画开关
4+
tag: updated
45
---
56

67
> 从 v21 版本开始，NG-ZORRO 完全使用 [native animation](https://angular.cn/guide/animations) 实现动画效果，你可以按需移除 `@angular/animations` 依赖。

‎docs/changelog.en-US.md‎

Lines changed: 20 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ order: 13
33
title: Change Log
44
toc: false
55
timeline: true
6+
tag: '{{version}}'
67
---
78

89
`ng-zorro-antd` strictly follows [Semantic Versioning 2.0.0](https://semver.org).
@@ -15,84 +16,43 @@ timeline: true
1516

1617
---
1718

18-
## 21.0.0-beta.0
19+
## 21.0.0
1920

20-
`2025-12-26`
21+
`2026-01-09`
2122

2223
### Code Refactoring
2324

24-
- migrate `upload` `select` `dropdown` `cascader` `tabs` `segmented` `message` `notification` to native animation
25-
26-
### Bug Fixes
27-
28-
- **i18n:** add missing translations to `fa_IR` ([#9615](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9615)) ([1e8845d](https://github.com/NG-ZORRO/ng-zorro-antd/commit/1e8845d245ce7a98850390c61e65b301fb8fcc05))
29-
30-
## 21.0.0-next.2
31-
32-
`2025-12-22`
33-
34-
### ⚠ BREAKING CHANGES
35-
36-
- **tabs:** remove deprecated `nz-tabset` selector ([#9613](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9613)) ([d5e5772](https://github.com/NG-ZORRO/ng-zorro-antd/commit/d5e577245da502a85799c84afbf9088c03732319))
37-
- **qrcode:** change the type of `nzPadding` from `number | number[]` to `number` ([#9535](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9535)) ([5419b51](https://github.com/NG-ZORRO/ng-zorro-antd/commit/5419b51781478369afe3c01fe24374f2f62eeffe))
25+
- migrate to native animation API, feel free to remove the `@angular/animations` dependency
3826

3927
### Features
4028

4129
- **color-picker:** support `nzPresets` ([#9341](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9341)) ([d59ec99](https://github.com/NG-ZORRO/ng-zorro-antd/commit/d59ec995b42726470ebaea39ec7a52f5c9c5e58d))
30+
- **core:** add `provideNzNoAnimation` ([#9555](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9555)) ([c945e81](https://github.com/NG-ZORRO/ng-zorro-antd/commit/c945e81ce5966f34e7a96a8bccbf628a5b8d8c06))
4231
- **date-picker:** output date range in correct order ([#9518](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9518)) ([d0b3185](https://github.com/NG-ZORRO/ng-zorro-antd/commit/d0b3185fb2ae891a164d3b4f28e4f68add8e166b))
32+
- **float-button:** add pop animation to float button menu ([#9413](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9413)) ([b40ad91](https://github.com/NG-ZORRO/ng-zorro-antd/commit/b40ad91b26aee48fc86d92da48071751f8345ab4))
4333
- **input-number:** supports mouse wheel control ([#9591](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9591)) ([6ce3545](https://github.com/NG-ZORRO/ng-zorro-antd/commit/6ce354537ec59bd0c480eed61bb8f663d2429189))
4434
- **input,input-number:** add additional options for `focus` method ([#9595](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9595)) ([c336711](https://github.com/NG-ZORRO/ng-zorro-antd/commit/c3367110ccd53c5debd74799070ac6565c13c483))
4535
- **qrcode:** support `nzType` and `nzBoostLevel`, delete array usage of `nzPadding` ([#9535](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9535)) ([5419b51](https://github.com/NG-ZORRO/ng-zorro-antd/commit/5419b51781478369afe3c01fe24374f2f62eeffe))
46-
47-
### Bug Fixes
48-
49-
- **icon:** include nzSpin in change detection logic ([#9598](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9598)) ([7d3c637](https://github.com/NG-ZORRO/ng-zorro-antd/commit/7d3c637834fc17b1cd2d1f3e1ef77942a3d35c22))
50-
- **select:** disable nzAutoClearSearchValue in single mode ([#9605](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9605)) ([4720c21](https://github.com/NG-ZORRO/ng-zorro-antd/commit/4720c2175dd2bc937d8ccbf66ab804c4782f23d4))
51-
52-
## 21.0.0-next.1
53-
54-
`2025-12-05`
55-
56-
### Features
57-
58-
- **schematics:** update default test target builder ([#9574](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9574)) ([46d39de](https://github.com/NG-ZORRO/ng-zorro-antd/commit/46d39de9f3968544989b68a31878edc1b5851c94))
59-
60-
### Bug Fixes
61-
62-
- **\*:** correct usage of signal input `nzNoAnimation` ([#9576](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9576)) ([b418efe](https://github.com/NG-ZORRO/ng-zorro-antd/commit/b418efee87145a448b47f0c07990ef49a0a9fc2d))
63-
- **popconfirm:** allow null for `nzIcon` hide icon ([#9569](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9569)) ([760b587](https://github.com/NG-ZORRO/ng-zorro-antd/commit/760b58745a1b377d4008825a3d4c157d8a1bd590))
64-
- **schematics:** remove `NzInputNumberLegacyModule` ([#9573](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9573)) ([48c02aa](https://github.com/NG-ZORRO/ng-zorro-antd/commit/48c02aa17d866a1a9774521f23574dc3a3c38ca6))
65-
66-
## 21.0.0-next.0
67-
68-
`2025-11-28`
69-
70-
Upgrade with shell
71-
72-
```shell
73-
ng update ng-zorro-antd@next
74-
```
75-
76-
### Features
77-
78-
- **core:** add `provideNzNoAnimation` ([#9555](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9555)) ([c945e81](https://github.com/NG-ZORRO/ng-zorro-antd/commit/c945e81ce5966f34e7a96a8bccbf628a5b8d8c06))
79-
- **float-button:** add pop animation to float button menu ([#9413](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9413)) ([b40ad91](https://github.com/NG-ZORRO/ng-zorro-antd/commit/b40ad91b26aee48fc86d92da48071751f8345ab4))
8036
- **tree-view:** upgrade tree view component ([#9003](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9003)) ([ae9ad57](https://github.com/NG-ZORRO/ng-zorro-antd/commit/ae9ad576292671f3228361733b47e890d425e713))
8137
- **upload:** add `nzMaxCount` feature ([#9424](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9424)) ([0bf13c3](https://github.com/NG-ZORRO/ng-zorro-antd/commit/0bf13c3fa5e41289315cf4d9642ed5aa7005af9e))
82-
- **schematics:** update upgrade data for v21 ([#9564](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9564)) ([a44227d](https://github.com/NG-ZORRO/ng-zorro-antd/commit/a44227d4dcfd137a2f33fabf699ac0af331e4208))
8338

8439
### Bug Fixes
8540

41+
- **i18n:** add missing translations to `fa_IR` ([#9615](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9615)) ([1e8845d](https://github.com/NG-ZORRO/ng-zorro-antd/commit/1e8845d245ce7a98850390c61e65b301fb8fcc05))
42+
- **popconfirm:** allow null for `nzIcon` hide icon ([#9569](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9569)) ([760b587](https://github.com/NG-ZORRO/ng-zorro-antd/commit/760b58745a1b377d4008825a3d4c157d8a1bd590))
43+
- **select:** disable `nzAutoClearSearchValue` in single mode ([#9605](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9605)) ([4720c21](https://github.com/NG-ZORRO/ng-zorro-antd/commit/4720c2175dd2bc937d8ccbf66ab804c4782f23d4))
8644
- **tree:** no `preventDefault` when right-clicking the node title ([#9532](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9532)) ([900efad](https://github.com/NG-ZORRO/ng-zorro-antd/commit/900efad5b0a04b1a0aca2c68728f01ed8dc4ef3b))
8745

8846
### ⚠ BREAKING CHANGES
8947

90-
- **tree-view:** `nzTreeControl` has been removed, please use `nzLevelAccessor` or `nzChildrenAccessor` instead
91-
- **statistic:** rename `NzStatisticNumberComponent` to `NzStatisticContentValueComponent`
92-
- **color-picker:** change DOM structure to be simpler, and remove no unnecessary payload of `nzClick` output
93-
- **watermark:** change import path from `ng-zorro-antd/water-mark` to `ng-zorro-antd/watermark`
9448
- **back-top:** removed, please use `float-button` instead
49+
- **color-picker:** change DOM structure to be simpler, and remove no unnecessary payload of `nzClick` output
9550
- **input-number-legacy:** removed, please use `input-number` instead
51+
- **qrcode:** change the type of `nzPadding` from `number | number[]` to `number` ([#9535](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9535))
52+
- **statistic:** rename `NzStatisticNumberComponent` to `NzStatisticContentValueComponent`
53+
- **tabs:** remove deprecated `nz-tabset` selector ([#9613](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9613))
54+
- **tree-view:** `nzTreeControl` has been removed, please use `nzLevelAccessor` or `nzChildrenAccessor` instead
55+
- **watermark:** change import path from `ng-zorro-antd/water-mark` to `ng-zorro-antd/watermark`
9656

9757
Remove the following APIs which were marked as deprecated in the previous version:
9858

@@ -129,9 +89,11 @@ Unify and standardize component naming, involving the following name changes:
12989
The following APIs are marked as **deprecated** in v20 and will be removed in the next major version.
13090
Please refer to related documentation for better alternatives.
13191

132-
| Module | API |
133-
| --------------------- | ---------------------- |
134-
| `ng-zorro-antd/input` | `textarea[nzAutosize]` |
92+
| Module | API |
93+
| ------------------------ | ----------------------------------------------------------------- |
94+
| `ng-zorro-antd/collapse` | `nz-collapse-panel[nzDisabled]` |
95+
| `ng-zorro-antd/input` | `textarea[nzAutosize]`, `nz-input-group`, `[nz-input-group-slot]` |
96+
| `ng-zorro-antd/upload` | `nz-upload[nzTransformFile]`, `NzUploadTransformFileType` |
13597

13698
## 20.4.4
13799

0 commit comments

Comments
 (0)