Skip to content

Releases: NG-ZORRO/ng-zorro-antd

20.2.1

01 Sep 00:18
@Laffery Laffery
20.2.1
3f81720
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
20.2.1 Latest
Latest

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)
Assets 2
Loading

20.2.0

29 Aug 10:06
@Laffery Laffery
20.2.0
52d61b8
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
20.2.0

20.2.0

2025-08-29

Features

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)
Loading

20.1.3

22 Aug 02:34
@Laffery Laffery
20.1.3
19f5321
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
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)
Loading

20.1.2

08 Aug 02:57
@Laffery Laffery
20.1.2
77e0b62
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
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)
Loading

20.1.1

05 Aug 03:22
@Laffery Laffery
20.1.1
d3bc0ee
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
20.1.1

20.1.1

2025-08-05

Bug Fixes

20.1.1

2025-08-05

Bug Fixes

Loading

20.1.0

21 Jul 07:05
@Laffery Laffery
20.1.0
2cf9941
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
20.1.0

20.1.0

2025-07-21

Features

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

Bug Fixes

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

20.0.0

01 Jul 08:32
@Laffery Laffery
20.0.0
2c7c402
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
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 的禁用状...
Read more
Loading

20.0.0-beta.0

27 Jun 05:57
@Laffery Laffery
20.0.0-beta.0
bf2b33b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
20.0.0-beta.0 Pre-release
Pre-release

20.0.0-beta.0

2025-06-27

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)

Bug Fixes

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/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-beta.0

2025-06-27

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)

Bug Fixes

Read more
Loading

20.0.0-next.1

20 Jun 02:35
@Laffery Laffery
20.0.0-next.1
5f2895e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
20.0.0-next.1 Pre-release
Pre-release

20.0.0-next.1

2025-06-20

Features

Bug Fixes

  • schematics: ng add failed when call twice (#9171) (d0a9748)

Code Refactoring

  • migrate to inject pattern

BREAKING CHANGES

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

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/mention NZ_MENTION_TRIGGER_ACCESSOR

20.0.0-next.1

2025-06-20

Features

Bug Fixes

  • schematics: 修复重复执行 ng add 时的问题 (#9171) (d0a9748)

Code Refactoring

  • 从基于 constructor 的依赖注入模式迁移到 inject

BREAKING CHANGES

组件的 exportAs 属性命名统一采用小驼峰 camelCase 且以 nz 开头，并移除一些内部组件的 exportAs 属性。变化如下：

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

Deprecations

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

Module API
ng-zorro-antd/autocomplete NZ_AUTOCOMPLETE_VALUE_ACCESSOR
getNzAutocompleteMissingPanelError
ng-zorro-antd/mention NZ_MENTION_TRIGGER_ACCESSOR
Loading

20.0.0-next.0

13 Jun 03:46
@Laffery Laffery
20.0.0-next.0
06e2696
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
20.0.0-next.0 Pre-release
Pre-release

20.0.0-next.0

2025-06-13

Features

  • cascader,date-picker,input-number,input,select,time-picker,tree-select: support nzVariant (#9131) (b342bb4)
  • popover: add nzPopoverTitleContext and nzPopoverContentContext (#9126) (df3ead9)

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)

BREAKING CHANGES

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

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/dropdown NzDropdownButtonDirective
ng-zorro-antd/date-picker NzDatePickerComponent#nzBorderless
ng-zorro-antd/input NzInputNumberDirective#nzBorderless
ng-zorro-antd/input-number NzInputNumberComponent#nzBordered
ng-zorro-antd/select NzSelectComponent#nzBorderless
ng-zorro-antd/time-picker NzTimePickerComponent#nzBorderless

20.0.0-next.0

2025-06-13

Features

  • cascader,date-picker,input-number,input,select,time-picker,tree-select: 新增 nzVariant 属性设置变体 (#9131) (b342bb4)
  • popover: 新增 nzPopoverTitleContext 和 nzPopoverContentContext 属性 (#9126) (df3ead9)

Bug Fixes

  • flex: 修复 NzAlign 类型 (#9151) (b271c19)
  • segmented: 接受 ng control 的禁用状态 (#9166) (134cd59)
  • space: 紧凑模式下只有一个子元素时的 border-radius 不正确 (#9165) (d2f4541)
  • tabs: 修复 tab focus 时不正确的滚动行为 (#9186) (4f658e0)

BREAKING CHANGES

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

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

Deprecations

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

Module API
ng-zorro-antd/dropdown NzDropdownButtonDirective
ng-zorro-antd/date-picker NzDatePickerComponent#nzBorderless
ng-zorro-antd/input NzInputNumberDirective#nzBorderless
ng-zorro-antd/input-number NzInputNumberComponent#nzBordered
ng-zorro-antd/select NzSelectComponent#nzBorderless
ng-zorro-antd/time-picker NzTimePickerComponent#nzBorderless
Loading