Skip to content

Releases: NG-ZORRO/ng-zorro-antd

Release list

21.0.1

21.0.1

Choose a tag to compare

View all tags
@Laffery Laffery released this 16 Jan 10:03
21.0.1
fbc8add
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

21.0.1

2026-01-16

Bug Fixes

  • bundle keyframes of animation into base style files (#9653) (49ec060)
  • collapse: no ghost zone if collapsed (#9649) (5378f8b)

21.0.1

2026-01-16

Bug Fixes

  • 修复样式文件中 keyframes 样式缺失的问题 (#9653) (49ec060)
  • collapse: 修复折叠状态下出现幽灵滚动区域的问题 (#9649) (5378f8b)
Loading

21.0.0

21.0.0

Choose a tag to compare

View all tags
@Laffery Laffery released this 09 Jan 09:07
21.0.0
d7fbc90
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

21.0.0

2026-01-09

Code Refactoring

  • migrate to native animation API, feel free to remove the @angular/animations dependency

Features

  • color-picker: support nzPresets (#9341) (d59ec99)
  • core: add provideNzNoAnimation (#9555) (c945e81)
  • date-picker: output date range in correct order (#9518) (d0b3185)
  • float-button: add pop animation to float button menu (#9413) (b40ad91)
  • input-number: supports mouse wheel control (#9591) (6ce3545)
  • input,input-number: add additional options for focus method (#9595) (c336711)
  • qrcode: support nzType and nzBoostLevel, delete array usage of nzPadding (#9535) (5419b51)
  • tree-view: upgrade tree view component (#9003) (ae9ad57)
  • upload: add nzMaxCount feature (#9424) (0bf13c3)

Bug Fixes

  • i18n: add missing translations to fa_IR (#9615) (1e8845d)
  • popconfirm: allow null for nzIcon hide icon (#9569) (760b587)
  • select: disable nzAutoClearSearchValue in single mode (#9605) (4720c21)
  • tree: no preventDefault when right-clicking the node title (#9532) (900efad)

⚠ BREAKING CHANGES

  • back-top: removed, please use float-button instead
  • color-picker: change DOM structure to be simpler, and remove no unnecessary payload of nzClick output
  • input-number-legacy: removed, please use input-number instead
  • qrcode: change the type of nzPadding from number | number[] to number (#9535)
  • statistic: rename NzStatisticNumberComponent to NzStatisticContentValueComponent
  • tabs: remove deprecated nz-tabset selector (#9613)
  • tree-view: nzTreeControl has been removed, please use nzLevelAccessor or nzChildrenAccessor instead
  • watermark: change import path from ng-zorro-antd/water-mark to ng-zorro-antd/watermark

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

Module API
ng-zorro-antd/back-top *
ng-zorro-antd/dropdown NzDropdownButtonDirective
ng-zorro-antd/input-number-legacy *
ng-zorro-antd/core NzHighlightModule
ng-zorro-antd/auto-complete NZ_AUTOCOMPLETE_VALUE_ACCESSOR
ng-zorro-antd/checkbox nz-checkbox-wrapper
ng-zorro-antd/date-picker NzDatePickerComponent#nzBorderless
ng-zorro-antd/input NzInputDirective#nzBorderless
ng-zorro-antd/input-number NzInputNumberComponent#nzBordered
ng-zorro-antd/mention NZ_MENTION_TRIGGER_ACCESSOR
ng-zorro-antd/select NzSelectComponent#nzBorderless
ng-zorro-antd/time-picker NzTimePickerComponent#nzBorderless
ng-zorro-antd/tooltip NzToolTipModule NzToolTipComponent

Unify and standardize component naming, involving the following name changes:

Module Original Current
core NzConfig#backTop NzConfig#floatButton
core NzConfig#dropDown NzConfig#dropdown
dropdown NzDropDownModule NzDropdownModule
dropdown NzDropDownADirective NzDropdownADirective
menu NzIsMenuInsideDropDownToken NzIsMenuInsideDropdownToken
watermark NzWaterMarkModule NzWatermarkModule
watermark NzWaterMarkComponent NzWatermarkComponent

Deprecations

The following APIs are marked as deprecated in v20 and will be removed in the next major version.
Please refer to related documentation for better alternatives.

Module API
ng-zorro-antd/collapse nz-collapse-panel[nzDisabled]
ng-zorro-antd/input textarea[nzAutosize], nz-input-group, [nz-input-group-slot]
ng-zorro-antd/upload nz-upload[nzTransformFile], NzUploadTransformFileType

21.0.0

2026-01-09

Code Refactoring

  • 迁移至 native animation API，您可以按需移除依赖 @angular/animations

Features

  • color-picker: 新增 nzPresets 参数支持预设颜色 (#9341) (d59ec99)
  • core: 新增 provideNzNoAnimation provider 用于禁用动画效果 (#9555) (c945e81)
  • date-picker: 日期范围选择顺序颠倒时确保能输出正确的范围 (#9518) (d0b3185)
  • float-button: 悬浮按钮组合新增动画效果 (#9413) (b40ad91)
  • input-number: 支持鼠标滚轮控制 (#9591) (6ce3545)
  • input,input-number: focus 方法新增额外参数 (#9595) (c336711)
  • qrcode: 新增 nzType 和 nzBoostLevel 参数，nzPadding 类型从 number | number[] 调整为 number (#9535) (5419b51)
  • tree-view: 升级 tree-view 组件，支持 nzLevelAccessor 和 nzChildrenAccessor (#9003) (ae9ad57)
  • upload: 新增 nzMaxCount 属性 (#9424) (0bf13c3)

Bug Fixes

  • i18n: 更新 fa_IR 国际化文案 (#9615) (1e8845d)
  • popconfirm: 允许设置 nzIcon 为 null 以隐藏图标 (#9569) (760b587)
  • select: 单选模式下 nzAutoClearSearchValue 不应生效 (#9605) (4720c21)
  • tree: 不再阻止右键点击树节点标题的默认行为 (#9532) (900efad)

⚠ BREAKING CHANGES

  • back-top: 移除，请使用 float-button 替代
  • color-picker: 简化 DOM 结构，移除 nzClick output 不必要的参数
  • input-number-legacy: 移除，请使用 input-number 替代
  • qrcode: nzPadding 类型从 number | number[] 调整为 number
  • statistic: 重命名 NzStatisticNumberComponent 为 ...
Read more
Loading

21.0.0-beta.0

21.0.0-beta.0 Pre-release
Pre-release

Choose a tag to compare

View all tags
@Laffery Laffery released this 26 Dec 09:54
21.0.0-beta.0
aa24a89
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

21.0.0-beta.0

2025-12-26

Code Refactoring

  • migrate upload select dropdown cascader tabs segmented message notification to native animation

Bug Fixes

21.0.0-beta.0

2025-12-26

Code Refactoring

  • native animation 迁移：upload select dropdown cascader tabs segmented message notification

Bug Fixes

Loading

21.0.0-next.2

21.0.0-next.2 Pre-release
Pre-release

Choose a tag to compare

View all tags
@Laffery Laffery released this 22 Dec 09:47
21.0.0-next.2
7bb3639
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

21.0.0-next.2

⚠ BREAKING CHANGES

  • tabs: remove deprecated nz-tabset selector (#9613) (d5e5772)
  • qrcode: change the type of nzPadding from number | number[] to number (#9535) (5419b51)

Features

  • color-picker: support nzPresets (#9341) (d59ec99)
  • date-picker: output date range in correct order (#9518) (d0b3185)
  • input-number: supports mouse wheel control (#9591) (6ce3545)
  • input,input-number: add additional options for focus method (#9595) (c336711)
  • qrcode: support nzType and nzBoostLevel, delete array usage of nzPadding (#9535) (5419b51)

Bug Fixes

  • icon: include nzSpin in change detection logic (#9598) (7d3c637)
  • select: disable nzAutoClearSearchValue in single mode (#9605) (4720c21)

21.0.0-next.2

⚠ BREAKING CHANGES

  • tabs: 移除已弃用的 nz-tabset selector (#9613) (d5e5772)
  • qrcode: nzPadding 类型从 number | number[] 调整为 number (#9535) (5419b51)

Features

  • color-picker: 新增 nzPresets 参数支持预设颜色 (#9341) (d59ec99)
  • date-picker: 日期范围选择顺序颠倒时确保能输出正确的范围 (#9518) (d0b3185)
  • input-number: 支持鼠标滚轮控制 (#9591) (6ce3545)
  • input,input-number: focus 方法新增额外参数 (#9595) (c336711)
  • qrcode: 新增 nzType 和 nzBoostLevel 参数 (#9535) (5419b51)

Bug Fixes

  • icon: 将 nzSpin 纳入变更检测逻辑，修复图标旋转状态在某些情况下无法及时更新 (#9597) (46dc381)
  • select: 单选模式下 nzAutoClearSearchValue 不应生效 (#9605) (4720c21)
Loading

20.4.4

20.4.4

Choose a tag to compare

View all tags
@Laffery Laffery released this 12 Dec 07:40
20.4.4
503a271
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

20.4.4

2025-12-12

Bug Fixes

20.4.4

2025-12-12

Bug Fixes

  • icon: 将 nzSpin 纳入变更检测逻辑，修复图标旋转状态在某些情况下无法及时更新 (#9597) (46dc381)
  • result: 修复仅设置 nzStatus 时图标不显示的问题 (#9568) (#9582) (b652105)
Loading

21.0.0-next.1

21.0.0-next.1 Pre-release
Pre-release

Choose a tag to compare

View all tags
@Laffery Laffery released this 05 Dec 10:12
21.0.0-next.1
948283a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

21.0.0-next.1

2025-12-05

Features

  • schematics: update default test target builder (#9574) (46d39de)

Bug Fixes

  • *: correct usage of signal input nzNoAnimation (#9576) (b418efe)
  • popconfirm: allow null for nzIcon hide icon (#9569) (760b587)
  • schematics: remove NzInputNumberLegacyModule (#9573) (48c02aa)

21.0.0-next.1

2025-12-05

Features

  • schematics: 更新默认的测试 builder (#9574) (46d39de)

Bug Fixes

  • *: 修复 nzNoAnimation 不生效的问题 (#9576) (b418efe)
  • popconfirm: 允许设置 nzIcon 为 null 以隐藏图标 (#9569) (760b587)
  • schematics: 移除 NzInputNumberLegacyModule 的迁移 schematic (#9573) (48c02aa)
Loading

21.0.0-next.0

21.0.0-next.0 Pre-release
Pre-release

Choose a tag to compare

View all tags
@Laffery Laffery released this 28 Nov 08:19
21.0.0-next.0
ae9ad57
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

21.0.0-next.0

2025-11-28

Upgrade with shell

ng update ng-zorro-antd@next

Features

Bug Fixes

  • tree: no preventDefault when right-clicking the node title (#9532) (900efad)

⚠ BREAKING CHANGES

  • tree-view: nzTreeControl has been removed, please use nzLevelAccessor or nzChildrenAccessor instead
  • statistic: rename NzStatisticNumberComponent to NzStatisticContentValueComponent
  • color-picker: change DOM structure to be simpler, and remove no unnecessary payload of nzClick output
  • watermark: change import path from ng-zorro-antd/water-mark to ng-zorro-antd/watermark
  • back-top: removed, please use float-button instead
  • input-number-legacy: removed, please use input-number instead

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

Module API
ng-zorro-antd/back-top *
ng-zorro-antd/dropdown NzDropdownButtonDirective
ng-zorro-antd/input-number-legacy *
ng-zorro-antd/core NzHighlightModule
ng-zorro-antd/auto-complete NZ_AUTOCOMPLETE_VALUE_ACCESSOR
ng-zorro-antd/checkbox nz-checkbox-wrapper
ng-zorro-antd/date-picker NzDatePickerComponent#nzBorderless
ng-zorro-antd/input NzInputDirective#nzBorderless
ng-zorro-antd/input-number NzInputNumberComponent#nzBordered
ng-zorro-antd/mention NZ_MENTION_TRIGGER_ACCESSOR
ng-zorro-antd/select NzSelectComponent#nzBorderless
ng-zorro-antd/time-picker NzTimePickerComponent#nzBorderless
ng-zorro-antd/tooltip NzToolTipModule NzToolTipComponent

Unify and standardize component naming, involving the following name changes:

Module Original Current
core NzConfig#backTop NzConfig#floatButton
core NzConfig#dropDown NzConfig#dropdown
dropdown NzDropDownModule NzDropdownModule
dropdown NzDropDownADirective NzDropdownADirective
menu NzIsMenuInsideDropDownToken NzIsMenuInsideDropdownToken
watermark NzWaterMarkModule NzWatermarkModule
watermark NzWaterMarkComponent NzWatermarkComponent

Deprecations

The following APIs are marked as deprecated in v20 and will be removed in the next major version.
Please refer to related documentation for better alternatives.

Module API
ng-zorro-antd/input textarea[nzAutosize]

21.0.0-next.0

2025-11-28

通过 @angular/cli 升级

ng update ng-zorro-antd@next

Features

  • core: 新增 provideNzNoAnimation provider 用于禁用动画效果 (#9555) (c945e81)
  • float-button: 悬浮按钮组合新增动画效果 (#9413) (b40ad91)
  • tree-view: 升级 tree-view 组件，支持 nzLevelAccessor 和 nzChildrenAccessor (#9003) (ae9ad57)
  • upload: 新增 nzMaxCount 属性 (#9424) (0bf13c3)
  • schematics: 支持 v21 迁移 (#9564) (a44227d)

Bug Fixes

  • tree: 不再阻止右键点击树节点标题的默认行为 (#9532) (900efad)

⚠ BREAKING CHANGES

  • tree-view: 移除 nzTreeControl，请使用 nzLevelAccessor 或 nzChildrenAccessor 替代
  • statistic: 重命名 NzStatisticNumberComponent 为NzStatisticContentValueComponent
  • color-picker: 简化 DOM 结构，移除 nzClick output 不必要的参数
  • watermark: 将引入路径 ng-zorro-antd/water-mark 调整为 ng-zorro-antd/watermark
  • back-top: 移除，请使用 float-button 替代
  • input-number-legacy: 移除，请使用 input-number 替代

移除以下在过去的版本中标记为废弃的 API:

Module API
ng-zorro-antd/back-top *
ng-zorro-antd/input-number-legacy *
ng-zorro-antd/dropdown NzDropdownButtonDirective
ng-zorro-antd/core NzHighlightModule
ng-zorro-antd/auto-complete NZ_AUTOCOMPLETE_VALUE_ACCESSOR
ng-zorro-antd/checkbox nz-checkbox-wrapper
ng-zorro-antd/date-picker NzDatePickerComponent#nzBorderless
ng-zorro-antd/input NzInputDirective#nzBorderless
ng-zorro-antd/input-number NzInputNumberComponent#nzBordered
ng-zorro-antd/mention NZ_MENTION_TRIGGER_ACCESSOR
ng-zorro-antd/select NzSelectComponent#nzBorderless
ng-zorro-antd/time-picker NzTimePickerComponent#nzBorderless
ng-zorro-antd/tooltip NzToolTipModule NzToolTipComponent

统一组件命名规范，变化如下：

Module Original Current
core NzConfig#backTop NzConfig#floatButton
core NzConfig#dropDown NzConfig#dropdown
dropdown NzDropDownModule NzDropdownModule
dropdown NzDropDownADirective NzDropdownADirective
menu NzIsMenuInsideDropDownToken NzIsMenuInsideDropdownToken
watermark NzWaterMarkModule NzWatermarkModule
watermark NzWaterMarkComponent NzWatermarkComponent

Deprecations

在 v21 中，以下 API 被标记为 deprecated，并将在下一个主要版本中移除。 请参考相关文档以获取更好的替代方案。

Module API
ng-zorro-antd/input textarea[nzAutosize]
Loading

20.4.3

20.4.3

Choose a tag to compare

View all tags
@Laffery Laffery released this 28 Nov 03:09
20.4.3
a60c65a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

20.4.3

2025-11-28

Bug Fixes

20.4.3

2025-11-28

Bug Fixes

  • form: 修复无法禁用 nz-form-control 动画的问题 (#9562) (5bccf96)
  • input: 修复循环依赖问题 (#9561) (8d5782d)
Loading

20.4.2

20.4.2

Choose a tag to compare

View all tags
@Laffery Laffery released this 21 Nov 06:46
20.4.2
ca4d415
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

20.4.2

2025-11-21

Bug Fixes

  • cascader,select,date-picker,time-picker,tree-select: add missing nzVariant global config (#9543) (221386b)
  • button: improve icon only logic in zoneless mode (#9541) (9def420)

2025-11-21

Bug Fixes

  • cascader,select,date-picker,time-picker,tree-select: 补充 nzVariant 全局配置类型定义 (#9543) (221386b)
  • button: 优化 zoneless 模式下仅图标展示的逻辑 (#9541) (9def420)
Loading

20.4.1

20.4.1

Choose a tag to compare

View all tags
@Laffery Laffery released this 14 Nov 12:33
20.4.1
f1d4f34
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

20.4.1

2025-11-14

Bug Fixes

  • badge: hex nzColor should work (#9517) (47d44ba)
  • cascader: fix zoneless NG0100 issue (#9504) (24b4e83)
  • color-picker: fix NG01350 error (#9525) (fbcb8c3)
  • dropdown: update arrow placement once the position of connected overlay changes (#9519) (7ff7e09)
  • input: render icon when enterButton is an empty string (#9498) (6a40b0d)
  • result: nz-result-icon in ng-content does not work (#9511) (0e095a1)
  • segmented: should not block the selected$ if no animation (#9512) (af8b531)
  • select: correct font size in small size (#9516) (6f79005)

20.4.1

2025-11-14

Bug Fixes

  • badge: 修复十六进制 nzColor 不生效问题 (#9517) (47d44ba)
  • cascader: 修复 zoneless NG0100 问题 (#9504) (24b4e83)
  • color-picker: 修复 NG01350 问题 (#9525) (fbcb8c3)
  • dropdown: 修复部分情形箭头位置不正确 (#9519) (7ff7e09)
  • input: 修复 nz-input-search enterButton 为空字符串时搜索图标不渲染 (#9498) (6a40b0d)
  • result: 修复 ng-content 中的 nz-result-icon 不生效的问题 (#9511) (0e095a1)
  • segmented: 修复禁用动画效果时选中不生效的问题 (#9512) (af8b531)
  • select: 校正 small 尺寸下的字体大小 (#9516) (6f79005)
Loading