npm ng-zorro-antd 9.0.0-beta.1
on Node.js NPM

latest releases: 19.0.2, 19.0.1, 19.0.0...
4 years ago

9.0.0-beta.1

2020-03-15

Intro

Note: We are still in beta version now, this version is not recommend to use in prod environment, if you meet any problems, please submit an issue to us.

Welcome to the 9.0.0-beta.1 version of ng-zorro-antd,some APIs were deprecated in version 8.x, and warning message was given under dev mode. All deprecated APIs is removed in 9.0.0, if you have fixed all warnings in the 8.x version, you can follow these steps to upgrade your version.

  1. Upgrade to Angular 9.0, ref https://update.angular.io/
  2. Upgrade to ng-zorro-antd@next, we will provide official ng update in 9.0.0 version
  3. We use date-fns 2.x version now, and provide compatible tools for ng-zorro-antd components.

date-fns update

We have upgraded date-fns to v2. When you switch to date-fns, some date formats will have a breaking change. Such as: 

<!-- datefns v1 -->
<nz-date-picker nzFormat="YYYY-MM-DD"></nz-date-picker>

<!-- datefns v2 -->
<nz-date-picker nzFormat="yyyy-MM-dd"></nz-date-picker>

We recommend using date-fns v2 date format. If you don't want to use the new date format, you can use NZ_DATE_FNS_COMPATIBLE. When set to true, ng-zorro-antd will convert the format of v1 to v2. See the comparison of the old and new formats here. 

providers: [
  { provide: NZ_DATE_FNS_COMPATIBLE, useValue: true }
]

Note: NZ_DATE_FNS_COMPATIBLE won't be kept for too long, we will remove the support for date-fns v1 format until ng-zorro-antd v10, we hope you can update the date-fns date format in time. For date-fns upgrade guide, see here.

Bug Fixes

Features

Performance Improvements

  • checkbox: use css empty selector instead of observeContent (#4761) (da8821a)
  • input: improve input-group perf (7af643b), closes #3950
  • radio: refactor radio group data flow (#4770) (423a382)

BREAKING CHANGES

Note: All break changes are warned in the latest version of 8.x, if you have fixed all warnings in 8.x, there will no break changes for you. Official ng update tools will be provided in version 9.0.0.

  • form:
    • nz-form-extra is removed. Please use nzExtra is nz-form-control instead.
    • nz-form-explain is removed. Please use nzSuccessTip | nzWarningTip | nzErrorTip | nzValidatingTip is nz-form-control instead.
  • input-number:
    • ngModelChange trigger at once when user typing
  • pagination:
    • prev_5 and next_5 is needed when use nzItemRender
    • 'pre' typo was corrected to 'prev'
  • tree, tree-select: * tree
    • Removed [nzDefaultExpandAll] use [nzExpandAll] instead.
    • Removed [nzDefaultExpandedKeys] use [nzExpandedKeys] instead.
    • Removed [nzDefaultSelectedKeys] use [nzSelectedKeys] instead.
    • Removed [nzDefaultCheckedKeys] use [nzCheckedKeys] instead.
    • Removed (nzOnSearchNode) use (nzSearchValueChange) instead.
  • tree-select
    • Removed [nzDefaultExpandedKeys] use [nzExpandedKeys] instead.
  • message,notification:
    • NZ_MESSAGE_CONFIG is removed. Please use NzGlobalConfigService instead.
    • NZ_NOTIFICATION_CONFIG is removed. Please use NzGlobalConfigService instead.
    • config method of NzMessageService and NzNotificationService is removed. Please use set method of NzGlobalConfigService instead.
  • empty:
    • NZ_DEFAULT_EMPTY_CONTENT is removed. Please use NzConfigService instead.
  • carousel: Carousel
    • nzVertical is removed. Please use 'nzDotPosition' instead.
  • icon:
    • NZ_ICON_DEFAULT_TWOTONE_COLOR is removed. Use NzGlobalConfigService instead.
    • i[nz-icon]: twoToneColor theme spin iconfont type inputs has been removed, use nzTwoToneColor nzTheme nzSpin nzIconfont nzType instead.
    • i.anticon selector has been removed, use i[nz-icon] instead.
  • calendar:
    • <nz-calendar> nzCard input has been removed, use nzFullscreen instead.
  • tooltip,popover,popconfirm:
    • <nz-tooltip> <nz-popover> <nz-popconfirm> components has been removed, use its directives instead.
  • Removed deprecated API NgZorroAntdModule.forRoot()

9.0.0-beta.1

2020-03-15
请注意，目前版本仍然是 beta 版本，不建议在生产环境中使用，如果使用中碰到任何问题，欢迎给我们提 issue。

欢迎来到 ng-zorro-antd 的 9.0.0-beta.1 版本，升级到最新版本之后，开发者不仅可以享受到最新版本 Angular 的支持，还可以获得最新特性和更好的性能。

ng-zorro-antd 的部分 API 在 8.x 版本进入弃用状态，并且在开发环境中给出了警告提醒，所有之前弃用 API 在 9.0.0 不再支持，如果你之前已经根据告警信息修改了对应组件的使用方式，那么 9.0.0 版本升级不会有任何障碍，请按照以下步骤进行。

  1. 升级 Angular 主版本号至 9.0.0 版本，可以参考 https://update.angular.io/
  2. 手动升级 ng-zorro-antd 至 最新版本，我们将会在 9.0.0 正式版中提供官方自动 ng update 工具。
  3. 在 9.0.0 之后 ng-zorro-antd 使用了 date-fns 的 2.x 版本，我们提供了组件内部的输入格式兼容工具。

date-fns 升级

当你切换至 date-fns 时，一些日期格式会有 breaking change。比如： 

<!-- datefns v1 -->
<nz-date-picker nzFormat="YYYY-MM-DD"></nz-date-picker>

<!-- datefns v2 -->
<nz-date-picker nzFormat="yyyy-MM-dd"></nz-date-picker>

我们推荐使用 date-fns v2 的日期格式。如果你不想使用新日期格式，你可以用 NZ_DATE_FNS_COMPATIBLE ，当设置为 true 时，ng-zorro-antd 会把 v1 的格式转为 v2，新旧格式的对比看这里。 

providers: [
  { provide: NZ_DATE_FNS_COMPATIBLE, useValue: true }
]

但 NZ_DATE_FNS_COMPATIBLE 不会保留太久，到 ng-zorro-antd v10 将会移除对 date-fns v1 日期格式的支持，希望你能及时更新 date-fns 日期格式。关于 date-fns 升级指南看这里，如果业务中使用了 date-fns，可以参考 date-fns 官方兼容工具 查看。

Bug Fixes

Features

Performance Improvements

BREAKING CHANGES

注意： 所有不兼容改动均在 8.x 最新版本中给出了 warning，如果你在 8.x 最新版本中修复了所有 warning，9.x 可以直接升级的，ng update 工具在 9.0 正式版会提供。

  • form:
    • nz-form-extra 被移除，请使用 nzExtra 中的 nz-form-control 代替。
    • nz-form-explain 被移除，请使用 nzSuccessTip | nzWarningTip | nzErrorTip | nzValidatingTip 中的 nz-form-control 代替。
  • input-number:
    • ngModelChange 会在用户输入时立刻触发
  • pagination:
    • 当定制 nzItemRender 时，需要考虑 prev_5 and next_5
    • 'pre' 被修改为 'prev'
  • tree, tree-select: * tree
    • 移除了 [nzDefaultExpandAll] 请使用 [nzExpandAll] 代替。
    • 移除了 [nzDefaultExpandedKeys] 请使用 [nzExpandedKeys] 代替。
    • 移除了 [nzDefaultSelectedKeys] 请使用 [nzSelectedKeys] 代替。
    • 移除了 [nzDefaultCheckedKeys] 请使用 [nzCheckedKeys] 代替。
    • 移除了 (nzOnSearchNode) 请使用 (nzSearchValueChange) 代替。
  • tree-select
    • 移除了 [nzDefaultExpandedKeys] 请使用 [nzExpandedKeys] 代替。
  • message,notification:
    • NZ_MESSAGE_CONFIG 被移除，请使用 NzGlobalConfigService 代替。
    • NZ_NOTIFICATION_CONFIG 被移除，请使用 NzGlobalConfigService 代替。
    • config method of NzMessageService and NzNotificationService 被移除，请使用 set method of NzGlobalConfigService 代替。
  • empty:
    • NZ_DEFAULT_EMPTY_CONTENT 被移除，请使用 NzConfigService 代替。
  • carousel: Carousel
    • nzVertical 被移除，请使用 'nzDotPosition' 代替。
  • icon:
    • i[nz-icon]: twoToneColor theme spin iconfont type 输入被移除, 请使用 nzTwoToneColor nzTheme nzSpin nzIconfont nzType 代替。
    • i.anticon 被移除, 请使用 i[nz-icon] 代替。
    • NZ_ICON_DEFAULT_TWOTONE_COLOR 被移除， 请使用 NzGlobalConfigService。
  • calendar:
    • <nz-calendar> nzCard 被移除了, 请使用 nzFullscreen 代替。
  • tooltip,popover,popconfirm:
    -<nz-tooltip> <nz-popover> <nz-popconfirm> 组件被移除, 请使用对应的 directives 代替。
  • 移除了无用的 API NgZorroAntdModule.forRoot()
Check out latest releases or
releases around ng-zorro-antd 9.0.0-beta.1

Don't miss a new ng-zorro-antd release

NewReleases is sending notifications on new releases.

Get notifications