更新日志

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

发布周期#

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

17.0.1#

2023-11-20

Bug Fixes#

• schematics: 修复 schematics 命令问题 (#8176) (de8a6b7)

17.0.0#

2023-11-19

Bug Fixes#

• autocomplete: 修复内部 nz-auto-option 的错误值 (#7907) (0a312e3)
• cron-expression: 修复报错信息 (#8114) (ea69790)
• form: 修复点击 label 聚焦元素错误问题 (#8135) (b3d135f)
• i18n: 添加 pl_PL 语言 (#7950) (7819426)
• i18n: 更新 fa_IR 语言 (#8143) (4f63198)
• i18n: 更新 fr/be/ca 语言 (#8137) (211db31)
• mention: 修复表单内未完全加载问题 (#8146) (9505c7c)
• resizable: 修复 pointer capture 问题 (#8169) (a0b8a0b)
• select: 性能优化 (#8159) (7ce50b3)
• slider: 修复 step 不可点击问题 (#7820) (1e1c753)
• table: 优化样式文件 (#8044) (fde48f9)
• tree-select: 修复回显顺序问题 (#8108) (eb4077d)
• tree: 修复 nzCheckBoxChange 事件未发出问题 (#8038) (a9dc205)

Features#

• affix: 支持 standalone 用法 (#8037) (583883c)
• hash-code: 新增 HashCode 组件 (#8111) (0254ee2)
• image: 支持指定缩放步骤比例 (#8163) (5aa4db9)
• notification: 支持自定义 template (#8046) (9689c42)
• schematics: 支持 standalone 下 ng-add 命令 (#8095) (c1b61f7)
• slider:nzTipFormatter 支持 Template 类型 (#7505) (7c79ab3)
• table: 添加 nzLabel 以在复选框中包含 aria-label (#7903) (5834e46)
• table: 支持自定义展开图标 (#7886) (1507ed0)
• tooltip,popover,popconfirm: 暴露 cdkConnectedOverlayPush 配置 (#8166) (a821c62)

16.2.2#

2023-10-23

Bug Fixes#

• 内置 cdk-overlay 样式 (#8132) (3209d74)
• cascader: 兼容 rxjs v6 (#8133) (54a5c76)
• drawer:drawer 不能打开 (#8120) (24d0664)

16.2.1#

2023-10-19

Bug Fixes#

• @angular/cdk/overlay-prebuilt.css 样式报错 (#8122) (42da190)
• color-picker: 优化 demo 展示 (#8088) (6d03099)
• menu: menu title 溢出省略 (#8055) (0674f78)
• tree-select: 修复节点为禁用状态时，back快捷键能删除bug (#8105) (07a1f5e)

Features#

• select: 支持自定义 nz-option-item 的 attr.title (#8097) (2ee261a)

16.2.0#

2023-09-18

Bug Fixes#

• list: 修复同步操作项不显示在项目中的问题 (#7958) (3b6bdec)
• tree: 修复 nzBeforeDrop 拖拽样式不消失问题 (#8015) (2d0b3f7)
• button: 添加 ant-btn-icon-only class (#7631) (#7678) (7470ed6)
• cascader: 修复自定义已选项后会出现 title undefined 问题 (#8011) (10003db), closes #8006
• core: 修复 CSP 问题 (#8059) (295b333)
• cron-expression: 清除 console 警告 (#7926) (b358345)
• date-picker: 更新代码注释 (#7991) (8b6b653)
• i18n: 更新国际化文案 (#7901) (9bfce45)
• message: 关闭后清理 DOM (#7965) (71ead99), closes #7772
• message: 修复 overlay 的 z-index (#8081) (b1d2095)
• notification: 更新操作不创建新的 messageId (#8000) (e240264)
• qrcode: 优化 demo 样式 (#8020) (078aaf9)
• table: 自定义列移除空格 (#8022) (15e244c)
• time-picker: 修复 modelChange 触发两次问题 (#7902) (74c13a4)
• tree-view: 修复重复渲染问题 (#8035) (68cb4b2)
• tree: 移除 console (#8019) (fa0312a)
• watermark: 修复重绘问题 (#8012) (030318e)
• showcase: 修复 rtl 模式的样式问题 (#8063) (d57b7da)

Features#

• core: 支持 provide 使用方式 (#7952) (150c6ca)
• cascader: 支持 observable 加载数据 (#8048) (1436f21)
• color-picker: 支持颜色选择器组件 (#8013) (8439704)
• cron-expression: 新增单元测试 (#7993) (605e969)
• cron-expression: 支持 nzDisabled && nzBorderless 属性 (#7992) (6d31bde)
• dropdown: close context menu on escape (#7915) (6d0032e)
• dropdown: 优化 NzContextMenuService#create() (#7768) (9b3e6cb)
• form: 支持 label wrap (#7892) (37391de)
• input:number 类型支持隐藏步骤 (#8003) (0f3aed5)
• modal: 移除 nzComponentParams 过期属性 (#7930) (baab16c)
• qrcode: 支持新特性 (#8001) (718ba29)
• resizable:NzResizeEvent 暴露 direction (#7987) (4143473)
• resizable: 支持更多鼠标类型 (#8042) (e564714)
• table: 支持自定义展示列 (#7966) (d26870f)

Performance Improvements#

• select: 支持传递 nzKey (#8033) (e94da4e)
• select: 移除不必要的类型 (#7850) (71c2138)
• tabs: 添加 .ant-tabs-tab 样式以减少 css 计算消耗 (#7935) (#7936) (198644a)

16.1.0#

2023-07-16

Bug Fixes#

• list: 修复异步节点未正确展示问题 (#7958) (3b6bdec)
• tree: 修复拖拽节点样式未正确取消问题 (#8015) (2d0b3f7)
• cascader: 修复自定义项导致 title undefined 问题 (#8011) (10003db), closes #8006
• date-picker: 更新代码注释 (#7991) (8b6b653)
• i18n: 更新繁体文案 (#7901) (9bfce45)
• notification: 更新组件不创建新的 messageId (#8000) (e240264)
• time-picker: 修复 modelChange 触发多次问题 (#7902) (74c13a4)
• watermark: 修复水印组件重绘问题 (#8012) (030318e)

Features#

• cron-expression: 新增单元测试 (#7993) (605e969)
• cron-expression: 支持 nzDisabled && nzBorderless 属性 (#7992) (6d31bde)
• dropdown: 支持 ESC 退出 (#7915) (6d0032e)
• dropdown: create 返回 EmbeddedViewRef 对象 (#7768) (9b3e6cb)
• form: 支持 nzLabelWrap 属性控制换行 (#7892) (37391de)
• modal: 移除废弃属性 nzComponentParams (#7930) (baab16c)
• qrcode: 支持 nzBgColor & nzPadding 优化另存为图片效果 (#8001) (718ba29)
• resizable:NzResizeEvent 支持 NzResizeDirection 属性 (#7987) (4143473)
• table: 支持自定义展示列 (#7966) (d26870f)

Performance Improvements#

• select: 移除多余的方法参数类型 (#7850) (71c2138)
• tabs: 优化 css 渲染性能 (#7935) (#7936) (198644a)

16.0.0#

2023-05-31

安装 ng-zorro-antd#

对于 standalone 模式请手动参考文档添加

$ cd PROJECT-NAME
$ ng add ng-zorro-antd@16.0.0

Bug Fixes#

• date-picker: 修复 ng-untouched 问题 (#7922) (9ebcf72)
• date-picker: 修复跨年选择周期显示不正确问题 (#7923) (e7f9538)
• datepicker: 修复 ngModel 未更新问题 (#7948) (100796c)
• slider: 修复首个禁用失效问题 (#7947) (ad2faf4), closes #7943

15.1.0#

2023-04-02

Bug Fixes#

• docs: 更新升级文档描述 (#7890) (78541e1)
• datepicker: 更新相同值触发 OnChange 事件 (#7815) (3602abc)
• radio: 触发 focus 和 blur 时间时更新 touch 状态 (#7885) (39f0cea), closes #7877
• time-picker: 修复 AM/PM 选择器隐藏问题 (#7701) (129e944)
• tooltip: 修复测试代码报错问题 (#7893) (3dfa655)

Features#

• form: 支持 label 设置对齐方式 (#7870) (d54b3b4)
• modal: 支持 nzData 传值 (#7849) (ea9969d)
• qrcode: 新增二维码组件 (#7803) (ff36981)
• watermark: 新增水印组件 (#7857) (11b85a4)

Performance Improvements#

• avatar: 减少触发不必要的脏值检测 (#7862) (1c48745)
• date-picker: 减少触发不必要的脏值检测 (#7860) (1171460)

15.0.3#

2023-01-17

Bug Fixes#

• radio: 修复禁用失效问题 (#7812) (2b4df9a)

15.0.2#

2023-01-15

Bug Fixes#

• checkbox: 修复禁用失效问题 (#7806) (eb2cb04)

15.0.1#

2023-01-09

Bug Fixes#

• components: 修复部分组件禁用属性未生效情况 (#7786) (bc673e7)

15.0.0#

2022-12-21

安装 ng-zorro-antd#

$ cd PROJECT-NAME
$ ng add ng-zorro-antd@15.0.0

Bug Fixes#

• drawer: 修复 nzContentParams 定义问题 (#7668) (0074013), closes #7620

Performance Improvements#

• date-picker: 移除未生效的代码 (#7767) (1572da5)
• form: 移除未生效的代码 (#7766) (162d290)

14.3.0#

2022-12-11

Bug Fixes#

• tree: 修复自定义节点时拖拽目标样式未显示问题 (#7579) (5996019)
• input: 修复 nzHasFeedback 样式问题 (#7709) (ddd44d2), closes #7574
• list: 指定 context 上下文类型 (#7756) (4eb32fd)
• select: 修复禁用选项被 Enterd 键选择问题 (#7686) (5bdf244)
• tree: 修复组件搜索性能问题 (#7385) (21208f0)

Features#

• cron-expression: 支持自定义渲染时间能力 (#7750) (1820da5)
• date-picker:nzSeparator 属性支持 template 方式使用 (#7721) (3771512)
• select: 支持 Tab 键 (#7728) (d9f9092)
• tree-select: 支持设置下拉展开位置 (#7551) (325971e)

14.2.1#

2022-11-27

Bug Fixes#

• animation: 修复部分组件动画失效问题 (#7739) (2df4860)
• i18n: 添加缺失的匈牙利语 (#7733) (de71300)
• select: 修复滚动加载情况下选中值行为 (#7725) (9e08be9)

14.2.0#

2022-11-21

Bug Fixes#

• cron-expression: 优化组件样式 (#7715) (726ded3)
• date-picker: 修复 RTL 模式下箭头位置错误问题 (#7690) (41b56e4)
• date-picker: 修复重复组件问题 (#7680) (ee4872e), closes #7450
• descriptions: 修复 nzStringTemplateOutlet 标题样式问题 (#7704) (bec3b42), closes #7698
• icon: 修复部分情况下未及时更新情况 (#7719) (754ded6)
• image: 修复预览本地图片错误问题 (#7615) (616f59f)

Features#

• alert: 支持自定义图标 (#7691) (cc014a1)
• carousel:nzLoop 属性支持手动指定是否循环 (#7693) (e3103f0)
• cron-expression: 新增 cron 表达式组件 (#7677) (3a638af)
• popconfirm: 支持 nzOkDanger 类型自转换 (#7720) (f6a8044)

14.1.1#

2022-10-15

Bug Fixes#

• code-editor: 修复 Window 定义与 monaco-editor 最新版本不匹配问题 (#7676) (bdf6507)
• date-picker: 修复清除按钮无效问题 (#7671) (ba90876), closes #7534

14.1.0#

2022-10-09

Bug Fixes#

• cascader: 修复文档格式 (#7604) (8b92c63)
• i18n: 更新国际化文案 (#7646) (aecb788)
• pagination: dom 结构添加 ul 标签以同步 antd 结构 (#7500) (becdd68)
• segmented: 修复 index.less 文件未导入问题 (#7624) (1d6a646)
• select: 修复虚拟滚动出现空白区域问题 (#7642) (1f10a9c)
• select: 修复 select 组件内输入框 input 元素宽度不占满问题 (#7626) (82159e3)
• statistic: 移除顶层多余的 div 元素 (#7659) (07df410)
• steps: 移除顶层多余的 div 元素 (#7582) (60beabc)
• typography: 修复部分场景下聚焦元素不生效问题 (#7320) (2d2fe33)

Features#

• popconfirm: 支持异步关闭 (#7533) (797b261)
• select: 支持指定弹出位置 (#7537) (dda0e6d)
• date-picker: 新增 nzShowWeekNumber 属性显示周数 (#7621) (2cb80fc)
• menu: 支持指定弹出位置 (#7420) (b1223bd), closes #4743
• select:nzDropdownClassName 属性支持 string 数组 (#7643) (966dc8f)
• time-picker: 新增 nzInputReadOnly 属性支持 input 标签设置为只读 (#7660) (2dcefe2)

14.0.0#

2022-08-25

安装 ng-zorro-antd#

$ cd PROJECT-NAME
$ ng add ng-zorro-antd@14.0.0

Bug Fixes#

• steps: 移除顶层多余的 div 元素 (#7582) (60beabc)

Features#

• icon:nz-icon 使用方式从 i 元素变更为 span 元素 (#7586) (7242111)
• popconfirm: 支持基于 Promise 的异步关闭 (#7533) (797b261)

- <i nz-icon nzType="search" nzTheme="outline"></i>
+ <span nz-icon nzType="search" nzTheme="outline"></span>

BREAKING CHANGES#

• pagination:dom 结构中添加 ul 标签 (#7500) (becdd68)

13.4.0#

2022-07-25

Bug Fixes#

• datepicker: 修复手动打开组件未正确聚焦输入框问题 (#7512) (b3a27d8)
• transfer: 修复选择/反选操作未正确显示问题 (#7419) (1e9c11e)

Features#

• notification: 支持指定位置弹出 (#7540) (d8b26dd)
• anchor: 支持设置滚动偏移量等功能 (#7494) (254b429)
• badge: 支持设置 nzSize 属性 (#7405) (f40dd38)
• date-picker: 支持指定弹出位置 (#7527) (a652470)
• input-number: 支持无边框模式 (#7539) (ea1138b)
• switch: 添加 nzId 属性指定内部元素 id (#6815) (4c71bdb)
• time-picker: 支持无边框模式 (#7547) (a8c3f95)

Performance Improvements#

• transfer: 增加 trackBy 方法减少渲染消耗 (#7424) (0587236)

13.3.2#

2022-06-26

Bug Fixes#

• input-number: 修复引入 input number 模块报错问题 (#7531) (800e6f4)

13.3.1#

2022-06-20

Bug Fixes#

• input, input-number, steps: 修复组件部分场景下的样式问题 (#7522) (222b225)

13.3.0#

2022-06-15

Bug Fixes#

• icon: 修复 deleteOutline 图标缺失问题 (#7499) (ba6bade)
• tooltip: 修复首次显示时位置不正确问题 (#7457) (23a2fd5), closes #7453
• transfer: 修复在表单内部使用时错误触发 submit 问题 (#7413) (0cfebca), closes #7410

Features#

• cascader: 支持设置校验状态 (#7452) (e10908e)
• date-picker: 支持设置校验状态 (#7479) (c3d0874)
• form: 支持根据表单状态设置子组件校验状态 (#7489) (98ac620)
• input-number: 支持数字输入框前缀后缀组合 (#7488) (b038fa2)
• input-number: 支持设置校验状态 (#7462) (0c9287a)
• input: 支持设置校验状态 (#7472) (999215e)
• mentions: 支持设置校验状态 (#7467) (ac38b2d)
• segmented: 新增分段控制器组件 (#7404) (95a31da)
• select: 支持设置校验状态 (#7478) (44b7fe0)
• time-picker: 支持设置校验状态 (#7473) (0d8249b)
• transfer: 支持设置校验状态 (#7475) (9b98fe1)
• tree-select: 支持设置校验状态 (#7477) (40815ad)

13.2.2#

2022-05-12

Bug Fixes#

• tree-view: 修复虚拟滚动模式下动态添加数据未正确更新问题 (#7426) (a702674)

13.2.1#

2022-04-27

Bug Fixes#

• code-editor: 移除 NZ_CONFIG monaco-editor 强依赖 (#7392) (929084d)

13.2.0#

2022-04-26

Bug Fixes#

• carousel: 修复 nzAfterChange 回调未正确触发问题 (#7326) (b517bd4), closes #7323
• cascader: 修复 hover 模式选项框无法错误隐藏问题 (#7381) (3d41ce0)
• cascader: 修复选项框超出区域被遮挡问题 (#7306) (4c669a5)
• i18n: 修复部分翻译缺失问题 (#7364) (64e1c7c)
• list: 修复 NgZone.onStable 事件后未正确触发脏值检测问题 (#7314) (425f8df)
• modal: 关闭弹窗过程中忽略点击确认取消按钮行为 (#7336) (d169452)
• popconfirm: 修复 nzPopconfirmVisibleChange 未触发问题 (#7338) (561041c)
• upload: 修复在 Firefox 91/92 版本中拖拽文件会打开新页面问题 (#7190) (9b51874)

Features#

• code-editor: 支持设置自定义配置以支持 monaco editor 配置 (#7121) (21ec517)
• code-editor: 支持在 NZ_CONFIG 定义 window.MonacoEnvironment (#7359) (4dfd9cd), closes #6502
• image: 支持点击键盘左右方向键切换图片 (#7321) (b5f82b5)
• input-number: 增加 nzReadOnly 属性支持只读方式 (#7372) (0da7496), closes #7369

Performance Improvements#

• anchor: 使用 passive 改善的滚屏性能 (#7330) (aab060f)
• back-top: 使用 passive 改善的滚屏性能 (#7329) (7f3c4e1)
• cascader: 减少触发不必要的脏值检测 (#7312) (cb803f9)
• image: 减少触发不必要的脏值检测 (#7309) (752a5b6)
• input-number: 减少触发不必要的脏值检测 (#7313) (54386ef)
• modal: 优化在不同设备上渲染帧率效果 (#7293) (106d346)
• resizable: 使用 passive 改善性能 (#7331) (518997b)
• tree-view: 减少触发不必要的脏值检测 (#7307) (1e0872b)

13.1.1#

2022-03-03

Bug Fixes#

• collapse: 修复点击无法正常展开收起问题 (#7284) (b7433a9)
• icon: 修复 SSR 构建加载 svg icon 抛错问题 (#7290) (fe0484f), closes #7240
• select: 修复搜索未正确匹配下拉选择项问题 (#6816) (48d2a25), closes #6812
• upload: 修复 nzTransformFile 转换上传的文件功能未正确转换文件问题 (#7206) (b82d2f3)

13.1.0#

2022-02-25

Bug Fixes#

• button: 修复 nzLoading 为 true 情况下仍可点击问题 (#7267) (2306e0d)
• date-picker: 内联模式下修改 z-index 为 auto (#7172) (26006f6)
• date-picker: 修复日期变化时禁用时间段未同步问题 (#7236) (ae67952)
• i18n: 修复 fa-IR.ts 翻译缺失内容 (#7249) (a7a0b41)
• i18n: 修复 pt_BR.ts 翻译缺失内容 (#7218) (95c7816)
• input: 删除 box-sizing 设置 (#7214) (035dc94), closes #7203
• input: 修复 disabled 状态下样式不正确问题 (#7250) (7acb8db)
• radio: 修复 radio 确保取消选中状态返回 false (#7270) (2704237)
• select: 修复下拉选项值为空时键盘事件报错问题 (#7222) (4bd86ca), closes #7242
• slider: 修复 keydown 事件未触发 nzOnAfterChange 问题 (#7252) (f419c07), closes #7251

Features#

• alert: 支持 nzAction 自定义操作项 (#7246) (eb3b1ba)
• drawer: 支持 nzSize 属性与 nzExtra 自定义操作项 (#7227) (d2e5b76)
• i18n: 添加 kk_KZ 哈萨克语国际化 (#7261) (3580fb0)
• i18n: 添加 km_KH 高棉国际化 (#7220) (f972391)

Performance Improvements#

• auto-complete: 减少触发不必要的脏值检测 (#7138) (e95d941)
• back-top: 减少触发不必要的脏值检测 (#7179) (7d091bb)
• carousel: 减少触发不必要的脏值检测 (#7136) (fc991d1)
• collapse: 减少触发不必要的脏值检测 (#7181) (3c3eac9)
• dropdown: 减少触发不必要的脏值检测 (#7135) (4679592)
• image: 减少触发不必要的脏值检测 (#7147) (f0f52a4)
• mention: 减少触发不必要的脏值检测 (#7146) (b72bd27)
• mention: 减少触发不必要的脏值检测 (#7130) (73af728)
• resizable: 减少触发不必要的脏值检测 (#7170) (9a8d794)
• select: 减少触发不必要的脏值检测 (#7133) (a1bbdab)
• select: 减少触发不必要的脏值检测 (#7175) (fd63d22)
• table: 减少触发不必要的脏值检测 (#7174) (e541761)
• table: 减少触发不必要的脏值检测 (#7142) (5a5df13)
• table: 减少触发不必要的脏值检测 (#7140) (ec248c9)
• tabs: 减少触发不必要的脏值检测 (#7144) (148f84d)
• time-picker: 减少触发不必要的脏值检测 (#7143) (72da774)
• tree-view: 减少触发不必要的脏值检测 (#7178) (0054f59)
• typography: 减少触发不必要的脏值检测 (#7185) (ad547fb)

13.0.1#

2022-01-18

Bug Fixes#

• back-top: 修复 scrolling listener 问题 (#7208) (3bcd343), closes #7199
• drawer: 修复 nzTitle 为空时关闭图标的位置错误问题 (#7176) (a6195b9), closes #7164
• icon: 修复切换图标未正确替换问题 (#7188) (67ac573), closes #7186
• statistic:nzCountdownFinish 事件触发后应重新进入 ngZone (#7137) (6835544)
• tree-view: 修复 trackBy 方法在虚拟滚动场景下节点异常问题 (#7150) (4484674), closes #7118

Performance Improvements#

• auto-complete: 修复内存泄漏问题 (#7112) (3806250)
• cdk: 修复内存泄漏问题 (#7139) (2a93d05)
• checkbox: 减少触发脏值检测 (#7127) (15abe33)
• code-editor: 在 ngZone 外初始化提升性能 (#7151) (f73be80)
• core: 应用销毁时停止 resize 事件监听 (#7125) (8437111)
• image: unsubscribe 过期的 src 源 (#7102) (87a3e27)
• input-number: 减少触发脏值检测 (#7129) (9971faa)
• modal: 鼠标事件无需触发脏值检测 (#7169) (c20bb80)
• modal: 修复内存泄漏问题 (#7123) (3664efe)
• graph: 动画执行无需触发脏值检测 (#7132) (1ceaf70)
• rate:focus 与 blur 事件在无监听情况下无需触发脏值检测 (#7182) (3e9e035)
• steps: 未监听 nzIndexChange 事件时无需触发脏值检测 (#7183) (cbfc558)
• transfer: checkbox 被点击无需重复触发脏值检测 (#7124) (b12f43a)

13.0.0#

2021-12-29

停止对 View Engine 的支持#

ng-zorro-antd@13 不再支持 View Engine 并使用 Ivy 包进行分发，你将获得更快的打包速度和更小的包体积。

获取更多帮助请前往 Angular Ivy 查看。

停止对 IE11 的支持#

• Angular 可以通过原生的 Web API 使用现代浏览器功能，如 CSS 变量 和 Web 动画等特性
• 移除 IE 相关的 polyfills 和代码使得应用程序更小、加载速度更快

获取更多帮助请前往 Issue #41840 查看。

性能增强#

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

BREAKING CHANGES#

dropdown

• [nzHasBackdrop] 已被移除，请使用 [nzBackdrop] 代替。

历史版本#

历史版本的更新记录可以在 Github 查看。