更新日志

发布周期

  • 修订版本号：每周末会进行日常 bugfix 更新。（如果有紧急的 bugfix，则任何时候都可发布）
  • 次版本号：每月发布一个带有新特性的向下兼容的版本。
  • 主版本号：含有破坏性更新和新特性，不在发布周期内。

2020-07-09

  • date-picker: 修复 nzDateRender 渲染错误 () (fa7c7b4)
  • i18n: 修复部分语言包未导出的问题 () (57b1180), closes
  • list: 修复 nz-list-item-actions 渲染问题 (#5465) (), closes #5393
  • select: 修复渲染缓冲区导致的显示问题 () (089421c), closes
  • table: 修复 filter 值为 false 或 0 的问题 (#5535) (), closes #5505
  • table: 修复 table 在无数据时 colSpan 的问题 () (7f133af), closes #5481
  • tooltip: 修复部分 API 定义 () (a165eda), closes
  • upload: 修复 uploadError 错误的情况 (#5476) (), closes #5472

Features

  • datapicker: 新增 [nzInputReadOnly] 支持 () (#5488) ()
  • drawer: 支持获取 component 实例的方法 (#5498) (), closes #5489
  • popconfirm: 支持 nzPopconfirmShowArrow 属性 (#5361) () (516e02d)
  • resizable: 支持 nzDisabled 属性 () (4d44d2e)
  • timeline: 支持自定义位置 () (12e6b6f), closes
  • upload: 增加 nzPreviewIsImage 属性 (#5525) (), closes #5520

9.2.2

2020-06-23

Bug Fixes

  • datepicker: 修复修改输入框内容面板没有打开的问题 (#5466) (), closes #5284
  • modal: 修复 confirm 模式下自动聚焦抛错的问题 (#5462) (), closes #5454

9.2.1

2020-06-17

Bug Fixes

  • i18n: 修复 interface 不匹配的问题 () (e9ef9f3)

2020-06-16

Bug Fixes

  • affix,anchor: 修复当初始值非 number 导致错误值的问题 () (1c72939)
  • tree: 修复 nzCheckStrictly 和 nzSelectedKeys 的问题 () (67d9dd0), closes #5195
  • badge: 修复父组件非 onPush 时 nzCount 不显示的问题 (#5275) ()
  • button: 修复初始 loading 状态的问题 (#5404) (), closes #5392
  • date-picker: 修复在 modal 中箭头样式的问题 () (39a6c28)
  • drawer: 修复 nzMask 为 false 时阻止事件的问题 () (abe9e53), closes
  • dropdown: 修复按钮 disabled 的问题 (#5429) (), closes #5258
  • grid: 修复 gutter 为0时的问题 () (80a4709), closes
  • input: 修复 disabled 属性丢失的问题 (#5315) ()
  • input: 修复响应式表单 input-group 样式问题 (#5428) (), closes #5137
  • input: 修复响应式表单 disabled 的问题 () (8270009)
  • menu: 修复 ng-template 报错的问题 () (d0c36d6), closes
  • message: 修复样式没有随属性改变的问题 (#5323) (), closes #5301
  • modal: 修复点击滑动条模态框关闭的问题 () (e95d404), closes
  • modal: 修复 nzAutofocus 的问题 (#5313) ()
  • modal: 修复部分情况下没有检测到变化的问题 (#5332) (), closes #5328#5259
  • notification: 修复通知模板没有更新的问题 (#5382) (), closes #4787
  • page-header: 修复 compact 样式问题 () (74fa3d6)
  • radio: 修复 focus 的问题 () (6e0f47b), closes
  • select: 修复 group 标签搜索的问题 (#5407) (), closes #5276
  • select: 修复自动聚焦的行为 () (8617e58), closes
  • select: 修复 nzCustomContent 渲染的问题 (#5425) (), closes #5178
  • select: 修复标签模式值错误的问题 () (fe5419b), closes
  • table: 修复 nzRight``nzLeft 报 ExpressionChangedAfterError 错误的问题 (#5240) (), closes #5238
  • table: 修复 colspan 以及空值的样式问题 () (2eda6d3), closes
  • table: 修复表格滚动时 nzWidth 不生效的问题 (#5437) (), closes #5370#5318#5167
  • table: 修复排序的问题 (#5433) (), closes #5262
  • table: 修复 nzChecked``nzShowCheckbox 冲突的问题 () (6f5b935), closes
  • calendar: 支持 nzDisabledDate (#5295) ()
  • input-number: support inputmode (#5423) (), closes #5341
  • select: 支持 nzBorderless 全局配置 () (459bdb0), closes
  • slider: 支持 nzReverse (#5268) (), closes #4937
  • table: 支持数据泛型 () (182e790)
  • typography: 支持 nzOnEllipsis () (2200063)
  • upload: 支持 nzFileListRender () (ce5574a), closes

9.1.2

2020-05-13

Bug Fixes

  • all: 修复 strictTemplates 模式下类型错误的问题 (#5265) (), closes #5171
  • list: 修复空内容渲染的问题 () (ca7314c), closes
  • select: 修复 tags 模式下选中 0 值的样式问题 (#5264) ()

9.1.1

Bug Fixes

  • auto-complete,drawer: 修复在复用快照路由策略下无法重新打开的问题 (#5165) (), closes #5142
  • alert: 修复 nzNoAnimation 无效的问题 () (de9ef6b)
  • breadcrumb: 修复路由 path='' 情况下的问题 () (5ffa45c)
  • button: 修复锚点标签 disabled 的问题 () (36ab993), closes
  • dropdown: 修复无法服务器渲染的问题 (#5244) (), closes #5186
  • modal: 修复服务模式下全剧配置不生效的问题 () (95aab9a), closes
  • modal: 修复 confirm 模式下无法使用组件作为 content 的问题 (#5177) (), closes #5172
  • schematics: 修复当包存在时 ng add 会添加无效的版本号的问题 () (f406803), closes
  • table: 修复多表头下展开的问题 (#5246) (), closes #5207
  • timeline: 修复脏值检查的问题 () (ee2859f), closes
  • typography: 修复省略行计算错误的问题 (#5175) ()
  • upload: 修复无法正确显示预览图的问题 (#5205) (), closes #5201

2020-04-26

Features

  • 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

9.0.2

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

9.0.0

2020-04-15

版本介绍

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

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

开始升级之前

  1. 首先确保你 Node.js >= 10.13
  2. 创建新的分支，或者使用其他方式备份当前项目
  3. 删除项目下 package-lock.json 文件

升级相关依赖

  • 升级 Angular 主版本号至 9.0.0 版本，可以参考 https://update.angular.io/
  • 如果你有单独使用 @angular/cdk 请执行 ng update @angular/cdk
  • 如果你有单独使用 请先升级到 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 v2 的日期格式。如果你不想使用新日期格式，你可以用 NZ_DATE_FNS_COMPATIBLE ，当设置为 true 时，ng-zorro-antd 会把 v1 的格式转为 v2，新旧格式的对比看这里。

  1. providers: [
  2.   { provide: NZ_DATE_FNS_COMPATIBLE, useValue: true }
  3. ]

但 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 选项使用更严格的的模版类型检查。

获取更多帮助请前往 和 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:
    • 支持自动错误提示 () (0b85483), closes
    • 当 FormControl.status 为 INVALID 并且错误包含 {warning：true} 时，nz-form-control 显示警告状态。(#4891)() , close #4525
  • code-editor:
    • 支持静态导入 () (29f732b)
    • 更新到 monaco@0.20.0 的类型 () (3963ad1)
  • date-picker:
  • i18n:
    • 支持 Armenian 语言 () (038691f)
    • 支持 Georgian 语言 () (d96ebe0)
  • input-number:
    • 支持 nzPrecisionMode 模式 () (bfe089f), closes
    • 支持 ngModelChange 在输入时立即触发 (#4769) (), closes #3039
  • menu:
    • 当 sider 收起时，自动触发 nzInlineCollapsed模式 (51fbf5e), closes
    • 支持 nzMatchRouter 与 CanDeactivate 配合工作 (7560563), closes
  • notification:
    • 添加 onClick 可观察对象 (#4989) (), closes #4986
    • 支持 close icon 选项 () (80a0b26), closes
  • pagination:
    • nzItemRender 支持 prev_5 与 next_5 图标定制 (#4754) ()
    • 支持响应式 size (#4863) ()
  • progress:
    • 支持 steps 模式 (#4637) (), closes #4635
    • 支持 nzFormat 传入 TemplateRef () (edf0e9c), closes
  • tooltip:
    • 支持改变 trigger 位置 (#4397) (), closes #4365

Bug Fixes

  • 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:
    • 修复滚动条拖拽时自动关闭问题 () (387ebc1), closes
    • 修复默认值显示问题 (#4366) (), closes #4362
  • code-editor:
    • 修复配置选项 () (5283a32)
    • 修复 diff 模式下的问题 () (#4532) ()
  • date-picker:
    • 修复 nzDefaultOpenValue 无效问题 (#4357) (), closes #4331
    • 修复点击日期切换面板时 年/月 选择器不同步切换的问题 () (3aebe7c), closes
    • 修复展开动画效果 (#4315) ()
  • drawer:
    • 修复 overflow 样式问题 (#4423) (), closes #4354
    • 修复位置变化时的动画问题 () (e539096), closes
    • 修复 header 结构样式问题 (#4311) (), closes #4304
  • dropdown:
    • 修复 contextmenu 多重打开问题 (), closes #3971
    • 修复 menu group 在 dropdown 样式问题你 (d928a8c), closes
  • layout:
    • 修复 layout 高度问题 (bed60ff), closes
    • 修复 responsive 无效问题 (9f951f8)
  • modal:
    • 修复在初始化为打开状态时 nzModalFooter 指令不生效的问题 () (2f400e8), closes
    • 修复关闭按钮样式 (#5014) ()
    • 修复 nzMaskClosable 在 confirm 模式下不工作的问题 (#4347) (), closes #4344
  • select:
    • 修复 hidden 的选项可以被选中的问题 () (cf22133), closes #4377
    • 修复空状态的问题 () (f295c10)
  • table:
    • 修复 nzFilters 为 null 时的报错 () (2c26e9f)
    • 修复 Table 导出的 data 数据类型问题 () (70b1440), closes
    • 修复 Table nzWidth 的问题 (#4329) (), closes #4312
    • 修复 antd@4.1.0 样式问题 () (44f606c)
    • 修复无数据时的问题 () (7f7989e)
    • 修复 nzTotal 在非前端分页时的问题 () (9ddc060), closes
  • time-picker:
    • 修复输入ISO字符串的问题 (#4949) (), closes #4775#4871
    • 修复 ngModelChange 失效的问题 (#4944) ()
    • 修复在 datepicker 滚动错误的问题 (#4961) ()
  • tooltip:
    • 修复 hover popover 时时隐藏的问题 (#4418) (), closes #4417
    • 修复 undefined 不生效的问题 () (2a71c43)
    • 修复 tooltip 销毁时报错的问题 () (8e9e6a9), closes #4317
  • tree:
    • 修复输入区分大小写的问题 (#4766) (), closes #1996
    • 修复动画 (#4973) ()
  • tree-select:
    • 修复点击 label 在 strict 模式下的问题 (#4424) (), closes #4422
    • 修复 tags 在 strict 模式下的问题 () (a6547a0), closes
  • checkbox: 使用 css empty selector 代替了 observeContent (#4761) ()
  • input: 提升 input 性能 (7af643b), closes *
  • radio: 重构了数据流 (#4770) ()*
  • calendar:
    • 被移除了, 请使用 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 of NzMessageService and NzNotificationService 被移除，请使用 set method of NzConfigService 代替。
    • 用 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:

9.0.0 之前版本

9.0.0 之前版本的更新记录可以在 Github 查看。