内容简介:版本介绍 欢迎来到 ng-zorro-antd 的 9.0.0 版本,升级到最新版本之后,开发者不仅可以享受到最新版本 Angular 的支持,还可以获得最新特性和更好的性能。 ng-zorro-antd 的部分 API 在 8.x 版本进入弃用状态,并...
版本介绍
欢迎来到 ng-zorro-antd
的 9.0.0
版本,升级到最新版本之后,开发者不仅可以享受到最新版本 Angular 的支持,还可以获得最新特性和更好的性能。
ng-zorro-antd 的部分 API 在 8.x 版本进入弃用状态,并且在开发环境中给出了警告提醒,所有之前弃用 API 在 9.0.0 不再支持,如果你之前已经根据告警信息修改了对应组件的使用方式,那么 9.0.0 版本升级不会有任何障碍,请按照以下步骤进行。
开始升级之前
- 首先确保你
Node.js
>=10.13
- 创建新的分支,或者使用其他方式备份当前项目
- 删除项目下 package-lock.json 文件
升级相关依赖
- 升级 Angular 主版本号至 9.0.0 版本,可以参考 https://update.angular.io/
- 如果你有单独使用
@angular/cdk
请执行ng update @angular/cdk
- 如果你有单独使用
date-fns
请先升级到2.x
,升级指南 - 如果你有使用
monaco-editor
请先升级到0.2.x
, 使用monaco-editor-webpack-plugin
时请将其升级到1.9.x
升级 NG-ZORRO
- 运行
ng update ng-zorro-antd
- 如果控制台出现警告消息请按提示修改对应代码
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 官方兼容工具 查看。
新版本特性
支持 Angular Ivy
我们已经将 @angular/*
和 @angular/cdk
版本升级到 v9
,现在你可以使用 Ivy 渲染引擎运行你的项目,并且开启 strictTemplates
选项使用更严格的的模版类型检查。
获取更多帮助请前往 Angular Ivy 和 Template type 查看。
Ant Design 4 设计规范
我们已经同步了 Ant Design 4 设计规范,并且添加了暗黑(Dark)和紧凑(Compact) 主题支持。
性能和易用性增强
- 在之前的版本中 Table 组件已经集成了虚拟滚动,现在 Select 和 Tree 也同样支持;
- Form 和 Table 简化了使用方式,现在可以编写更少的模版和配置;
- 允许在子模块中添加图标,以减少首屏加载时间;
- 现在当路由改变时弹出菜单将自动关闭,同时为 Modal 等组件添加了对应选项;
Features
- breadcrumb: 支持独立 separator (#4713) (1f490e9)
- collapse: 支持 nzExpandIconPosition (#4781) ([760512a](760* 512a))
- grid: 支持 nzFlex 与 nzGutter 数组输入 (c4d2694)*
- icon: 支持在 feature module 中导入 icons (#4711) (* 0bcd2a9)
- input: 支持 textarea 带 clear 图标的效果 (0af9242), closes [#4623](https://github.com/NG-ZORRO/ng-zorro-antd/issues/* 4623)
- page-header: 增加
nzGhost
选项 (#4306) (4c78cca), closes #43* 03 - select: select 支持 virutal scroll 模式 (40daee9), closes #4585 [#3497](https://github.com/NG-ZORRO/ng-zorro-antd/issues/* 3497)
- skeleton: 增加 nz-skeleton-element (#4859) (8dc2ff3)*
- space: 添加新组件 (#4928) (df01bd1), closes [#4913](h* ttps://github.com//issues/4913)
- table: 支持
nzQueryParams
(#4970) (79ea999)* - tabs: 增加了 nzCanDeactivate 钩子 (#4476) ([a533980](a533* 980)), closes #4432
- tag: 增加 status colors 选项 (#4628) (aa22c0f), closes #4622 #44* 13
- tree: 支持虚拟滚动 (#4979) (6803a92), closes #4426 #3808 [#3436](ht* tps://github.com//issues/3436) #2680 #1771
- tree-select: 支持
nzDropdownClassName
选项 (#4552) (df8c125), closes #4508* - typography: 支持
nzSuffix
选项 (#4629) (ca02a07), closes #4620* - form:
- code-editor:
- date-picker:
- i18n:
- input-number:
- menu:
- notification:
- pagination:
- progress:
- tooltip:
Bug Fixes
- mention: 修复移动端选择问题 (#4309) (1be6d51), closes #4281
- menu: 修复在屏幕越界时的显示问题 (4c8032b), closes #3412 #4227 #3687
- message: 修复 prod 下 message 与 notification 的问题 (#4884) (3e2f85d)*
- page-header: 修复
location
注入问题 (#5013) (9073fa5), closes #4945* - pagination: 修复半角字符问题 (#4371) (cc3868e)*
- transfer: 修复 nzTargetKeys 无效问题 (#4670) ([31089a1](3* 1089a1)), closes #4641 #4360 #4210
- empty: 修复 Empty 在 dark 模式下的显示问题 (#4924) (bae59d7), closes #4921*
- grid: 修复响应式的问题 (#4906) (d6828ed)*
- list: 修复头像部分的兼容 API (#4952) ([d8a2594](d8a* 2594)), closes #4912
- badge: 允许将
nzTitle
设置为null
(#4965) (a35fb5e), closes [#4776](https://github.com/NG-ZORRO/ng-zorro-antd/is* sues/4776) - breadcrumb: 修复面包屑显示问题 (#4880) (2553328)*
- button: 修复 transition 显示问题 (9e0df2a), closes [#2697](https://github.com/NG-ZORRO/ng-zorro-antd/iss* ues/2697)
- cascader: 修复无选项时的显示问题 (#4565) (9d8d7e6), closes* #4562
- slider: 修复垂直模式下拖拽句柄样式问题 (#4939) (6fba78d)*
- timeline: 修复 reverse 下的展示问题 (#4690) (09bf8f4),* closes #4509
- auto-complete:
- code-editor:
- date-picker:
- drawer:
- dropdown:
- layout:
- modal:
- select:
- table:
- time-picker:
- tooltip:
- tree:
- tree-select:
Performance Improvements
- checkbox: 使用 css empty selector 代替了 observeContent (#4761) (da8821a)
- input: 提升 input 性能 (7af643b), closes #3950*
- radio: 重构了数据流 (#4770) (423a382)*
BREAKING CHANGES
注意: 所有不兼容改动均在 8.x 最新版本中给出了 warning,如果你在 8.x 最新版本中修复了所有 warning,9.x 可以直接升级的。
- calendar:
<nz-calendar>
nzCard
被移除了, 请使用nzFullscreen
代替。
- carousel:
nzVertical
被移除,请使用 'nzDotPosition' 代替。
- empty:
NZ_DEFAULT_EMPTY_CONTENT
被移除,请使用NzConfigService
代替。
- form:
nz-form-extra
被移除,请使用nz-form-control
中的nzExtra
代替。nz-form-explain
被移除,请使用nz-form-control
中的nzSuccessTip | nzWarningTip | nzErrorTip | nzValidatingTip
代替。
- icon:
i[nz-icon]
:twoToneColor
theme
spin
iconfont
type
输入被移除, 请使用nzTwoToneColor
nzTheme
nzSpin
nzIconfont
nzType
代替。i.anticon
被移除, 请使用i[nz-icon]
代替。NZ_ICON_DEFAULT_TWOTONE_COLOR
被移除, 请使用NzConfigService
。
- input-number:
- ngModelChange 会在用户输入时立刻触发
- message,notification:
NZ_MESSAGE_CONFIG
被移除,请使用NzConfigService
代替。NZ_NOTIFICATION_CONFIG
被移除,请使用NzConfigService
代替。config
method ofNzMessageService
andNzNotificationService
被移除,请使用set
method ofNzConfigService
代替。- 用
NzMessageRef
替换NzMessageDataFilled
- 用
NzNotificationRef
替换NzNotificationDataFilled
- pagination:
- 当定制 nzItemRender 时,需要考虑 prev_5 and next_5
- 'pre' 被修改为 'prev'
- tree, tree-select:
- 移除了
[nzDefaultExpandAll]
请使用[nzExpandAll]
代替。 - 移除了
[nzDefaultExpandedKeys]
请使用[nzExpandedKeys]
代替。 - 移除了
[nzDefaultSelectedKeys]
请使用[nzSelectedKeys]
代替。 - 移除了
[nzDefaultCheckedKeys]
请使用[nzCheckedKeys]
代替。 - 移除了
(nzOnSearchNode)
请使用(nzSearchValueChange)
代替。
- 移除了
- tooltip,popover,popconfirm:
<nz-tooltip>
<nz-popover>
<nz-popconfirm>
组件被移除, 请使用对应的 directives 代替。
- 移除 API:
NgZorroAntdModule.forRoot()
以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网
猜你喜欢:- xmake v2.2.3 发布, 大量新特性支持
- Swift 4.1 正式发布,新增更多泛型特性支持
- Firefox 浏览器开始支持 Windows 10 原生通知特性
- Angular 7支持虚拟滚动、拖放、CLI Prompts等特性
- WildFly 18 的安全特性预览,将支持 TLS 1.3
- WildFly 18 的安全特性预览,将支持 TLS 1.3
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。