Skip to content

Commit

Permalink
docs(changelog): update changelog for v13
Browse files Browse the repository at this point in the history
  • Loading branch information
hsuanxyz committed Dec 29, 2021
1 parent 8739341 commit b429e06
Show file tree
Hide file tree
Showing 3 changed files with 23 additions and 70 deletions.
5 changes: 1 addition & 4 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,7 @@

### BREAKING CHANGES
**dropdown**
- `[nz-dropdown][nzHasBackdrop="true""]` input value are no longer supported, please use `[nz-dropdown][nzBackdrop]` instead.

**table**
- `[nz-filter-trigger][nzHasBackdrop="true""]` input value are no longer supported, please use `[nz-filter-trigger][nzBackdrop]` instead.
- `[nzHasBackdrop]` input value are no longer supported, please use `[nzBackdrop]` instead.


## [12.1.1](https://github.com/NG-ZORRO/ng-zorro-antd/compare/12.1.0...12.1.1) (2021-12-18)
Expand Down
42 changes: 11 additions & 31 deletions docs/changelog.en-US.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,48 +15,28 @@ timeline: true
---
## 13.0.0

`2021-12-28`
`2021-12-29`

### Intro
Welcome to the `13.0.0` version of `ng-zorro-antd`,some APIs were deprecated in version 12.x, and warning message was given under dev mode. All deprecated APIs is removed in 13.0.0, if you have fixed all warnings in the 12.x version, you can follow these steps to upgrade your version.
#### Removal of View Engine Support

## Before upgrade
`ng-zorro-antd@13` remove support for View Engine and use Ivy library for distribution, you will get faster building and smaller bundle size.

1. Make sure `Node.js` >= `12.20`.
2. Create a new branch, or use other methods to back up the current project.
3. Delete the package-lock.json file.
See [Angular Ivy](https://angular.io/guide/ivy).

### 1.Upgrade dependencies

- Upgrade Angular to 13.x version, ref [https://update.angular.io/](https://update.angular.io/).
- Run `ng update @angular/cdk`, if you have used `@angular/cdk`.

### 2.Upgrade NG-ZORRO

- Run `ng update ng-zorro-antd`.
- If any warning messages appear in the console, follow the prompts to modify the corresponding code.
#### Removal of IE11 Support
- Removing IE11 support allows Angular to leverage modern browser features such as CSS variables and web animations via native web APIs
- What’s more is that apps will be smaller and load faster because we can remove IE specific polyfills and code paths

### Changes in V13
#### Angular Ivy Supported
View Engine is no longer available in Angular as of v13. This is great news because Angular can continue to create Ivy-based features that bolster your productivity with the platform.
See [Issue #41840](https://github.com/angular/angular/issues/41840).

More help go to [Angular Ivy](https://angular.io/guide/ivy) and [Template type](https://angular.io/guide/template-typecheck) checking.

#### End of IE11 support
- Removing IE11 support allows Angular to leverage modern browser features such as CSS variables and web animations via native web APIs
- What’s more is that apps will be smaller and load faster because we can remove IE specific polyfills and code paths
- It also removes the need for differential loading
- Running ng update will automatically drop these IE-specific polyfills and reduce bundle size during project migration
#### Enhanced Performance

#### Enhanced Performance and Usability
- Optimization for multiple components to eliminate possible memory leaks
Fix the problems that may cause memory leak.

### BREAKING CHANGES
**dropdown**
- `[nz-dropdown][nzHasBackdrop="true""]` input value are no longer supported, please use `[nz-dropdown][nzBackdrop]` instead.

**table**
- `[nz-filter-trigger][nzHasBackdrop="true""]` input value are no longer supported, please use `[nz-filter-trigger][nzBackdrop]` instead.
- `[nzHasBackdrop]` input value are no longer supported, please use `[nzBackdrop]` instead.


## Old Versions
Expand Down
46 changes: 11 additions & 35 deletions docs/changelog.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,52 +15,28 @@ timeline: true
---
## 13.0.0

`2021-12-28`
`2021-12-29`

### 版本介绍
欢迎来到 ng-zorro-antd 的 13.0.0 版本,升级到最新版本之后,开发者不仅可以享受到最新版本 Angular 的支持,还可以获得最新特性和更好的性能。
#### 停止对 View Engine 的支持

ng-zorro-antd 的部分 API 在 13.x 版本进入弃用状态,并且在开发环境中给出了警告提醒,所有之前弃用 API 在 13.0.0 不再支持,如果你之前已经根据告警信息修改了对应组件的使用方式,那么 13.0.0 版本升级不会有任何障碍,请按照以下步骤进行
`ng-zorro-antd@13` 不再支持 View Engine 并使用 Ivy 包进行分发,你将获得更快的打包速度和更小的包体积

## 开始之前
获取更多帮助请前往 [Angular Ivy](https://angular.io/guide/ivy) 查看。

1. 首先确保你 `Node.js` >= `12.20`
2. 创建新的分支,或者使用其他方式备份当前项目
3. 删除项目下 package-lock.json 文件
#### 停止对 IE11 的支持

## 升级步骤

### 1. 升级相关依赖

- 前往 [https://update.angular.io/](https://update.angular.io/) 将项目升级到 Angular 13
- 如果你有单独使用 `@angular/cdk` 请执行 `ng update @angular/cdk`

### 升级 NG-ZORRO

- 运行 `ng update ng-zorro-antd`
- 如果控制台出现警告消息请按提示修改对应代码

### 新版本特性
#### 支持 Angular Ivy
Angular 13 宣布不再支持 View Engine,同时全面启用 Ivy,ng-zorro-antd v13 版本开始完全基于 Ivy 构建,实现更快的编译速度。

获取更多帮助请前往 [Angular Ivy](https://angular.io/guide/ivy)[Template type](https://angular.io/guide/template-typecheck) 查看。

#### 结束对 IE11 的支持
- Angular 可以通过原生的 Web API 使用现代浏览器功能,如 CSS 变量 和 Web 动画等特性
- 移除 IE 相关的 polyfills 和代码使得应用程序更小、加载速度更快
- 消除了对差异加载的需要,开发人员将与应用程序用户将获得更好的体验
- 运行 ng update 将自动删除这些特定于 IE 的 polyfills,并在项目迁移期间减少包大小

#### 性能和易用性增强
- 针对多个组件的优化,消除可能的内存泄漏问题
获取更多帮助请前往 [Issue #41840](https://github.com/angular/angular/issues/41840) 查看。

#### 性能增强

修复了多处可能造成内存泄漏的问题。

### BREAKING CHANGES
**dropdown**
- `[nz-dropdown][nzHasBackdrop="true""]` 已经不再支持,请使用 `[nz-dropdown][nzBackdrop]` 代替。

**table**
- `[nz-filter-trigger][nzHasBackdrop="true""]` 已经不再支持,请使用 `[nz-filter-trigger][nzBackdrop]` 代替。
- `[nzHasBackdrop]` 已被移除,请使用 `[nzBackdrop]` 代替。


## 历史版本
Expand Down

0 comments on commit b429e06

Please sign in to comment.