NG-ZORRO/ng-zorro-antd 21.0.0

on GitHub

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:

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

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.

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 为 NzStatisticContentValueComponent
• tabs: 移除已弃用的 nz-tabset selector
• tree-view: 移除 nzTreeControl，请使用 nzLevelAccessor 或 nzChildrenAccessor 替代
• watermark: 将引入路径 ng-zorro-antd/water-mark 调整为 ng-zorro-antd/watermark

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

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

Deprecations

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