Releases: NG-ZORRO/ng-zorro-antd
Releases · NG-ZORRO/ng-zorro-antd
Release list
22.0.1
22.0.1
2026-08-07
Bug Fixes
- dropdown: fix slide animations direction (#9897) (af3ab06)
- input: support Signal Forms state (#9891) (4c64359)
- mention: allow mention triggers after non-space characters (#9896) (5c5be2c)
- modal: keep dragged position on close (#9884) (86bd6b6)
- select: scroll to initial selected option (#9890) (4eb3dcc), closes #9886
22.0.1
2026-08-07
Bug Fixes
22.0.0
22.0.0
2026-07-21
Features
- All components use OnPush change detection strategy (#9824) (b50ea34)
- *: add date adapter support (#9858) (d578c8b)
- upload: support custom actions and extra (#9850) (fd0a22c)
Bug Fixes
- form: signal form compatibility (#9831) (f57fd67)
- select: keep dropdown scroll position when loading more options on scroll (#9872) (1cfeaf9)
⚠ BREAKING CHANGES
Date-related components no longer provide a default date engine adapter. Applications that use date-related components must configure a date adapter explicitly. To keep the previous date-fns based behavior, add provideNzDateFnsAdapter() in app.config.ts.
date-fns has been upgraded to v4. Applications that use date-fns APIs directly should update their imports and date-fns usage to be compatible with v4. (#9868) (a865a89)
Remove the following APIs which were marked as deprecated in the previous version:
| Module | API |
|---|---|
ng-zorro-antd/button |
NzButtonComponent#nzSearch |
ng-zorro-antd/cascader |
NzCascaderComponent#nzDisplayWith |
ng-zorro-antd/collapse |
nz-collapse-panel[nzDisabled] |
ng-zorro-antd/core/form |
NzFormNoStatusService |
ng-zorro-antd/core/services |
NzBreakpointKey |
ng-zorro-antd/dropdown |
NzDropDownModule |
ng-zorro-antd/grid |
EmbeddedProperty |
ng-zorro-antd/input |
textarea[nzAutosize], AutoSizeType, NzAutosizeDirective |
ng-zorro-antd/input |
nz-input-group, NzInputGroupComponent, NzInputGroupWhitSuffixOrPrefixDirective |
ng-zorro-antd/input |
[nz-input-group-slot], NzInputGroupSlotComponent |
ng-zorro-antd/input |
NzInputDirective#nzStepperless |
ng-zorro-antd/message |
NzMessageData#state |
ng-zorro-antd/modal |
nzOnOk / nzOnCancel input usage |
ng-zorro-antd/tooltip |
cdkConnectedOverlayPush |
ng-zorro-antd/transfer |
NzTransferSearchComponent, [nz-transfer-search] |
ng-zorro-antd/upload |
nz-upload[nzTransformFile], NzUploadTransformFileType |
ng-zorro-antd/upload |
ZipButtonOptions#transformFile |
22.0.0
2026-07-21
Features
- 所有组件均使用 OnPush (#9824) (b50ea34)
- *: 新增日期适配器支持 (#9858) (d578c8b)
- upload: 支持自定义操作和额外内容 (#9850) (fd0a22c)
Bug Fixes
⚠ BREAKING CHANGES
日期相关组件不再内置默认日期引擎适配器。使用日期相关组件的应用需要在应用配置中显式提供日期适配器；如需保持旧版本基于 date-fns 的行为，可在 app.config.ts 中配置 provideNzDateFnsAdapter()。
date-fns 已升级至 v4。直接使用 date-fns API 的应用需要更新 import 和相关用法，以兼容 v4 版本。(#9868) (a865a89)
移除以下在过去的版本中标记为废弃的 API:
| Module | API |
|---|---|
ng-zorro-antd/button |
NzButtonComponent#nzSearch |
ng-zorro-antd/cascader |
NzCascaderComponent#nzDisplayWith |
ng-zorro-antd/collapse |
nz-collapse-panel[nzDisabled] |
ng-zorro-antd/core/form |
NzFormNoStatusService |
ng-zorro-antd/core/services |
NzBreakpointKey |
ng-zorro-antd/dropdown |
NzDropDownModule |
ng-zorro-antd/grid |
EmbeddedProperty |
ng-zorro-antd/input |
textarea[nzAutosize], AutoSizeType, NzAutosizeDirective |
ng-zorro-antd/input |
nz-input-group, NzInputGroupComponent, NzInputGroupWhitSuffixOrPrefixDirective |
ng-zorro-antd/input |
[nz-input-group-slot], NzInputGroupSlotComponent |
ng-zorro-antd/input |
NzInputDirective#nzStepperless |
ng-zorro-antd/message |
NzMessageData#state |
ng-zorro-antd/modal |
nzOnOk / nzOnCancel input usage |
ng-zorro-antd/tooltip |
cdkConnectedOverlayPush |
ng-zorro-antd/transfer |
NzTransferSearchComponent, [nz-transfer-search] |
ng-zorro-antd/upload |
nz-upload[nzTransformFile], NzUploadTransformFileType |
ng-zorro-antd/upload |
ZipButtonOptions#transformFile |
21.3.3
21.3.3
2026-07-18
Bug Fixes
- date-picker: preserve range selection behavior (#9873) (1e595e0)
- dropdown,menu: add deprecated aliases for renamed exports (#9860) (9ca8d3d)
- i18n: add missing translations to
ja_JP(#9857) (3bae672) - i18n: add missing translations to
ko_KR(#9864) (c32e64e) - select: restore virtual scroll spacer width (#9874) (200ac21)
21.3.3
2026-07-18
Bug Fixes
22.0.0-beta.0
22.0.0-beta.0 (2026-07-13)
Features
- All components use OnPush change detection strategy (#9824) (b50ea34)
- *: add date adapter support (#9858) (d578c8b)
Bug Fixes
- form: signal form compatibility (#9831) (f57fd67)
- i18n: add missing translations to
ja_JP(#9857) (1ff499e)
⚠ BREAKING CHANGES
Date-related components no longer provide a default date engine adapter. Applications that use date-related components must configure a date adapter explicitly. To keep the previous date-fns based behavior, add provideNzDateFnsAdapter() in app.config.ts.
date-fns has been upgraded to v4. Applications that use date-fns APIs directly should update their imports and date-fns usage to be compatible with v4. (#9868) (a865a89)
Remove the following APIs which were marked as deprecated in the previous version:
| Module | API |
|---|---|
ng-zorro-antd/button |
NzButtonComponent#nzSearch |
ng-zorro-antd/cascader |
NzCascaderComponent#nzDisplayWith |
ng-zorro-antd/collapse |
nz-collapse-panel[nzDisabled] |
ng-zorro-antd/core/form |
NzFormNoStatusService |
ng-zorro-antd/core/services |
NzBreakpointKey |
ng-zorro-antd/dropdown |
NzDropDownModule |
ng-zorro-antd/grid |
EmbeddedProperty |
ng-zorro-antd/input |
textarea[nzAutosize], AutoSizeType, NzAutosizeDirective |
ng-zorro-antd/input |
nz-input-group, NzInputGroupComponent, NzInputGroupWhitSuffixOrPrefixDirective |
ng-zorro-antd/input |
[nz-input-group-slot], NzInputGroupSlotComponent |
ng-zorro-antd/input |
NzInputDirective#nzStepperless |
ng-zorro-antd/message |
NzMessageData#state |
ng-zorro-antd/modal |
nzOnOk / nzOnCancel input usage |
ng-zorro-antd/tooltip |
cdkConnectedOverlayPush |
ng-zorro-antd/transfer |
NzTransferSearchComponent, [nz-transfer-search] |
ng-zorro-antd/upload |
nz-upload[nzTransformFile], NzUploadTransformFileType |
ng-zorro-antd/upload |
ZipButtonOptions#transformFile |
22.0.0-beta.0
2026-07-13
Features
Bug Fixes
⚠ BREAKING CHANGES
日期相关组件不再内置默认日期引擎适配器。使用日期相关组件的应用需要在应用配置中显式提供日期适配器；如需保持旧版本基于 date-fns 的行为，可在 app.config.ts 中配置 provideNzDateFnsAdapter()。
date-fns 已升级至 v4。直接使用 date-fns API 的应用需要更新 import 和相关用法，以兼容 v4 版本。(#9868) (a865a89)
移除以下在过去的版本中标记为废弃的 API:
| Module | API |
|---|---|
ng-zorro-antd/button |
NzButtonComponent#nzSearch |
ng-zorro-antd/cascader |
NzCascaderComponent#nzDisplayWith |
ng-zorro-antd/collapse |
nz-collapse-panel[nzDisabled] |
ng-zorro-antd/core/form |
NzFormNoStatusService |
ng-zorro-antd/core/services |
NzBreakpointKey |
ng-zorro-antd/dropdown |
NzDropDownModule |
ng-zorro-antd/grid |
EmbeddedProperty |
ng-zorro-antd/input |
textarea[nzAutosize], AutoSizeType, NzAutosizeDirective |
ng-zorro-antd/input |
nz-input-group, NzInputGroupComponent, NzInputGroupWhitSuffixOrPrefixDirective |
ng-zorro-antd/input |
[nz-input-group-slot], NzInputGroupSlotComponent |
ng-zorro-antd/input |
NzInputDirective#nzStepperless |
ng-zorro-antd/message |
NzMessageData#state |
ng-zorro-antd/modal |
nzOnOk / nzOnCancel input usage |
ng-zorro-antd/tooltip |
cdkConnectedOverlayPush |
ng-zorro-antd/transfer |
NzTransferSearchComponent, [nz-transfer-search] |
ng-zorro-antd/upload |
nz-upload[nzTransformFile], NzUploadTransformFileType |
ng-zorro-antd/upload |
ZipButtonOptions#transformFile |
21.3.2
21.3.1
21.3.1
2026-06-05
Bug Fixes
- *: apply outlined variant class (#9806) (e5f536b)
- cascader,select,tree-select: fix slide animations direction (#9814) (487a511)
- color-picker: fix slider styles (#9802) (af91cf5)
- date-picker: week highlight not work after step action (#9812) (1a6312a)
- pagination,table: avoid crash when page size is 0 (#9813) (ef6bc8a)
- tree-select: fix placement class (#9809) (3fcd43d)
21.3.1
2026-06-05
Bug Fixes
21.3.0
21.3.0
2026-05-22
Features
- cascader: support
nzPopupRender(#9751) (fcd9be8) - cascader: align
nzOpenbehavior with ant design (#9747) (91293df) - cron-expression: bump
cron-parserto v5 (#9757) (ff5c160) - form: support mix layout (#9755) (db46533)
- grid: add
nzWrapinput to row directive (#9789) (ece8bae) - grid: add
xxxl(1920px) breakpoint for FHD screen (#9792) (0e091b5) - grid: support responsive object type for
nzAlignandnzJustify(#9790) (1293d42) - grid: support string css unit for
nzGutter(#9786) (e330e21) - upload: support
nzId(#9783) (a27cd9a)
Bug Fixes
- cascader: apply
nzLabelRenderin multiple mode (#9775) (7f188f2) - color-picker: popover clipped when trigger is near viewport edge (#9784) (284e6d3)
- date-picker: initial value not set with signal form (#9778) (aff39fb)
- descriptions: fix
NG0956error (#9781) (7f1b3ec) - float-button: align
nzOpenbehavior with Ant Design (#9754) (f19811d) - input-number: prevent wheel event when input is read-only (#9785) (c857db8)
- input-number: text overlaps handler when input too long (#9768) (7c3272c)
21.3.0
2026-05-22
Features
- cascader: 支持
nzPopupRender属性 (#9751) (fcd9be8) - cascader: 对齐 Ant Design Cascader 的 Open 受控行为 (#9747) (91293df)
- cron-expression: 升级
cron-parser至 v5 (#9757) (ff5c160) - form: 支持混合布局 (#9755) (db46533)
- grid: 为 row 指令新增
nzWrap属性 (#9789) (ece8bae) - grid: 新增
xxxl(1920px) 断点，支持 FHD 屏幕 (#9792) (0e091b5) - grid:
nzAlign和nzJustify支持响应式对象类型 (#9790) (1293d42) - grid:
nzGutter支持 CSS 字符串单位 (#9786) (e330e21) - upload: 支持
nzId属性 (#9783) (a27cd9a)
Bug Fixes
- cascader: 在多选模式下应用
nzLabelRender(#9775) (7f188f2) - color-picker: 修复当触发元素靠近视口边缘时弹出框被裁剪的问题 (#9784) (284e6d3)
- date-picker: 修复使用 signal 表单时初始值未设置的问题 (#9778) (aff39fb)
- descriptions: 修复
NG0956错误 (#9781) (7f1b3ec) - float-button: 对齐 Ant Design FloatButton 的 Open 受控行为 (#9754) (f19811d)
- input-number: 当输入框为只读时阻止滚轮事件 (#9785) (c857db8)
- input-number: 修复输入过长时文字与操作按钮重叠的问题 (#9768) (7c3272c)
21.2.2
21.2.2
2026-04-13
Bug Fixes
- input: initialize value with control value (#9748) (c650b8a)
- input: fix incorrect control values when using ngModel (#9745) (69f4efd)
- select: fast scroll causes the
scrollToBottomoutput not to be emitted (#8771) (9c302a6) - select: fix transition lazy load (#9756) (49be18e)
21.2.2
2026-04-13
Bug Fixes
21.2.1
21.2.0
21.2.0
2026-03-20
Features
- alert: add loop text (#9697) (6b45037)
- form: support
nzVariant(#9694) (51d6eb6) - input-number: add
emitterinnzOnStepevent options (#9716) (f83af1e) - input: supports custom count logic for input-wrapper (#9645) (2450a60)
- tabs: support
nzIndicator(#9704) (02befe7)
Bug Fixes
- modal: prevent flicker on open (#9728) (56ad81d)
- select: fix dropdown position in Safari (#9724) (1081620)
21.2.0
2026-03-20
Features
- alert: 支持轮播的公告 (#9697) (6b45037)
- form: 新增
nzVariant属性，改变表单内所有组件的变体 (#9694) (51d6eb6) - input-number:
nzOnStep回调事件透出emitter(#9716) (f83af1e) - input: 支持自定义 input-wrapper 的计数逻辑 (#9645) (2450a60)
- tabs: 新增
nzIndicator属性，支持自定义 tab 的指示条 (#9704) (02befe7)