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:

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-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:

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

Deprecations

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

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

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

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

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

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

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

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)

20.2.0

2025-08-29

Features

• cascader: add nzOpen to control visibility (#9339) (354c7cf)
• collapse: support nzCollapsible (#9349) (1ddbcaf)
• collapse: support nzSize (#9348) (b5c256d)
• divider: support nzSize (#9346) (1f54536)
• dropdown: display arrow for content dropdown (#9329) (3686b73)
• float-button: nzIcon support string type (#9302) (ce611e5)
• segmented: support nzVertical (#9359) (52322cd)
• select,tree-select,cascader: support prefix and suffix icon (#9328) (527ffb6)
• tag: export NzTagColor type (#9314) (1efd29e)

Bug Fixes

• carousel: wrong dot position when placement is left or right (#9358) (f117ccb)
• range-picker: clear outline on mouse leaving (#9352) (573d092)
• segmented: should render single element in item if icon-only (#9363) (89d2168)

20.2.0

2025-08-29

Features

• cascader: 新增 nzOpen 属性控制可见性 (#9339) (354c7cf)
• collapse: 新增 nzCollapsible 设置可折叠触发区域 (#9349) (1ddbcaf)
• collapse: 新增 nzSize 设置折叠面板大小 (#9348) (b5c256d)
• divider: 新增 nzSize 设置分割线大小 (#9346) (1f54536)
• dropdown: 新增 nzArrow 属性控制是否展示箭头 (#9329) (3686b73)
• float-button: nzIcon 支持字符串类型 (#9302) (ce611e5)
• segmented: 新增 nzVertical 属性支持展示垂直方向 (#9359) (52322cd)
• select,tree-select,cascader: 支持设置前缀和后缀图标 (#9328) (527ffb6)
• tag: 导出 NzTagColor 类型 (#9314) (1efd29e)

Bug Fixes

• carousel: nzDotPotion 为 left 或 right 时指示点位置不正确 (#9358) (f117ccb)
• range-picker: 鼠标离开时清理 outline (#9352) (573d092)
• segmented: 仅图标时应只渲染一个元素 (#9363) (89d2168)

20.1.3

2025-08-22

Bug Fixes

• i18n: add missing translations to cs_CZ (#9334) (93e486e)
• i18n: add missing translations to sk_SK (#9335) (ddefc7f)
• cascader: invalid value and label when binding dynamically (#9338) (324ab5b)
• popconfirm: correctly render icon & title (#9322) (2c83788)
• select: shaking when closing dropdown if use a TemplateRef as nzNotFoundContent (#9336) (366f8eb)

20.1.3

2025-08-22

Bug Fixes

• i18n: 更新 cs_CZ 国际化文案 (#9334) (93e486e)
• i18n: 更新 sk_SK 国际化文案 (#9335) (ddefc7f)
• cascader: 动态绑定时 value 和 label 不正确的问题 (#9338) (324ab5b)
• popconfirm: 正确渲染标题和图标 (#9322) (2c83788)
• select: 修复使用 TemplateRef 作为 nzNotFoundContent 时关闭下拉框时抖动的问题 (#9336) (366f8eb)