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)

21.0.1

21.0.1

2026-01-16

Bug Fixes

• bundle keyframes of animation into base style files (#9653) (49ec060)
• collapse: no ghost zone if collapsed (#9649) (5378f8b)

---

21.0.1

2026-01-16

Bug Fixes

• 修复样式文件中 keyframes 样式缺失的问题 (#9653) (49ec060)
• collapse: 修复折叠状态下出现幽灵滚动区域的问题 (#9649) (5378f8b)

21.0.0

21.0.0

2026-01-09

Code Refactoring

• migrate to native animation API, feel free to remove the @angular/animations dependency

Features

• color-picker: support nzPresets (#9341) (d59ec99)
• core: add provideNzNoAnimation (#9555) (c945e81)
• date-picker: output date range in correct order (#9518) (d0b3185)
• float-button: add pop animation to float button menu (#9413) (b40ad91)
• input-number: supports mouse wheel control (#9591) (6ce3545)
• input,input-number: add additional options for focus method (#9595) (c336711)
• qrcode: support nzType and nzBoostLevel, delete array usage of nzPadding (#9535) (5419b51)
• tree-view: upgrade tree view component (#9003) (ae9ad57)
• upload: add nzMaxCount feature (#9424) (0bf13c3)

Bug Fixes

• i18n: add missing translations to fa_IR (#9615) (1e8845d)
• popconfirm: allow null for nzIcon hide icon (#9569) (760b587)
• select: disable nzAutoClearSearchValue in single mode (#9605) (4720c21)
• tree: no preventDefault when right-clicking the node title (#9532) (900efad)

⚠ BREAKING CHANGES

• back-top: removed, please use float-button instead
• color-picker: change DOM structure to be simpler, and remove no unnecessary payload of nzClick output
• input-number-legacy: removed, please use input-number instead
• qrcode: change the type of nzPadding from number | number[] to number (#9535)
• statistic: rename NzStatisticNumberComponent to NzStatisticContentValueComponent
• tabs: remove deprecated nz-tabset selector (#9613)
• tree-view: nzTreeControl has been removed, please use nzLevelAccessor or nzChildrenAccessor instead
• watermark: change import path from ng-zorro-antd/water-mark to ng-zorro-antd/watermark

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

Module	API
ng-zorro-antd/back-top	*
ng-zorro-antd/dropdown	NzDropdownButtonDirective
ng-zorro-antd/input-number-legacy	*
ng-zorro-antd/core	NzHighlightModule
ng-zorro-antd/auto-complete	NZ_AUTOCOMPLETE_VALUE_ACCESSOR
ng-zorro-antd/checkbox	nz-checkbox-wrapper
ng-zorro-antd/date-picker	NzDatePickerComponent#nzBorderless
ng-zorro-antd/input	NzInputDirective#nzBorderless
ng-zorro-antd/input-number	NzInputNumberComponent#nzBordered
ng-zorro-antd/mention	NZ_MENTION_TRIGGER_ACCESSOR
ng-zorro-antd/select	NzSelectComponent#nzBorderless
ng-zorro-antd/time-picker	NzTimePickerComponent#nzBorderless
ng-zorro-antd/tooltip	NzToolTipModule NzToolTipComponent

Unify and standardize component naming, involving the following name changes:

Module	Original	Current
core	NzConfig#backTop	NzConfig#floatButton
core	NzConfig#dropDown	NzConfig#dropdown
dropdown	NzDropDownModule	NzDropdownModule
dropdown	NzDropDownADirective	NzDropdownADirective
menu	NzIsMenuInsideDropDownToken	NzIsMenuInsideDropdownToken
watermark	NzWaterMarkModule	NzWatermarkModule
watermark	NzWaterMarkComponent	NzWatermarkComponent

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/collapse	nz-collapse-panel[nzDisabled]
ng-zorro-antd/input	textarea[nzAutosize], nz-input-group, [nz-input-group-slot]
ng-zorro-antd/upload	nz-upload[nzTransformFile], NzUploadTransformFileType

---

21.0.0

2026-01-09

Code Refactoring

• 迁移至 native animation API，您可以按需移除依赖 @angular/animations

Features

• color-picker: 新增 nzPresets 参数支持预设颜色 (#9341) (d59ec99)
• core: 新增 provideNzNoAnimation provider 用于禁用动画效果 (#9555) (c945e81)
• date-picker: 日期范围选择顺序颠倒时确保能输出正确的范围 (#9518) (d0b3185)
• float-button: 悬浮按钮组合新增动画效果 (#9413) (b40ad91)
• input-number: 支持鼠标滚轮控制 (#9591) (6ce3545)
• input,input-number: focus 方法新增额外参数 (#9595) (c336711)
• qrcode: 新增 nzType 和 nzBoostLevel 参数，nzPadding 类型从 number | number[] 调整为 number (#9535) (5419b51)
• tree-view: 升级 tree-view 组件，支持 nzLevelAccessor 和 nzChildrenAccessor (#9003) (ae9ad57)
• upload: 新增 nzMaxCount 属性 (#9424) (0bf13c3)

Bug Fixes

• i18n: 更新 fa_IR 国际化文案 (#9615) (1e8845d)
• popconfirm: 允许设置 nzIcon 为 null 以隐藏图标 (#9569) (760b587)
• select: 单选模式下 nzAutoClearSearchValue 不应生效 (#9605) (4720c21)
• tree: 不再阻止右键点击树节点标题的默认行为 (#9532) (900efad)

⚠ BREAKING CHANGES

• back-top: 移除，请使用 float-button 替代
• color-picker: 简化 DOM 结构，移除 nzClick output 不必要的参数
• input-number-legacy: 移除，请使用 input-number 替代
• qrcode: nzPadding 类型从 number | number[] 调整为 number
• statistic: 重命名 NzStatisticNumberComponent 为 ...

21.0.0-beta.0

21.0.0-beta.0

2025-12-26

Code Refactoring

• migrate upload select dropdown cascader tabs segmented message notification to native animation

Bug Fixes

• i18n: add missing translations to fa_IR (#9615) (1e8845d)

---

21.0.0-beta.0

2025-12-26

Code Refactoring

• native animation 迁移：upload select dropdown cascader tabs segmented message notification

Bug Fixes

• i18n: 更新 fa_IR 国际化文案 (#9615) (1e8845d)

21.0.0-next.2

21.0.0-next.2

⚠ BREAKING CHANGES

• tabs: remove deprecated nz-tabset selector (#9613) (d5e5772)
• qrcode: change the type of nzPadding from number | number[] to number (#9535) (5419b51)

Features

• color-picker: support nzPresets (#9341) (d59ec99)
• date-picker: output date range in correct order (#9518) (d0b3185)
• input-number: supports mouse wheel control (#9591) (6ce3545)
• input,input-number: add additional options for focus method (#9595) (c336711)
• qrcode: support nzType and nzBoostLevel, delete array usage of nzPadding (#9535) (5419b51)

Bug Fixes

• icon: include nzSpin in change detection logic (#9598) (7d3c637)
• select: disable nzAutoClearSearchValue in single mode (#9605) (4720c21)

---

21.0.0-next.2

⚠ BREAKING CHANGES

• tabs: 移除已弃用的 nz-tabset selector (#9613) (d5e5772)
• qrcode: nzPadding 类型从 number | number[] 调整为 number (#9535) (5419b51)

Features

• color-picker: 新增 nzPresets 参数支持预设颜色 (#9341) (d59ec99)
• date-picker: 日期范围选择顺序颠倒时确保能输出正确的范围 (#9518) (d0b3185)
• input-number: 支持鼠标滚轮控制 (#9591) (6ce3545)
• input,input-number: focus 方法新增额外参数 (#9595) (c336711)
• qrcode: 新增 nzType 和 nzBoostLevel 参数 (#9535) (5419b51)

Bug Fixes

• icon: 将 nzSpin 纳入变更检测逻辑，修复图标旋转状态在某些情况下无法及时更新 (#9597) (46dc381)

• select: 单选模式下 nzAutoClearSearchValue 不应生效 (#9605) (4720c21)