更新日志
发布周期
- 修订版本号:每周末会进行日常 bugfix 更新。(如果有紧急的 bugfix,则任何时候都可发布)
- 次版本号:每月发布一个带有新特性的向下兼容的版本。
- 主版本号:含有破坏性更新和新特性,不在发布周期内。
2020-04-26
- date-picker, time-picker: 支持自定义后缀图标 () (8b660bd)
- autocomplete: 支持对象类型数据 () (4bfbbf7), closes
- select: 支持全局配置 nzSuffixIcon (#5092) ()
- select: 支持将 nzOptions 作为输入项传入 (#5109) (), closes #5106
- select: 支持 option 高度及滚动设置 () (7b3937e), closes
Bug Fixes
- auto-complete: 修复 input-group 中的位置 (#5157) ()
- cascader: 修复下拉位置边界检测问题 (#5148) (), closes #5102
- date-picker: 修复 form disabled 不生效问题 () (b83e7b5), closes
- date-picker,time-picker: 修复点击展开下拉问题 (#5105) (), closes #5073
- description: 修复 nzTitle 不接收 TemplateRef () (90d2ec5), closes
- form: 修复 tips 改变时数据未更新问题 (#5144) (), closes #5129
- menu: 修复 nzMatchRouter 不生效问题 () (2724b9b)
- menu: 修复 submenu 滚动问题 () (fb52f21), closes
- message: 修复 remove 调用边界情况 (#5123) (), closes #5121
- modal: 修复
NoopAnimations
在 modal 中的延时问题 () (d7625db), closes - notification: 修复全局 nzPlacement 不生效 (#5140) (), closes #5135
- progress: 修复 nzFormat 在 exception 不生效问题 () (654411e), closes
- select: 修复 ie11 下输入无效问题 (#5117) (), closes #5110
- select: 修复悬浮在 option 时自动滚动问题 () (d69415a), closes #5116
- space: 修复配置名称 () (64f772d)
- table: 移除 nzQueryParams debounceTime 时间 () (07a9d34), closes
- time-picker: 允许输入值为 undefined 或 null (#5104) (), closes #5100
- tooltip: 修复 nzTitle 在 null 之间切换未生效问题 () (1123281), closes
- 修复 ivy 关闭时的渲染问题 (#5090) (), closes #5088
2020-04-20
- all: 修复 enableIvy:false 时的问题 () (83b554e), closes
- button: 修复 button 类型定义问题 (#5085) (), closes #5026
- form: 修复 form 在特定情况下的数据流报错 () (565b530), closes
- input: 修复 input group 在 focus disabled 时的样式 (#5082) (), closes #5064
- popover: 修复 popover 不能关闭的问题 () (dbc2cd3)
- select: 修复 nzDropdownMatchSelectWidth 不生效的问题 () (d210f4d), closes
- select: 修复 option 内容超长时的样式问题 (#5057) (), closes #5047
- select: 修复 group option 顺序不对问题 () (af39d5f)
- build: 修复 ngcc 时报错问题 () (7bc8279), closes
2020-04-15
版本介绍
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。比如:
我们推荐使用 date-fns
v2 的日期格式。如果你不想使用新日期格式,你可以用 NZ_DATE_FNS_COMPATIBLE
,当设置为 true
时,ng-zorro-antd
会把 v1 的格式转为 v2,新旧格式的对比看这里。
providers: [
{ provide: NZ_DATE_FNS_COMPATIBLE, useValue: true }
]
支持 Angular Ivy
我们已经将 @angular/*
和 版本升级到 v9
,现在你可以使用 Ivy 渲染引擎运行你的项目,并且开启 strictTemplates
选项使用更严格的的模版类型检查。
获取更多帮助请前往 和 Template type 查看。
Ant Design 4 设计规范
我们已经同步了 Ant Design 4 设计规范,并且添加了暗黑(Dark)和紧凑(Compact) 主题支持。
性能和易用性增强
- 在之前的版本中 Table 组件已经集成了虚拟滚动,现在 Select 和 Tree 也同样支持;
- Form 和 Table 简化了使用方式,现在可以编写更少的模版和配置;
- 现在当路由改变时弹出菜单将自动关闭,同时为 Modal 等组件添加了对应选项;
Features
- breadcrumb: 支持独立 separator () (1f490e9)
- collapse: 支持 nzExpandIconPosition () ([760512a](https://github.com/NG-ZORRO/ng-zorro-antd/commit/760* 512a))
- grid: 支持 nzFlex 与 nzGutter 数组输入 ()*
- icon: 支持在 feature module 中导入 icons (#4711) ()
- input: 支持 textarea 带 clear 图标的效果 (0af9242), closes [#4623](* 4623)
- page-header: 增加
nzGhost
选项 (#4306) (), closes #43* 03 - select: select 支持 virutal scroll 模式 (), closes #4585 [#3497](* 3497)
- skeleton: 增加 nz-skeleton-element (#4859) ()*
- space: 添加新组件 (#4928) (), closes [#4913](h* ttps://github.com/NG-ZORRO/ng-zorro-antd/issues/4913)
- table: 支持
nzQueryParams
(#4970) ()* - tabs: 增加了 nzCanDeactivate 钩子 (#4476) ([a533980](* 980)), closes #4432
- tag: 增加 status colors 选项 () (aa22c0f), closes #44* 13
- tree: 支持虚拟滚动 () (6803a92), closes #3808 [#3436](ht* tps://github.com/NG-ZORRO/ng-zorro-antd/issues/3436) #1771
- tree-select: 支持
nzDropdownClassName
选项 () (df8c125), closes * - typography: 支持
nzSuffix
选项 (#4629) (), closes #4620* - form:
- code-editor:
- date-picker:
- i18n:
- input-number:
- menu:
- notification:
- pagination:
- progress:
- tooltip:
- mention: 修复移动端选择问题 () (1be6d51), closes
- menu: 修复在屏幕越界时的显示问题 (4c8032b), closes #4227
- message: 修复 prod 下 message 与 notification 的问题 (#4884) ()*
- page-header: 修复
location
注入问题 (#5013) (), closes #4945* - pagination: 修复半角字符问题 () (cc3868e)*
- transfer: 修复 nzTargetKeys 无效问题 () ([31089a1](https://github.com/NG-ZORRO/ng-zorro-antd/commit/3* 1089a1)), closes #4360
- empty: 修复 Empty 在 dark 模式下的显示问题 (#4924) (), closes #4921*
- grid: 修复响应式的问题 () (d6828ed)*
- list: 修复头像部分的兼容 API () ([d8a2594](https://github.com/NG-ZORRO/ng-zorro-antd/commit/d8a* 2594)), closes
- badge: 允许将
nzTitle
设置为null
(#4965) (), closes [#4776](https://github.com/NG-ZORRO/ng-zorro-antd/is* sues/4776) - breadcrumb: 修复面包屑显示问题 () (2553328)*
- button: 修复 transition 显示问题 (), closes [#2697](https://github.com/NG-ZORRO/ng-zorro-antd/iss* ues/2697)
- cascader: 修复无选项时的显示问题 () (9d8d7e6), closes*
- slider: 修复垂直模式下拖拽句柄样式问题 (#4939) ()*
- timeline: 修复 reverse 下的展示问题 (#4690) (),* closes #4509
- auto-complete:
- code-editor:
- date-picker:
- dropdown:
- layout:
- 修复 layout 高度问题 (), closes #4676
- 修复 responsive 无效问题 ()
- modal:
- select:
- table:
- time-picker:
- tooltip:
- tree:
- tree-select:
Performance Improvements
- checkbox: 使用 css empty selector 代替了 observeContent () (da8821a)
- input: 提升 input 性能 (), closes #3950*
- radio: 重构了数据流 () (423a382)*
- 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:
- :
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:
- 移除 API:
NgZorroAntdModule.forRoot()
9.0.0 之前版本的更新记录可以在 查看。