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)

20.2.0

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

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)

20.1.2

20.1.2

2025-08-08

Bug Fixes

• input-number: make sure the displayed value is correct (#9312) (7a2d3b6)
• select,tree-select,cascader: selected item with long label displayed in ellipsis (#9316) (30672d7)
• table: add cdkScrollable to internal scrolling element (#9308) (8cb4113)

---

20.1.2

2025-08-08

Bug Fixes

• input-number: 修复展示值不正确的问题 (#9312) (7a2d3b6)
• select,tree-select,cascader: 已选项文本超出时展示省略号 (#9316) (30672d7)
• table: 内部滚动元素增加 cdkScrollable 指令 (#9308) (8cb4113)

20.1.1

20.1.1

2025-08-05

Bug Fixes

• badge: export NzBadgeStatusType type (#9298) (91b1ad7)
• layout: fix showcases (#9303) (9a37ef8)

---

20.1.1

2025-08-05

Bug Fixes

• badge: 导出 NzBadgeStatusType 类型 (#9298) (91b1ad7)
• layout: 修复代码示例问题 (#9303) (9a37ef8)

20.1.0

---

20.1.0

2025-07-21

Features

• add llms.txt and llms-full.txt (#9281) (165b963)
• float-button: support nzPlacement (#9267) (9dc19f3)
• input-number: accepted numbers with commas (#9256) (7567bd8)
• input: input-otp supports keyboard control positioning (#9268) (da97b02)
• popconfirm: add nzDanger support to cancel button (#9270) (f94cb31)
• space: support array for size (#9289) (8809885)
• schematics: align with the updated style guide (#9295) (b5f607b)

Bug Fixes

• core: avoid using setAttribute to set style (#9292) (12d58bd)
• input-number: ngModel value can be undefined (#9269) (4c5666a)
• tooltip: rename ToolTip to Tooltip (#9285) (2ebef97)
• schematics: support NzTooltipModule migration (#9294) (add21f7)

---

20.1.0

2025-07-21

Features

• 新增 llms.txt 和 llms-full.txt (#9281) (165b963)
• float-button: 新增 nzPlacement 属性自定义弹出位置 (#9267) (9dc19f3)
• input-number: 支持输入的数字带 , (#9256) (7567bd8)
• input: 一次性密码框支持通过键盘控制光标位置 (#9268) (da97b02)
• popconfirm: 取消按钮支持设置 nzDanger 属性 (#9270) (f94cb31)
• space: 支持通过数组形式设置 nzSize (#9289) (8809885)
• schematics: 对齐 Angular 20 更新的风格指南 (#9295) (b5f607b)

Bug Fixes

• core: 避免使用 setAttribute 设置 style (#9292) (12d58bd)
• input-number: ngModel 的值可为 undefined (#9269) (4c5666a)
• tooltip: 重命名 ToolTip 为 Tooltip (#9285) (2ebef97)
• schematics: 支持迁移 ToolTip 到 Tooltip (#9294) (add21f7)

20.0.0

---

20.0.0

2025-07-01

Features

• cascader,date-picker,input-number,input,select,time-picker,tree-select: support nzVariant (#9131) (b342bb4)
• popover: add nzPopoverTitleContext and nzPopoverContentContext (#9126) (df3ead9)
• select: add nzOnClear callback (#9188) (e047ac2)
• avatar: add loading and fetchpriority attributes (#7347) (ff8419f)
• popconfirm: add nzOkButtonProps and nzCancelButtonProps (#9245) (22e2a9f)
• tree-select: render title of selected node in innerHTML (#9259) (8066f7b)

Bug Fixes

• flex: fix NzAlign type (#9151) (b271c19)
• segmented: accepts disabled state from ng control (#9166) (134cd59)
• space: border radius compact mode one item (#9165) (d2f4541)
• tabs: prevent incorrect scroll offset on tab focus (#9186) (4f658e0)
• schematics: ng add failed when call twice (#9171) (d0a9748)
• water-mark: make server-side compatible (#9250) (a70a682)
• icon: debounce icon rendering on animation frame (#8579) (c0709d1)

Code Refactoring

• core: cleanup animation frame polyfill (#9243) (272237a)
• migrate to inject pattern

⚠ BREAKING CHANGES

• core: refactoring in ng-zorro-antd/core/polyfill:
  • rename cancelRequestAnimationFrame to cancelAnimationFrame
  • rename reqAnimFrame to requestAnimationFrame
• tabs: rename NzTabsetComponent to NzTabsComponent, nz-tabset selector to nz-tabs, the original component and selector are marked as deprecated
• table: no longer compatible with material components
• popconfirm: nzOkDisabled and nzOkDanger are marked as deprecated, use nzOkButtonProps and nzCancelButtonProps instead

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

Module	API
ng-zorro-antd/button	NzButtonGroupComponent
ng-zorro-antd/core/form	NzFormPatchModule
ng-zorro-antd/checkbox	NzCheckBoxOptionInterface
ng-zorro-antd/input	NzInputGroupComponent#nzCompact
ng-zorro-antd/message	NzMessageModule
ng-zorro-antd/notification	NzNotificationModule NzNotificationServiceModule

The exportAs of components are updated to follow camelCase and start with nz, exportAs of internal components are removed. Changes can be seen as follow:

Component	Original	Current
calendar-footer	calendarFooter	-
date-helper	dateHelper	-
date-range-popup	dateRangePopup	-
date-table	dateTable	-
decade-helper	decadeHelper	-
decade-table	decadeTable	-
month-helper	monthHelper	-
month-table	monthTable	-
quarter-helper	quarterHelper	-
quarter-table	quarterTable	-
year-helper	yearHelper	-
year-table	yearTable	-
inner-popup	innerPopup	-
nz-color-block	NzColorBlock	nzColorBlock
nz-color-format	NzColorFormat	nzColorFormat
nz-color-picker	NzColorPicker	nzColorPicker
nz-model-close	NzModalCloseBuiltin	nzModalCloseBuiltin
nz-model-footer	NzModalFooterBuiltin	nzModalFooterBuiltin
nz-model-title	NzModalTitleBuiltin	nzModalTitleBuiltin
nz-tree-drop-indicator	NzTreeDropIndicator	nzTreeDropIndicator
nz-water-mark	NzWaterMark	nzWaterMark
nz-tabs	nzTabset	nzTabs

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/autocomplete	NZ_AUTOCOMPLETE_VALUE_ACCESSOR getNzAutocompleteMissingPanelError
ng-zorro-antd/button	NzButtonGroupComponent
ng-zorro-antd/core/form	NzFormPatchModule
ng-zorro-antd/core/highlight	NzHighlightModule
ng-zorro-antd/checkbox	NzCheckBoxOptionInterface
ng-zorro-antd/input	NzInputGroupComponent#nzCompact
ng-zorro-antd/mention	NZ_MENTION_TRIGGER_ACCESSOR
ng-zorro-antd/message	NzMessageModule
ng-zorro-antd/notification	NzNotificationModule NzNotificationServiceModule
ng-zorro-antd/tabs	NzTabsetComponent

---

20.0.0

2025-07-01

Features

• cascader,date-picker,input-number,input,select,time-picker,tree-select: 新增 nzVariant 属性设置变体 (#9131) (b342bb4)
• popover: 新增 nzPopoverTitleContext 和 nzPopoverContentContext 属性 (#9126) (df3ead9)
• select: 新增 nzOnClear 事件回调 (#9188) (e047ac2)
• avatar: 支持设置原生 <img> 的 loading 和 fetchpriority 属性 (#7347) (ff8419f)
• popconfirm: 新增 nzOkButtonProps 和 nzCancelButtonProps (#9245) (22e2a9f)
• tree-select: 支持以 innerHTML 渲染已选项的 title (#9259) (8066f7b)

Bug Fixes

• flex: 修复 NzAlign 类型 (#9151) (b271c19)
• segmented: 接受 ng control 的禁用状...