NG-ZORRO/ng-zorro-antd 21.0.0-next.0 on GitHub

21.0.0-next.0

2025-11-28

Upgrade with shell

ng update ng-zorro-antd@next

Features

core: add provideNzNoAnimation (#9555) (c945e81)
float-button: add pop animation to float button menu (#9413) (b40ad91)
tree-view: upgrade tree view component (#9003) (ae9ad57)
upload: add nzMaxCount feature (#9424) (0bf13c3)
schematics: update upgrade data for v21 (#9564) (a44227d)

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]`