Skip to content

Releases: NG-ZORRO/ng-zorro-antd

Release list

20.0.0-beta.0

20.0.0-beta.0 Pre-release
Pre-release

Choose a tag to compare

View all tags
@Laffery Laffery released this 27 Jun 05:57
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.

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.0.0-next.1 Pre-release
Pre-release

Choose a tag to compare

View all tags
@Laffery Laffery released this 20 Jun 02:35
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.

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

20.0.0-next.0 Pre-release
Pre-release

Choose a tag to compare

View all tags
@Laffery Laffery released this 13 Jun 03:46
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.

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

19.3.1

19.3.1

Choose a tag to compare

View all tags
@Laffery Laffery released this 29 May 08:44
19.3.1
5fd3a79
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

19.3.1

2025-05-29

Bug Fixes

  • cascader: cannot update value when it is missing in options (#9124) (689fc72)
  • date-picker: update input value when nzFormat changed (#9129) (f4c4e05)
  • tabs: nzLinkRouter not work for the first time load (#9130) (925a6a5)

19.3.1

2025-05-29

Bug Fixes

  • cascader: ngModel 值在选项中不存在时无法更新值 (#9124) (689fc72)
  • date-picker: nzFormat 改变时更新 input 元素的值 (#9129) (f4c4e05)
  • tabs: 修复首次加载页面时 nzLinkRouter 不生效的问题 (#9130) (925a6a5)
Loading

19.3.0

19.3.0

Choose a tag to compare

View all tags
@Laffery Laffery released this 23 May 05:56
19.3.0
e53e54d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

19.3.0

2025-05-23

Features

  • avatar: support custom icon by ng-content (#9090) (89d0767)
  • input-number: add nzBlur and nzFocus output (#9098) (1b1a013)
  • tabs: support for start and end extra content (#9097) (2500821)
  • transfer: support multiple row selection with Shift key (#9092) (b78b99f)

Bug Fixes

  • i18n: add missing translations to es_ES (#9127) (0aadfdf)
  • segmented: fix emitting unnecessary value changed events (#9125) (fb0635b)
  • tabs: nzLinkRouter not work for the first time (#9118) (0f7f94d)

Performance Improvements

  • transfer: use item.key as tracking for the list render (#9123) (adb91e4)

19.3.0

2025-05-23

Features

  • avatar: 支持通过 ng-content 自定义图标 (#9090) (89d0767)
  • input-number: 新增 Output 属性 nzBlur 和 nzFocus (#9098) (1b1a013)
  • tabs: 附加内容支持 start 和 end 两种位置 (#9097) (2500821)
  • transfer: 支持键入 Shift 后多选 (#9092) (b78b99f)

Bug Fixes

  • i18n: 更新 es_ES 国际化文案 (#9127) (0aadfdf)
  • segmented: 修复初始化时发射不必要的值更新事件 (#9125) (fb0635b)
  • tabs: 修复首次加载页面时 nzLinkRouter 不生效的问题 (#9118) (0f7f94d)

Performance Improvements

  • transfer: 使用 item.key 跟踪数据条目 (#9123) (adb91e4)
Loading

19.2.2

19.2.2

Choose a tag to compare

View all tags
@Laffery Laffery released this 25 Apr 04:59
19.2.2
10c70a3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

19.2.2

2025-04-25

Bug Fixes

19.2.2

2025-04-25

Bug Fixes

  • select: 多选模式下，限制粘贴后的选项数不超过 nzMaxMultipleCount (#9080) (3714840)
  • input-number: 修复 NG0600 错误 (#9106) (9f5b525)
  • checkbox: 修复 NG0600 错误 (#9105) (61b6886)
  • checkbox: 修正 nzOptions 的类型定义 (#9099) (7be2fe5)
Loading

19.2.1

19.2.1

Choose a tag to compare

View all tags
@Laffery Laffery released this 29 Mar 03:23
19.2.1
81dc51d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

19.2.1

2025-03-29

Bug Fixes

  • select: remove internal comment from select-arrow (#9074) (c9b2dd9)

19.2.1

2025-03-29

Bug Fixes

  • select: 修复 @internal 注释导致 select-arrow 组件在编译时未导出 (#9074) (c9b2dd9)
Loading

19.2.0

19.2.0

Choose a tag to compare

View all tags
@Laffery Laffery released this 28 Mar 02:04
19.2.0
b4bb14e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

19.2.0

2025-03-28

Features

Documentation

  • tabs: add draggable tabs showcase via CDK DragDropModule

Bug Fixes

  • input-number: consider input value ends with 0 as incomplete (#9051) (2a0c2e0)
  • segmented: fix error with the FormControl first change (#9039) (33fe53d)
  • select: disable nzMaxMultipleCount in default mode (#9068) (dcf8a5d)
  • select: ngModel change should update state of nzMaxMultipleCount reached (#9056) (d7031da)
  • space: nzSpaceItem margin in rtl (#7801) (2d9ff5f)
  • tabs: update active router tab after tabs changed (#7649) (1f07121)
  • tree-select: enable overflow-x for virtual scroll (#9045) (e70cae3)

19.2.0

2025-03-28

Features

  • splitter: 新增 splitter 组件 (#8987) (9b3f62e)
  • page-header: 无路由历史时隐藏回退按钮 (#9041) (bb48232)

Documentation

  • tabs: 新增使用 CDK DragDropModule 实现可拖拽页签的示例

Bug Fixes

  • input-number: 输入数字以 0 结尾时视作输入进行中 (#9051) (2a0c2e0)
  • segmented: 修复 FormControl 第一次更新时不生效 (#9039) (33fe53d)
  • select: 默认模式下禁用 nzMaxMultipleCount 属性 (#9068) (dcf8a5d)
  • select: 多选模式下 ngModel 值变化时更新是否达到 nzMaxMultipleCount 的状态 (#9056) (d7031da)
  • space: 修复 rtl 模式下 nzSpaceItem 的行内边距 (#7801) (2d9ff5f)
  • tabs: tabs 改变时更新活动的路由联动页签 (#7649) (1f07121)
  • tree-select: 修复虚拟滚动下选项无法水平滚动 (#9045) (e70cae3)
Loading

19.1.0

19.1.0

Choose a tag to compare

View all tags
@Laffery Laffery released this 21 Feb 09:56
19.1.0
85fb1fa
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

19.1.0

2025-02-21

Features

  • check-list: add check-list component (#8969) (4cd298b)
  • message,notification: display nzData when content is a template (#9001) (5157470)
  • popover,popconfirm,tooltip: overlayClassName supports space delimited classes string (#8972) (3fcec91)
  • popover: add nzPopoverOverlayClickable to disable click on mask (#8878) (5898da7)

Bug Fixes

  • input-number,checkbox: accept the disabled change from ng control (#8979) (2d8968d)
  • input-number: use input event instead of change event (#8989) (6d8d915)
  • tree-select: fix error when judging multiple instances condition (#9008) (5006ea6)

Code Refactoring

Now feel free to use isolatedModules compiler option in your project.

19.1.0

2025-02-21

Features

  • check-list: 新增 CheckList 组件 (#8969) (4cd298b)
  • message,notification: 内容为模板时支持通过 nzData 传入数据 (#9001) (5157470)
  • popover,popconfirm,tooltip: 支持空格分割的字符串作为 overlayClassName (#8972) (3fcec91)
  • popover: 支持通过 nzPopoverOverlayClickable 禁止点击蒙层关闭面板 (#8878) (5898da7)

Bug Fixes

  • input-number,checkbox: 接受来自 control 的禁用状态变化 (#8979) (2d8968d)
  • input-number: 修复一系列输入事件问题，详见 (#8989) (6d8d915)
  • tree-select: 修复判断多个实例条件错误 (#9008) (5006ea6)

Code Refactoring

现在你可以在项目中使用 isolatedModules 编译选项。

Loading

19.0.2

19.0.2

Choose a tag to compare

View all tags
@Laffery Laffery released this 10 Jan 06:13
19.0.2
9ecbb29
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

19.0.2

2025-01-10

Bug Fixes

  • auto-complete: should open the popover when the focused input is clicked (#8900) (79cc2f8)
  • progress: fix NG0956 error (#8962) (c4d2f81)
  • transfer: correctly set the transfer-list-body class (#8960) (a3546a9)

19.0.2

2025-01-10

Bug Fixes

Loading