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

• 所有组件均使用 OnPush (#9824) (b50ea34)
• *: 新增日期适配器支持 (#9858) (d578c8b)

Bug Fixes

• form: 修复 signal form 兼容性问题 (#9831) (f57fd67)
• i18n: 补充 ja_JP 缺失翻译 (#9857) (1ff499e)

⚠ 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.2

2026-06-27

Bug Fixes

• schematics: ensure schematics publish as commonjs (#9848) (1196369)
• select: prevent dropdown option overflow (#9849) (a2b5d1f)

---

21.3.2

2026-06-27

Bug Fixes

• schematics: 确保 schematics 以 commonjs 格式发布 (#9848) (1196369)
• select: 防止下拉选项溢出 (#9849) (a2b5d1f)

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

• *: 应用 outlined 变体样式类 (#9806) (e5f536b)
• cascader,select,tree-select: 修复滑动动画方向 (#9814) (487a511)
• color-picker: 修复滑块样式 (#9802) (af91cf5)
• date-picker: 修复切换年月后星期的高亮不显示问题 (#9812) (1a6312a)
• pagination,table: 修复 page size 为 0 时的崩溃问题 (#9813) (ef6bc8a)
• tree-select: 修复 placement 类名 (#9809) (3fcd43d)

21.3.0

21.3.0

2026-05-22

Features

• cascader: support nzPopupRender (#9751) (fcd9be8)
• cascader: align nzOpen behavior with ant design (#9747) (91293df)
• cron-expression: bump cron-parser to v5 (#9757) (ff5c160)
• form: support mix layout (#9755) (db46533)
• grid: add nzWrap input to row directive (#9789) (ece8bae)
• grid: add xxxl (1920px) breakpoint for FHD screen (#9792) (0e091b5)
• grid: support responsive object type for nzAlign and nzJustify (#9790) (1293d42)
• grid: support string css unit for nzGutter (#9786) (e330e21)
• upload: support nzId (#9783) (a27cd9a)

Bug Fixes

• cascader: apply nzLabelRender in 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 NG0956 error (#9781) (7f1b3ec)
• float-button: align nzOpen behavior 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 scrollToBottom output not to be emitted (#8771) (9c302a6)
• select: fix transition lazy load (#9756) (49be18e)

---

21.2.2

2026-04-13

Bug Fixes

• input: 使用 ng control 值初始化 value (#9748) (c650b8a)
• input: 修复使用 ngModel 时值不正确的问题 (#9745) (69f4efd)
• select: 快速滚动导致 scrollToBottom 输出未被触发 (#8771) (9c302a6)
• select: 修复懒加载路由下过渡动画异常的问题 (#9756) (49be18e)

21.2.1

21.2.1

2026-03-31

Bug Fixes

• mention: fix mention-trigger does not trigger form updates (#9734) (0ccef3a)
• select,tree-select,mention,cascader: fix wrong popup layer position (#9742) (2e25d3b)

---

21.2.1

2026-03-31

Bug Fixes

• mention: 修复表单更新触发异常问题 (#9734) (0ccef3a)
• select,tree-select,mention,cascader: 修复 Safari 浏览器下下拉框位置不正确的问题 (#9742) (2e25d3b)

21.2.0

21.2.0

2026-03-20

Features

• alert: add loop text (#9697) (6b45037)
• form: support nzVariant (#9694) (51d6eb6)
• input-number: add emitter in nzOnStep event 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)

Bug Fixes

• modal: 修复弹窗打开时动画闪烁的问题 (#9728) (56ad81d)
• select: 修复 Safari 浏览器下下拉框位置不正确的问题 (#9724) (1081620)

21.1.1

21.1.1

2026-03-06

Bug Fixes

• anchor: support number id in nzHref (#9683) (fc8a096)
• carousel: restore responsive height on window resize (#9612) (b5558ae)
• cascader: wrong padding size (#9699) (b16da90)

---

21.1.1

2026-03-06

Bug Fixes

• anchor: 修复 nzHref 无法处理数字类型的 id (#9683) (fc8a096)
• carousel: 修复窗口大小改变时高度无法响应式变化的问题 (#9612) (b5558ae)
• cascader: 优化弹出气泡内边距样式 (#9699) (b16da90)

21.1.0

21.1.0

2026-02-05

Features

• collapse: sync the latest antd styles (#9680) (4eec05f) (#9678) (2483498)
• form: support nzSize (#9606) (785ca6f)
• time-picker: support nzPrefix (#9647) (8d75887)
• time-picker: support nzNeedConfirm (#9638) (9f887af)
• time-picker: support nzPlacement (#9630) (931b3f4)

---

21.1.0

2026-02-05

Features

• collapse: 同步最新 antd 样式 (#9680) (4eec05f) (#9678) (2483498)
• form: 新增 nzSize 参数，支持设置表单组件尺寸 (#9606) (785ca6f)
• time-picker: 新增 nzPrefix 参数，支持自定义前缀 (#9647) (8d75887)
• time-picker: 新增 nzNeedConfirm 参数，配置为 true 时需点击确认按钮才能完成选择 (#9638) (9f887af)
• time-picker: 新增 nzPlacement 参数，支持设置选择框弹出的位置 (#9630) (931b3f4)

21.0.2

21.0.2

2026-01-23

Bug Fixes

• i18n: add missing translations to he_IL (#9658) (a3410a0)
• form: error message never disappear if animation is disabled (#9660) (798a556)
• menu: submenu should respect provideNzNoAnimation (#9661) (79ffce9)

---

21.0.2 (2026-01-23)

Bug Fixes

• i18n: 更新 he_IL 国际化文案 (#9658) (a3410a0)
• form: 修复禁用动画时校验信息无法消失的问题 (#9660) (798a556)
• menu: 修复禁用动画时子菜单无法消失的问题 (#9661) (79ffce9)