Releases: NG-ZORRO/ng-zorro-antd
Release list
19.0.1
19.0.1
2025-01-03
Bug Fixes
- date-picker: cell title should reflect
nzFormat(#8744) (1b7ab5a) - i18n: add missing translations to
zh_TW(#8950) (9607e11) - input-number: fix
NG0600error (#8955) (8d6135e) - table: should col be wrapped within colgroup in ssr mode (#8948) (0a73deb)
19.0.1
2025-01-03
Bug Fixes
19.0.0
19.0.0
2024-12-20
Bug Fixes
- autocomplete: remove inline style (CSP compliant) (#8875) (30c25f0)
- avatar: calculate size at the right time (#8754) (3a5ba37)
- card: remove
nzBorderlessinput (#8741) (22ce17c) - carousel: carousel not working correctly in rtl mode (#8770) (0202a19)
- cascader: correct menu display level (#8866) (5fec53e)
- drawer: should clear previously focused element (#8893) (4498af0)
- i18n: add missing translations to
vi_VN(#8894) (f08ad1c) - tree-view:
nzTreeNodePaddingnot works in virtual scroll (#8920) (82b660a)
Code Refactoring
- cancel support for HTML string rendering (#8831) (5fae01a)
- remove
ngClassandngStyle(#8895) (c3ab3ba) - image: remove deprecated
FADE_CLASS_NAME_MAPandIMAGE_PREVIEW_MASK_CLASS_NAME(#8912) (65223d9) - transfer,tree,tree-select rename
CheckBoxtoCheckbox(#8934) (c76433d5)
Features
- cascader: support multiple selection (#8903) (e5dfb49)
- cascader: support
nzPlacement(#8935) (6fbd22c) - checkbox: redesign the checkbox group component (#8932) (489e0de)
- divider: add
nzVariantoption (#8827) (2c63c87) - float-button: add float-button component (#7884) (dab4d66)
- icon: support
nz-icontag selector (#8778) (1406241) - image: close image preview when escape key pressed (#8809) (d587615)
- input: support one time password (OTP) (#8715) (cdbaf4d)
- menu: add
nzTriggerSubMenuActionto support click trigger for submenu (#8461) (860df87) - qrcode: add
nzStatusRenderto support customize state rendering (#8714) (6f36d75) - segmented: redesign the segmented component (#8753) (4dc866c)
- space: add space compact component (#8755) (b9c511d)
- table: add
nzSortDirectionsto global config (#6613) (#8721) (eb1fdc5) - transfer: add
nzOneWayto support one way style (#8717) (99fd4de) - input-number: redesign the input-number (#8901) (df55d88)
- schematics: add v19 ng update migration (#8911) (1a20de2)
BREAKING CHANGES
-
All
nzClass/nzStyleinput properties no longer support the following features:Set(): use arrays instead- Keys which multiple styles/classes separated with keys: split a key with spaces into multiple keys
- Cancel support for HTML string rendering
- Migrate
@WithConfigto standard decorator. If you're using@WithConfigin your library, please turnexperimentalDecoratorsoff intsconfig.json - Migrate
[nz-icon]tonz-icontag. If you're using[nz-icon]selector in stylesheet to select icon inside zorro component, please usenz-iconinstead
-
input-number: Redesign the input-number so that it will be much simpler and more flexible.
Now you can use affixes or addons as follows, no need for
ng-templateandnz-input-number-group:<!-- Custom handler icons --> <nz-input-number> <nz-icon nzInputNumberUpIcon /> <nz-icon nzInputNumberDownIcon /> </nz-input-number> <!-- With affixes --> <nz-input-number> <span nzInputPrefix>Prefix</span> <span nzInputSuffix>Suffix</span> </nz-input-number> <!-- With addons --> <nz-input-number> <span nzInputAddonBefore>Before</span> <span nzInputAddonAfter>After</span> </nz-input-number>
The old input-number component is marked as deprecated, and its entrypoint had changed to
ng-zorro-antd/input-number-legacy.
NzInputNumberComponentis nowNzInputNumberLegacyComponent, andNzInputNumberModuleis nowNzInputNumberLegacyModule.Don't worry,
ng update ng-zorro-antdwill automatically do the migration. -
cascader: Cancel support for writing value with
NzCascaderOption[]type.In the past, the cascader component kept a trick that if you wrote value with
NzCascaderOption[]type, it extracted value by mapping each item to its value property, for example:@Component({ template: `<nz-cascader [nzOptions]="options" [ngModel]="value"></nz-cascader>` }) export class ExampleComponent { value = [{ label: 'NG ZORRO', value: 'ng-zorro-antd' }] }
then the value of cascader would be
'ng-zorro-antd'.
It's strange that the input and output values don't match when we haven't changed the values, and it's hard to maintain. We expect that the value passed in should be the value in the list of options.In v19, this trick is removed and if you're already using this trick in your code, please consider the add a
mapfunction to pass the actual value. -
checkbox Redesign the checkbox group component.
- Remove
NzCheckBoxOptionInterface['checked]field. By the way,NzCheckBoxOptionInterfaceis marked as deprecated, useNzCheckboxOptioninstead nz-checkbox-group: Type ofngModelis changed fromNzCheckBoxOptionInterface[]toNzCheckboxOption['value'][]
- Remove
-
card: Remove redundant
nzBorderlessinput property. UsenzBorderedinstead. -
image: Remove deprecated
FADE_CLASS_NAME_MAPandIMAGE_PREVIEW_MASK_CLASS_NAME -
pipes: Remove deprecated
NzSafeNullPipe -
segmented: Redesign the segmented component.
- Value of
ngModelis changed fromindexto option's value - Change emission type of
nzValueChangefromnumberto option's value type (string | number) - Remove
nzLabelTemplate, usenz-segmented-itemdirective instead
- Value of
-
space: Rename
exportAsofNzSpaceComponentfromNzSpaceto standardnzSpace -
transfer: Rename
nzTreeCheckBoxChangetonzTreeCheckboxChange -
tree,tree-select: Rename
nzCheckBoxChangeto `nzCheckboxCha...
19.0.0-beta.1
19.0.0-beta.1
2024-12-17
Bug Fixes
- cascader: abnormal width of search results (#8937) (c6aa501)
- cascader: should change check state trigger ngModelChange (#8941) (2c7f49a)
- input-number: skip first setDisabledState when use with ngModel (#8933) (8b24746)
- input-number: value out of range when hold shift key (#8936) (a8efd2b)
- select: multiple selection don't show search input (#8929) (ef4bbb1)
- tree-view: nzTreeNodePadding not works in virtual scroll (#8920) (82b660a)
Features
- cascader: support
nzPlacement(#8935) (6fbd22c) - checkbox: redesign the checkbox group component (#8932) (489e0de)
BREAKING CHANGES
-
All Migrate
[nz-icon]tonz-icontag. If you're using[nz-icon]selector in stylesheet to select icon inside zorro component, please usenz-iconinstead -
checkbox Redesign the checkbox group component.
- Remove
NzCheckBoxOptionInterface['checked]field. By the way,NzCheckBoxOptionInterfaceis marked as deprecated, useNzCheckboxOptioninstead nz-checkbox-group: Type ofngModelis changed fromNzCheckBoxOptionInterface[]toNzCheckboxOption['value'][]
- Remove
-
transfer: Rename
nzTreeCheckBoxChangetonzTreeCheckboxChange -
tree,tree-select: Rename
nzCheckBoxChangetonzCheckboxChange
Deprecations
The following APIs are marked as deprecated in v19 and will be removed in the next major version.
Please refer to related documentation for better alternatives.
| Module | API |
|---|---|
ng-zorro-antd/checkbox |
NzCheckboxWrapperComponent |
19.0.0-beta.1
2024-12-17
Bug Fixes
- cascader: 修复搜索下拉框宽度异常的问题 (#8937) (c6aa501)
- cascader: 修复多选模式下 checkbox 状态改变时未触法
ngModelChange的问题 (#8941) (2c7f49a) - input-number: 使用 ngModel 时跳过第一次
setDisabledState调用 (#8933) (8b24746) - input-number: 修复按键改变值时值超出上下限的问题 (#8936) (a8efd2b)
- select: 多选模式下输入框不展示的问题 (#8929) (ef4bbb1)
- tree-view: 修复
nzTreeNodePadding在虚拟滚动中不生效问题 (#8920) (82b660a)
Features
- cascader: 支持
nzPlacement自定义浮层弹出位置 (#8935) (6fbd22c) - checkbox: 重新设计
nz-checkbox-group组件,支持自定义布局 (#8932) (489e0de)
BREAKING CHANGES
-
All 组件内部写法从
[nz-icon]迁移到新的nz-icon标签。如果在 CSS 中使用了[nz-icon]选择器来选择组件内部的图标,请使用为nz-icon替代 -
checkbox Redesign the checkbox group component.
- 移除
NzCheckBoxOptionInterface['checked]字段,另外NzCheckBoxOptionInterface被标记为弃用,请使用NzCheckboxOption替代 nz-checkbox-group:ngModel类型从NzCheckBoxOptionInterface[]改为选项值的类型NzCheckboxOption['value'][]
- 移除
-
transfer: 属性
nzTreeCheckBoxChange重命名为nzTreeCheckboxChange -
tree,tree-select: 属性
nzCheckBoxChange重命名为nzCheckboxChange
Deprecations
在 v19 中,以下 API 被标记为 deprecated,并将在下一个主要版本中移除。 请参考相关文档以获取更好的替代方案。
| Module | API |
|---|---|
ng-zorro-antd/checkbox |
NzCheckboxWrapperComponent |
19.0.0-beta.0
19.0.0
2024-12-06
Bug Fixes
- autocomplete: remove inline style (CSP compliant) (#8875) (30c25f0)
- avatar: calculate size at the right time (#8754) (3a5ba37)
- card: remove
nzBorderlessinput (#8741) (22ce17c) - carousel: carousel not working correctly in rtl mode (#8770) (0202a19)
- cascader: correct menu display level (#8866) (5fec53e)
- drawer: should clear previously focused element (#8893) (4498af0)
- i18n: add missing translations to
vi_VN(#8894) (f08ad1c)
Code Refactoring
- cancel support for HTML string rendering (#8831) (5fae01a)
- remove
ngClassandngStyle(#8895) (c3ab3ba) - image: remove deprecated
FADE_CLASS_NAME_MAPandIMAGE_PREVIEW_MASK_CLASS_NAME(#8912) (65223d9)
Features
- cascader: support multiple selection (#8903) (e5dfb49)
- divider: add
nzVariantoption (#8827) (2c63c87) - float-button: add float-button component (#7884) (dab4d66)
- icon: support
nz-icontag selector (#8778) (1406241) - image: close image preview when escape key pressed (#8809) (d587615)
- input: support one time password (OTP) (#8715) (cdbaf4d)
- menu: add
nzTriggerSubMenuActionto support click trigger for submenu (#8461) (860df87) - qrcode: add
nzStatusRenderto support customize state rendering (#8714) (6f36d75) - segmented: redesign the segmented component (#8753) (4dc866c)
- space: add space compact component (#8755) (b9c511d)
- table: add
nzSortDirectionsto global config (#6613) (#8721) (eb1fdc5) - transfer: add
nzOneWayto support one way style (#8717) (99fd4de) - input-number: redesign the input-number (#8901) (df55d88)
- schematics: add v19 ng update migration (#8911) (1a20de2)
BREAKING CHANGES
-
All
nzClass/nzStyleinput properties no longer support the following features:Set(): use arrays instead- Keys which multiple styles/classes separated with keys: split a key with spaces into multiple keys
- Cancel support for HTML string rendering
- Migrate
@WithConfigto standard decorator. If you're using@WithConfigin your library, please turnexperimentalDecoratorsoff intsconfig.json
-
input-number: Redesign the input-number so that it will be much simpler and more flexible.
Now you can use affixes or addons as follows, no need for
ng-templateandnz-input-number-group:<!-- Custom handler icons --> <nz-input-number> <nz-icon nzInputNumberUpIcon /> <nz-icon nzInputNumberDownIcon /> </nz-input-number> <!-- With affixes --> <nz-input-number> <span nzInputPrefix>Prefix</span> <span nzInputSuffix>Suffix</span> </nz-input-number> <!-- With addons --> <nz-input-number> <span nzInputAddonBefore>Before</span> <span nzInputAddonAfter>After</span> </nz-input-number>
The old input-number component is marked as deprecated, and its entrypoint had changed to
ng-zorro-antd/input-number-legacy.
NzInputNumberComponentis nowNzInputNumberLegacyComponent, andNzInputNumberModuleis nowNzInputNumberLegacyModule.Don't worry,
ng update ng-zorro-antdwill automatically do the migration. -
cascader: Cancel support for writing value with
NzCascaderOption[]type.In the past, the cascader component kept a trick that if you wrote value with
NzCascaderOption[]type, it extracted value by mapping each item to its value property, for example:@Component({ template: `<nz-cascader [nzOptions]="options" [ngModel]="value"></nz-cascader>` }) export class ExampleComponent { value = [{ label: 'NG ZORRO', value: 'ng-zorro-antd' }] }
then the value of cascader would be
'ng-zorro-antd'.
It's strange that the input and output values don't match when we haven't changed the values, and it's hard to maintain. We expect that the value passed in should be the value in the list of options.In v19, this trick is removed and if you're already using this trick in your code, please consider the add a
mapfunction to pass the actual value. -
card: Remove redundant
nzBorderlessinput property. UsenzBorderedinstead. -
image: Remove deprecated
FADE_CLASS_NAME_MAPandIMAGE_PREVIEW_MASK_CLASS_NAME -
pipes: Remove deprecated
NzSafeNullPipe -
segmented: Redesign the segmented component.
- Value of
ngModelis changed fromindexto option's value - Change emission type of
nzValueChangefromnumberto option's value type (string | number) - Remove
nzLabelTemplate, usenz-segmented-itemdirective instead
- Value of
-
space: Rename
exportAsofNzSpaceComponentfromNzSpaceto standardnzSpace
Deprecations
The following APIs are marked as deprecated in v19 and will be removed in the next major version.
Please refer to related documentation for better alternatives.
| Module | API |
|---|---|
ng-zorro-antd/button |
NzButtonGroupComponent |
ng-zorro-antd/core/form |
NzFormPatchModule |
ng-zorro-antd/input |
NzInputGroupComponent#nzCompact |
ng-zorro-antd/input-number-legacy |
* |
ng-zorro-antd/message |
NzMessageModule |
ng-zorro-antd/notification |
NzNotificationModuleNzNotificationServiceModule |
19.0.0
2024-12-06
Bug Fixes
18.2.1
18.2.1
2024-11-15
Bug Fixes
- anchor: fix
atag problem withnullorundefinedvalue if TemplateRef provided (#8864) (41f6609) - color-picker: remove inline style (CSP compliant) (#8874) (0264da9)
- image: remove inline style (CSP compliant) (#8876) (63c8953)
- qrcode: remove event listeners once settled (#8861) (40d466d)
- select: remove inline style (CSP compliant) (#8873) (9431d0d)
- transfer: cancel selecting all should emit
nzSelectChangeevent (#8872) (5ff9821) - watermark: cleanup event listeners once settled (#8862) (decd477)
18.2.1
2024-11-15
Bug Fixes
- anchor: 修复
nzTitle使用 TemplateRef 时a标签 title 内容异常 (#8864) (41f6609) - color-picker: 修复 CSP 问题 (#8874) (0264da9)
- image: 修复 CSP 问题 (#8876) (63c8953)
- select: 修复 CSP 问题 (#8873) (9431d0d)
- transfer: 修复取消全选未触发
nzSelectChange事件 (#8872) (5ff9821) - qrcode: 加载稳定后移除事件监听器 (#8861) (40d466d)
- watermark: 加载稳定后移除事件监听器 (#8862) (decd477)
18.2.0
18.2.0
2024-11-07
Bug Fixes
- i18n: add missing translations to
nb_NO(#8712) (8c9bcd1) - i18n: add missing translations to
hu_HU(#8769) (9e21ae8) - badge: NG0955 warning in nz-badge-sup component (#8858) (cc52555)
- select: multiple select cause switch size flash when init (#8851) (d28876c)
- carousel: correctly switch slides in rtl mode (#8705) (85f23a1)
- drawer: emit
nzVisibleChangewhen close on navigation (#8850) (29827df) - modal,drawer: secondary overlays not scrolling inside (#8804) (ed7951d)
- modal: remove dark backdrop when
nzMaskis false (#8798) (f2f04fe) - transfer: correctly set transfer button disable state (#8824) (195ad26)
Features
- datepicker: send event emitter when panel mode change (#8685) (6462a47)
- tabs: support
destroyInactiveTabPane(#8845) (0de6d62)
18.2.0
2024-11-07
Bug Fixes
- i18n: 添加国际化文案
nb_NO(#8712) (8c9bcd1) - i18n: 添加国际化文案
hu_HU(#8769) (9e21ae8) - badge: 修复组件中的 NG0955 警告 (#8858) (cc52555)
- select: 修复多选模式下和 switch 一起使用时,引发初始化时 switch 组件大小闪烁 (#8851) (d28876c)
- carousel: 修复 rtl 模式下轮播图切换异常 (#8705) (85f23a1)
- drawer: 导航关闭时发射
nzVisibleChange事件 (#8850) (29827df) - modal,drawer: 修复弹出容器中滚动异常 (#8804) (ed7951d)
- modal: 修复
nzMask为false时遮罩被渲染 (#8798) (f2f04fe) - transfer: 正确更新穿梭按钮的禁用状态 (#8824) (195ad26)
Features
18.1.1
18.1.1
2024-08-20
Bug Fixes
- fix ngtypecheck reference issue caused by @angular/compiler-cli#56945 (#8699) (8e459c1)
- date-picker: fix the NG0956 warning when recreating entire collection (#8658) (70a0817)
- grid: fix the NG0955 warning in showcase (#8679) (6414c92)
- tree-select: clear selected nodes when user set value (#8693) (91927bc)
18.1.1
2024-08-20
Bug Fixes
18.1.0
18.1.0
2024-07-25
Bug Fixes
- cascader: hide placeholder when trigger
compositionstartevent (#8641) (17b0ea3) - i18n: add missing translations to
pt_BR(#7790) (6fc1c78) - i18n: add scanned field to QRCode for
fr_BE,fr_CA,fr_FRandlv_LV(#8614) (9b69410) - schematics: import missing
RouterLinkin template (#8621) (032a0c2) - transfer: disabling selection does not affect selecting all (#8633) (75d8c7b)
Features
- breadcrumb: add
nzRouteFn(#6313) (6d805c4) - i18n: add
en_AU(#7919) (c4e6c8d) - icon: add
provideNzIconsandprovideNzIconPatchsAPI (#8650) (b22672d) - popconfirm: support popconfirm template context (#7989) (6d27073)
- table: support
nzSummary(#8639) (20bb5b2) - table: support
nzFixedfornzSummary(#8642) (bef12e6) - tree-select: support TemplateRef type for
nzNotFoundContent(#8638) (13e8a45)
18.1.0
2024-07-25
Bug Fixes
- cascader:
compositionstart事件触发时隐藏 placeholder (#8641) (17b0ea3) - i18n: 更新
pt_BR国际化文案 (#7790) (6fc1c78) - i18n: 更新
fr_BE,fr_CA,fr_FR,lv_LV国际化文案 (#8614) (9b69410) - schematics: 修复模板中
RouterLink引入缺失问题 (#8621) (032a0c2) - transfer: 修复选项全部禁用后全选按钮仍可点击 (#8633) (75d8c7b)
Features
- breadcrumb: 新增
nzRouteFn以格式化面包屑路由 (#6313) (6d805c4) - i18n: 添加国际化文案
en_AU(#7919) (c4e6c8d) - icon: 新增
provideNzIcons和provideNzIconsPatchAPI (#8650) (b22672d) - popconfirm: 新增支持
nzPopconfirmTitleContext上下文 (#7989) (6d27073) - table: 新增支持
nzSummary总结栏 (#8639) (20bb5b2) - table: 总结栏支持
nzFixed固定 (#8642) (bef12e6) - tree-select:
nzNotFoundContent支持 TemplateRef 类型 (#8638) (13e8a45)
18.0.1
18.0.1
2024-06-27
Bug Fixes
- graph: fix @for track function (#8587) (7687ff2)
- icon: fix @for track function (#8588) (8a27bab)
- table: fix @for track function (#8593) (b275063)
- pagination: fix @for track function (#8586) (6bb95c0)
- i18n: add missing german translations
de_DE(#8605) (8d75378) - i18n: add scanned field to QRCode
fa_IR(#8597) (9c6e4bf) - table: missing no-result in fixed header table (#8574) (6cff80e)
18.0.1
2024-06-27
Bug Fixes
- graph: 修复 @for track 表达式异常 (#8587) (7687ff2)
- icon: 修复 @for track 表达式异常 (#8588) (8a27bab)
- table: 修复 @for track 表达式异常 (#8593) (b275063)
- pagination: 修复 @for track 表达式异常 (#8586) (6bb95c0)
- i18n: 更新
de_DE国际化文案 (#8605) (8d75378) - i18n: 更新
fa_IR国际化文案 (#8597) (9c6e4bf) - table: 修复固定表头下渲染内容缺失问题 (#8574) (6cff80e)
18.0.0
18.0.0
2024-06-06
⚠ BREAKING CHANGES
- collapse: change nzExpandIconPosition type from
left|righttostart|end(#8561) (3ad5674) - no longer use inline JavaScript in Less (#8552) (7e873c8)
No need to wrap Less functions provided by antd (including colorEasing, colorPalette, tinycolor) with ~`` anymore.
- color(~`colorPalette('@{primary-color}', 5)`)
+ color(colorPalette('@{primary-color}', 5))Bug Fixes
- cascader,select,time-picker,tooltip,tree-select: take in account shadow dom when getting the target of an event (#7853) (843b703)
- tooltip: fix arrow color when custom color (#8555) (92c586b)
- upload: prevent drop event for firefox only (#8551) (c6e7bd7)
- rate: half value when allow half is false (#8536) (7742fe3)
Features
- date-picker: support quarter selection of date picker (#8478) (3513889), closes #7818 #7380
- qrcode: qrcode supports scanned state (#8447) (0be6178)
- rate: emit hover change when leave (#8448) (38dcc31)
- statistic: support for loading state (#8537) (21c8b62)
- table: support setting virtual height when having no data (#8457) (724d841)
18.0.0
2024-06-06
⚠ BREAKING CHANGES
- collapse:
nzExpandIconPosition类型从left|right变更为start|end(#8561) (3ad5674) - Less 中不再使用 inline JavaScript (#8552) (7e873c8)
使用 antd 提供的 Less 函数时不再需要用 ~`` 包裹,例如:
- color(~`colorPalette('@{primary-color}', 5)`)
+ color(colorPalette('@{primary-color}', 5))受影响的函数包括:colorEasing,colorPalette,tinycolor
Bug Fixes
- cascader,select,time-picker,tooltip,tree-select: 修复在 shadow DOM 中获取
EventTarget异常问题 (#7853) (843b703) - tooltip: 修复箭头颜色未被自定义颜色覆盖问题 (#8555) (92c586b)
- upload: 仅在 firefox 浏览器中阻止拖拽事件 (#8551) (c6e7bd7)
- rate: 修复
nzAllowHalf为false时展示半星 (#8536) (7742fe3)