NG-ZORRO/ng-zorro-antd 20.0.0

on GitHub

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:

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:

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.

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 的禁用状态 (#9166) (134cd59)
• space: 紧凑模式下只有一个子元素时的 border-radius 不正确 (#9165) (d2f4541)
• tabs: 修复 tab focus 时不正确的滚动行为 (#9186) (4f658e0)
• schematics: 修复重复执行 ng add 时的问题 (#9171) (d0a9748)
• water-mark: 修复 ssr 模式的兼容问题 (#9250) (a70a682)
• icon: 在 animation frame 上增加渲染防抖 (#8579) (c0709d1)

Code Refactoring

• core: 移除对 animation frame 的 polyfill (#9243) (272237a)
• 从基于 constructor 的依赖注入模式迁移到 inject

⚠ BREAKING CHANGES

• core: 移除对 animation frame 的 polyfill
  • 重命名 cancelRequestAnimationFrame 为 cancelAnimationFrame
  • 重命名 reqAnimFrame 为 requestAnimationFrame
• tabs: 废弃 NzTabsetComponent 并重命名为 NzTabsComponent，废弃 nz-tabset 选择器并重命名为 nz-tabs
• table: 移除对 material 组件的兼容
• popconfirm: 废弃 nzOkDisabled 和 nzOkDanger，请使用 nzOkButtonProps 代替

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

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

Deprecations

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