更新日志

ng-zorro-antd 严格遵循 Semantic Versioning 2.0.0 语义化版本规范。

发布周期

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

7.3.3

2019-04-25

Bug Fixes

• auto-complete: 打开面板时应该阻止 Enter (#3342) (414b428), closes #3340
• radio, tab: 修复内存泄露的问题 (#3354) (7d18fef)
• table: 修复过滤器位置和虚拟滚动样式问题 (#3365) (6435ee5), closes #3357#3348#3359
• tree-select: 添加缺少的公有方法 (#3335) (ee6d18b)

7.3.2

2019-04-22

Bug Fixes

• build: 修复 components.less 的打包错误 (#3331) (fb19921)

7.3.1

2019-04-22

Bug Fixes

• tree: 修复数据渲染问题 (#3326) (6d759a8), closes #3320
• select: 修复 nzShowSearch 时搜索无效的问题 (#3324) (d91af03), closes #3322

7.3.0

2019-04-21

Features

• 支持服务端渲染 (#3295) (2088459), closes #3222#43#2025#2474
• 支持子模块单独使用 (#3234)
• modal: 支持 nzMask 与 nzMaskClosable 全局配置 (#3033) (12cac9e)
• tree: 支持 nzBlockNode 选项 (#3270) (5129f73)
• date-picker:nzRanges 支持回调函数 (#3304) (a231cb5), closes #1629
• date-picker: 支持 nzOnCalendarChange 功能 (#3169) (4446005)
• form: 支持隐藏 label 的冒号 (#3136) (663169f)
• table: 导出 CdkVirtualScrollViewport (#3297) (a942312), closes #3144#3073#2886
• table: 支持 nzLoadingIndicator 配置 (#3299) (1f339b3), closes #3008
• time-picker: 支持 12-hour 制 nzUse12Hours (#3127) (7c52774)
• tree, tree-select: 支持定制 icons (#2933) (a77f6c9)
• schematics: 增强 component 生成器 (#3265) (c22eae5)

Bug Fixes

• anchor: 修复 scrollbar 的问题 (#3242) (37ac541)
• drawer: 修复 nzVisible 默认值为 true 的问题 (#3203) (327ceca), closes #3200
• dropdown: 修复展开时超出边界的问题 (#3289) (47f0aef), closes #3288
• dropdown: 修复与 material design 的样式冲突 (#3290) (e30a9be), closes #3241
• dropdown: 修复 ul 的样式问题 (#3284) (2845b57), closes #3268
• form: 修复模板驱动时 form 表单自动校验的问题 (#3305) (032d193), closes #3211
• i18n: 修复 catalan 语言包 (#3080) (81f917a), closes #2569
• input-number: 修复 blur 事件不能正确获得校验数值的问题 (#3315) (ee3d94c), closes #3134
• modal: 修复 modal 收起时的闪烁问题 (#3245) (3da4b68), closes #3213
• select: 修复 disable 状态下的样式问题 (#3287) (f5528d9), closes #3246
• select: 修复当 option 值发生改变时 select 未响应的问题 (#3313) (74d996b), closes #3029
• select: 修复 scroll 事件多次触发的问题 (#3285) (1478e59), closes #3258
• steps: 修复 steps 动态更新问题 (#3194) (8198b23), closes #3193
• table: 修复 firefox 等浏览器下边框显示问题 (#3294) (82407e7), closes #3164
• tree: 修复重复导入问题 (#3286) (5c8b923)
• tree, tree-select: 修复 key 校验的问题 (#3247) (87f2386), closes #3163
• upload: 移除部分 icon 旧版本用法 (#3230) (bc4e7da), closes #3228
• rate 修复 click 事件问题 (#3262) (2b4bde4), closes #3252
• style 修复部分样式未导出问题 (#3317) (5b02e48)

7.2.0

2019-03-27

Bug Fixes

• affix: 触发元素大小调整后重新设置 Affix 大小 (#3089) (ff482e0), closes #3040
• 修复一些 TS 类型定义 (#3166) (c685836)
• breadcrumb: 修复模块懒加载情况下根据路由自动生成的问题 (#3174) (4260a40), closes #2538
• dropdown: 修复 CDK 样式冲突 (#3133) (a9cd84d), closes #3075
• progress: 修复 success 状态异常问题 (#3135) (f85c766)
• transfer: 修复空白区域无法触发选择框的问题 (#3161) (92097b2), closes #3160#3159
• upload: 修复移除拖拽事件的问题 (#3114) (2b1fdd9), closes #3034#3139#3171

Features

• collapse: 支持 nzExtra (#3177) (fbfb4da)
• menu: 子菜单支持 nzMenuClassName (#3176) (15b6724)
• page-header: 添加 page-header 组件 (#2732) (cf51c1f), closes #2710
• schematics: 如果对应文件已被修改则不再设置引导页 (#3178) (0a3f62c)

7.1.0

2019-03-21

Bug Fixes

• tree: 修复 nzMultiple 及 其他兼容性问题 (#3060) (c917938), closes #3076
• cascader: 修复 column 未收起问题 (#3037) (72a9e67), closes #3034
• date-picker: 导出 year-picker 组件 (#3125) (c5b0af9)
• modal: 修复 tabs 与 autosize 的集成问题 (#3065) (4cab26f), closes #2286#2713
• modal:confirm 类型不应该有取消按钮 (#3115) (f0a2b51), closes #3107
• tooltip: 修复 tooltip 动态更新未渲染问题 (#3091) (2841a2f)

Features

• message: 支持 nzTop 属性 (#3047) (351135b), closes #3041
• message: 支持 template 属性 (#3102) (d3f6655), closes #3081

7.0.3

2019-03-14

Bug Fixes

• select: 修复 disabled 状态时 touched 初始状态错误的问题 (#3084) (ba9d454), closes #3059

Build

• build: 增加 strictNullCheck 等更严格的 ts 校验措施 (#2126)
• build: icon 依赖包升级至 2.0.2 (#3085) (fc72d7d)

7.0.2

2019-03-11

Bug Fixes

• pagination: 修复 Pagination 不随 pageIndex 变化的问题 (#3067) (f4948d7), closes #3049
• steps: 修复 Steps 在外层组件 OnPush 下的问题 (#3061) (97adb2c)
• table: 修复 Virtual Scroll 模式下 nzSize 不生效的问题 (#3063) (4fa16de), closes #3050
• table: 修复 Table 下拉筛选特殊情况下不生效的问题 (#3064) (dbc33ae), closes #3028#3056#3058
• transfer: 修复 Transfer 特殊情况下点击不生效的问题 (#3030) (f077294), closes #3026

7.0.1

2019-03-04

Bug Fixes

• tree: 修复 setTimeOut 默认值的问题 (#3003) (050faa0), closes #3001
• tree: 修复 tree-select 收起动画的问题 (#2997) (623a9ff)
• checkbox: 修复 checkbox 无障碍的问题 (#3009) (42ed317), closes #3000
• fesm2015: 修复 fesm2015 打包的问题 (#3015) (e5b388a)
• icon: 移除 icon 的测试模块导出 (#3002) (28edb53)
• schematics: 修复 add-icon-assets schema 路径 (#3005) (5101928)
• select: 修复 select 在 form 中的重置问题 (#3017) (30b3d86), closes #3014
• table: 修复 table 双向绑定的问题 (#3007) (a2202b4), closes #3004

7.0.0

2019-02-28

距离上一个稳定版本的发布已经有 3 个月的时间，从 7.0 版本开始，ng-zorro-antd 将和其他 Angular 第三方库一样，保持与 Angular 的主版本号一致。按照路线图的规划，我们在 7.0 前三个 rc 版本的基础上增加了 105 个 commits，目前我们已经按计划完成了第一阶段的 Milestone，包含但不限于以下内容

• 全部组件默认工作在 OnPush 模式下，大幅度提升了组件性能
• 完成 web animation 与 antd 动画的对应，并支持对每个组件的动画进行全局和单独配置
• 增加了 Empty、Statistic、CountDown、Comment 等实用组件
• 支持了最新的 CDK 特性，Table 等组件支持虚拟滚动
• 增加了大量新的功能，并修复了大部分之前组件存在的问题
• 日期相关组件支持可选的 ISO 标准日期格式化（依赖Date-fns库），解决周数算法不一致等问题
• 更换了新的全局滚动策略，Modal Drawer 在特殊情况下弹出时页面不再抖动
• 更加严格的 TSLint 校验
• 全新的 LOGO 和 文档系统
  我们会在 7.0 正式版本发布后立刻进行第二阶段的 Milestone 工作，该部分规划包含完整的服务端渲染支持，a11y，独立的包引入机制，全局的组件配置方式，输入数据的动态校验等等，这些功能会在随后的版本中逐步发布。

升级指南

第一步：升级 Angular 及配套环境至最新版本

第二步：升级 ng-zorro-antd 至 7.0 正式版

注意：

7.0 正式版有三处更新可能需要修改少量业务代码后才能使用：

• 7.0 正式版绝大部分组件都默认工作在 OnPush 模式下，OnPush 模式下的组件不会对 Input() 的可变对象 (mutate) 情况进行响应，所有组件 @Input 内容应修改为不可变对象 (immutable)，具体情况见最后示例代码，正确使用不可变对象可以大幅度优化应用性能。
• 我们修正了 Select 组件中 [nzDropdownMatchSelectWidth] 的实际含义，与之前版本相反。
• Input Group Search 模式下 button 传入由 nzSuffix 换为 nzAddOnAfter。

更新日志

Bug Fixes

• affix: trigger 元素 resize 时应该重置 placeholder 大小 (#2835) (7068a5e), closes #2818
• anchor: 修复组件销毁后调用 detectChanges 的问题 (#2864) (0e5c937), closes #2860
• animation: 修复 路由变化时动画触发的问题 (#2895) (e39f6bf)
• build: 修复 build target 为 ES6 时的问题 (#2921) (ab62b40), closes #2893
• carousel: 修复在 modal 或 card 中不渲染的问题 (#2699) (e092bf0), closes #2387 ,#2226
• carousel: 修复轮播图不能点击的问题 (#2699) (e092bf0), closes #2631
• carousel: 修复轮播图在窗口 resize 时内容错位的问题 (#2699) (e092bf0), closes #2158
• cascader: 修复当 nzOptions 为空时搜索错误的问题 (#2846) (e33cc50), closes #2784
• cascader: 修复子节点 loading 状态未变化的问题 (#2986) (b87e8bb)
• core: 修复 CDK 样式冲突 (#2917) (37cf6f3), closes #2874
• date-picker & calendar & time-picker: 提供新的可选方式来解决不符合ISO标准算法的周数 (#2819) (e1bce41), closes #2819 ,#2406
• drawer: 修复 body overflow 的问题 (#2867) (1e081f0), closes #2227#2615
• grid: 修复 Grid 响应式问题 (#2915) (ab05619), closes #2908
• i18n: 修复法语文件中的字段丢失 (#2586) (#2737) (c821d56)
• i18n: 导出 da_DK 以及更新对于文档 (#2599) (6554cf5)
• icon: 修复错误重新的渲染 (#2912) (6dd3cbf), closes #2911
• input: 修复对新 icon API 兼容性的问题 (#2841) (3c954cb)
• menu & dropdown: 修复Firefox下定位问题 (#2816) (09f21d0), closes #2834
• modal, drawer: 修复 IE/Edge 下 SVG blur/focus 方法找不到的问题 (#2869) (7487a7e), closes #2388
• modal: 修复 body overflow 的问题 (#2869) (7487a7e), closes #2612
• modal: 修复 OnPush 容器下无法关闭蒙层 (#2869) (7487a7e), closes #2643
• radio: 在 label 中子元素无法聚焦 (#2850) (58743b8), closes #2774
• select: 修复 nzScrollToBottom 在浏览器缩放下的问题 (#2741)
• select: 修复 多选情况下 Input 框大小变化问题 (#2741)
• select: 修复 定位到多个 Option 的问题 (#2741)
• switch: 修复当 loading or disabled 时切换的问题 (#2896) (a67984c), closes #2787
• table: 修复 Firefox 浏览器下边框样式问题 (#2862) (074083e)
• table: 修复 ngIf 情况下 th 排序事件不触发的问题 (#2862) (074083e)
• table: 修复 靠右对齐的固定多列的问题 (#2862) (074083e)
• time-picker: 将清除按钮调整放置到外层输入框处 (#2948) (ffb6665)
• tooltip: 修复 nzTitle 没有更新的问题 (#2698) (f6dfbd9), closes #2695
• tree-select: 修复 overlay 层级覆盖问题 (#2764) (599ae1a), closes #2730
• tree: 修复 loading 图标位置偏移问题 (#1998) (36c91ac), closes #1998
• tree: 修复 nzCheckStrictly 状态下父子节点关联问题 (#2655#2370) (36c91ac), closes #2655 ,#2370
• tree: 修复 nzShowIcon 为 false icon 仍然有效问题 (#2724) (36c91ac), closes #2724
• tree: 修复 setChecked 方法状态同步问题 (#2273) (36c91ac), closes #2273
• tree: 修复展开动画 (#2989) (5142d18)

Features

• auto-complete: 元素 blur 时关闭面板 (#2916) (1e075f9), closes #2885
• badge: 支持 nzCount 传入 TemplateRef (#2880) (fd0d91c)
• cascader: 当级联选择器打开时调整位置 (#2836) (289ba54), closes #2181 ,#2809
• collapse: 支持自定义 panel 的图标 (#2783) (a530f80)
• comment: 新增 comment 组件 (14859c8), closes #2731
• date-picker,calendar: 支持所有日期组件的周起始时间 (#2819) (e1bce41), closes #2293 ,#2073
• date-picker: year-picker 支持 nzDisabledDate 选项 (#2949) (71dda9b), closes #2194
• empty: 新增空状态组件 (#2722) (8906dff), closes #2711
• icon: 支持旋转 (#2891) (07f76af), closes #2888
• icon: 更新依赖以支持命名空间功能 (#2641) (a2000fa)
• layout: 支持 zeroTrigger 属性 (#2938) (4e4231d), closes #1950 ,#1951
• menu,dropdown: 支持递归数据样例 (#2816) (09f21d0), closes #1697
• modal: 支持 nzOkDisabled 和 nzCancelDisabled (#2856) (fa6a8e9), closes #1838
• notification: 使用模板时可传入上下文 (#2926) (51940f7), closes #2755
• popconfirm: 支持自定义图标 (#2964) (ff030ff), closes #2196
• rate: 增加对 tooltip 的支持 (#2794) (e121bd3)
• select: 支持 automatic tokenization (#2741)
• select: 支持 maxTagCount & maxTagCountPlaceholder (#2741)
• slider: 支持通过 nzTooltipVisible 控制 tooltip 出现的时机 (#2930) (d3e61d4), closes #2373
• statistic: 新增统计组件 (#2760) (abb9ae4), closes #2754
• table: 支持 nzItemRender 属性 (#2862) (074083e)
• table: 支持 pagination 位置变换 (#2862) (074083e)
• table: 支持 td th 对齐树形 (#2862) (074083e)
• tabs: 支持 tab 内容懒加载 (#2968)
• tree-select: 支持设置 nzNotFoundContent (#2740) (d9055f5)
• tree: 搜索功能支持隐藏未匹配节点 (#2208) (36c91ac), closes #2208
• tree: 支持删除节点等操作(状态同步) (#1399#2384) (36c91ac), closes #1399 ,#2384
• tree: 支持按 key 获取 NzTreeNode 实例 (#2455) (36c91ac), closes #2455
• upload: 支持非 image 格式的文件预览 (#2709) (4c41715)

示例代码

在如下代码中，this.value.push('jack') 不会被 Angular 下的 OnPush 组件响应，需要使用 this.value = [ …this.value, 'jack' ] 组件才会进行响应。延伸阅读：These 5 articles will make you an Angular Change Detection expert

import { Component, OnInit } from '@angular/core';
@Component({
  selector: 'nz-demo-select-basic',
  template: `
    <nz-select [(ngModel)]="value" nzMode="multiple">
      <nz-option nzValue="jack" nzLabel="Jack"></nz-option>
      <nz-option nzValue="lucy" nzLabel="Lucy"></nz-option>
    </nz-select>
  `
})
export class NzDemoSelectBasicComponent implements OnInit {
  value = [ 'lucy' ];
  ngOnInit(): void {
    setTimeout(() => {
      // this.value.push('jack'); // mutate 数据不会被组件响应
      this.value = [ ...this.value, 'jack' ]; // 正确使用方式
    }, 3000);
  }
}

7.0.0 之前版本

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