20.4.4

20.4.4

2025-12-12

Bug Fixes

• icon: include nzSpin in change detection logic (#9597) (46dc381)
• result: show default icon based on status (#9568) (#9582) (b652105)

---

20.4.4

2025-12-12

Bug Fixes

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

21.0.0-next.1

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)

21.0.0-next.0

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]

20.4.3

20.4.3

2025-11-28

Bug Fixes

• form: animation should respect NoopAnimations (#9562) (5bccf96)
• input: fix dependency cycle (#9561) (8d5782d)

---

20.4.3

2025-11-28

Bug Fixes

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

20.4.2

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)

20.4.1

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)

20.4.0

20.4.0

2025-10-31

Features

• cascader: control the visibility of popup panel by nzOpen (#9448) (4d5ec65)
• cascader: toggle checkbox of option by ENTER key in multiple mode (#9457) (e02f1f4)
• float-button: support nzBadge (#9489) (12beec7)
• form: support nzRequiredMark (#9447) (800b6cf)
• input-number: add affix and addon inputs (#9451) (dbebd02)
• input: add nzAllowClear input and nzClear callback (#9452) (830b4b3)
• input: introduce new component nz-input-wrapper (#9408) (a8e56ec), closes #9403
• input: add affix and addon inputs to nz-input-wrapper (#9450) (763f69e)
• input: introduce nz-input-search directive (#9483) (af6f590)
• input: introduce nz-input-password directive (#9460) (f80832a)
• message: add support for custom styles and classes (#9427) (2f866b3)
• pagination: support nzAlign (#9433) (88d0864)
• segmented: add default name if nzName is not provided (#9466) (33f8142)

Bug Fixes

• badge: should nzStyle work even if nzColor is not provided (#9486) (4424eb0)
• cascader: display activated column correctly when reopen the popup panel (#9456) (7802a39)

---

20.4.0

2025-10-31

Features

• cascader: 支持通过设置 nzOpen 使弹出面板完全受控 (#9448) (4d5ec65)
• cascader: 多选模式下支持通过 ENTER 按钮改变选项 checkbox 值 (#9457) (e02f1f4)
• float-button: 新增 nzBadge 属性设置徽标 (#9489) (12beec7)
• form: 新增 nzRequiredMark 属性自定义必选与可选样式 (#9447) (800b6cf)
• input-number: 新增前置和后置元素的 inputs 属性 (#9451) (dbebd02)
• input: 新增 nzAllowClear 属性以及 nzClear 回调 (#9452) (830b4b3)
• input: 新增组件 nz-input-wrapper (#9408) (a8e56ec), closes #9403
• input: 为 nz-input-wrapper 新增前置和后置元素的 inputs 属性 (#9450) (763f69e)
• input: 新增 nz-input-search 指令 (#9483) (af6f590)
• input: 新增 nz-input-password 指令 (#9460) (f80832a)
• message: 支持自定义样式 (#9427) (2f866b3)
• pagination: 新增 nzAlign 属性 (#9433) (88d0864)
• segmented: nzName 未设置时支持默认 name (#9466) (33f8142)

Bug Fixes

• badge: 修复 nzColor 未设置时 nzStyle 不生效的问题 (#9486) (4424eb0)
• cascader: 重新打开弹出面板时正确展示激活的列 (#9456) (7802a39)

20.3.1

20.3.1

2025-09-17

Bug Fixes

• drawer: fix NG0203 (#9418) (7fb58ae)

---

20.3.1

2025-09-17

Bug Fixes

• drawer: 修复 NG0203 问题 (#9418) (7fb58ae)

20.3.0

20.3.0

2025-09-16

Features

• carousel: support nzArrows (#9355) (1b9714b)
• check-list: add badge and default checked (#9343) (235b493)
• i18n: enhance provideNzI18n to support factory function (#9393) (1371265)
• mention: support nzClear (#9377) (cbecebf)
• mention: support nzVariant (#9379) (d92568b)
• segmented: support nzShape(#9368) (ffce6c3)
• segmented: support nzName and keyboard interactions (#9373) (ebd8bdc)
• upload: support promise return type for nzBeforeUpload (#9402) (cece107)

Bug Fixes

• badge: after setting nzColor, display incorrect (#9376) (e9abf92)
• input: variant underline style on hover (#9400) (74c2173)
• segmented: fix NG0950 error (#9386) (e82fc01)
• select: refactor multiple select styles (#9409) (38f9065)
• schematics: add less as devDependencies if choosing custom theme in non-less project (#9412) (a18cffd)

---

20.3.0

2025-09-16

Features

• carousel: 新增 nzArrows 属性 (#9355) (1b9714b)
• check-list: 清单项支持定义默认是否完成 (#9343) (235b493)
• i18n: provideNzI18n 支持 factory function 作为参数 (#9393) (1371265)
• mention: 新增 nzClear 属性 (#9377) (cbecebf)
• mention: 新增 nzVariant 属性 (#9379) (d92568b)
• segmented: 新增 nzShape 属性 (#9368) (ffce6c3)
• segmented: 新增 nzName 属性并支持键盘交互 (#9373) (ebd8bdc)
• upload: nzBeforeUpload 支持 promise 返回类型 (#9402) (cece107)

Bug Fixes

• badge: 设置 nzColor 后徽标渲染异常 (#9376) (e9abf92)
• input: 修复 underline 变体下 hover 时样式问题 (#9400) (74c2173)
• segmented: 修复 NG0950 错误 (#9386) (e82fc01)
• select: 修复多选模式下样式异常 (#9409) (38f9065)
• schematics: 在非 LESS 项目中，选择自定义主题后将 less 添加到 devDependencies (#9412) (a18cffd)

20.2.1

20.2.1

2025-08-31

20.2.1 (2025-08-31)

Bug Fixes

• segmented: correctly render with-icon & icon-only (#9367) (9d42b42)

---

20.2.1

2025-08-31

20.2.1 (2025-08-31)

Bug Fixes

• segmented: 带图标的和仅设置图标时正确渲染 (#9367) (9d42b42)