ng-zorro-antd 21.0.0 發佈,基於 Angular 的 UI 組件

新聞
HongKong
1
10:46 AM · Jan 12 ,2026

ng-zorro-antd 是 Ant Design 的 Angular 實現,主要用於研發企業級中後台產品。全部代碼開源並遵循 MIT 協議,任何企業、組織及個人均可免費使用。

ng-zorro-antd 21.0.0 正式發佈,更新內容如下:

Code Refactoring

  • 遷移至 native animation API,您可以按需移除依賴 @angular/animations

Features

  • color-picker: 新增 nzPresets 參數支持預設顏色 (#9341) (d59ec99)
  • core: 新增 provideNzNoAnimation provider 用於禁用動畫效果 (#9555) (c945e81)
  • date-picker: 日期範圍選擇順序顛倒時確保能輸出正確的範圍 (#9518) (d0b3185)
  • float-button: 懸浮按鈕組合新增動畫效果 (#9413) (b40ad91)
  • input-number: 支持鼠標滾輪控制 (#9591) (6ce3545)
  • input,input-number: focus 方法新增額外參數 (#9595) (c336711)
  • qrcode: 新增 nzTypenzBoostLevel 參數,nzPadding 類型從 number | number[] 調整為 number (#9535) (5419b51)
  • tree-view: 升級 tree-view 組件,支持 nzLevelAccessornzChildrenAccessor (#9003) (ae9ad57)
  • upload: 新增 nzMaxCount 屬性 (#9424) (0bf13c3)

Bug Fixes

  • i18n: 更新 fa_IR 國際化文案 (#9615) (1e8845d)
  • popconfirm: 允許設置 nzIconnull 以隱藏圖標 (#9569) (760b587)
  • select: 單選模式下 nzAutoClearSearchValue 不應生效 (#9605) (4720c21)
  • tree: 不再阻止右鍵點擊樹節點標題的默認行為 (#9532) (900efad)

BREAKING CHANGES

  • back-top: 移除,請使用 float-button 替代
  • color-picker: 簡化 DOM 結構,移除 nzClick output 不必要的參數
  • input-number-legacy: 移除,使用 input-number 替代
  • qrcode: nzPadding 類型從 number | number[] 調整為 number
  • statistic: 重命名 NzStatisticNumberComponentNzStatisticContentValueComponent
  • tabs: 移除已棄用的 nz-tabset selector
  • tree-view: 移除 nzTreeControl,使用 nzLevelAccessornzChildrenAccessor 替代
  • watermark: 將引入路徑 ng-zorro-antd/water-mark 調整為 ng-zorro-antd/watermark

移除以下在過去的版本中標記為廢棄的 API:

Module API
ng-zorro-antd/back-top *
ng-zorro-antd/input-number-legacy *
ng-zorro-antd/dropdown NzDropdownButtonDirective
ng-zorro-antd/core NzHighlightModule
ng-zorro-antd/auto-complete NZ_AUTOCOMPLETE_VALUE_ACCESSOR
ng-zorro-antd/checkbox nz-checkbox-wrapper
ng-zorro-antd/date-picker NzDatePickerComponent#nzBorderless
ng-zorro-antd/input NzInputDirective#nzBorderless
ng-zorro-antd/input-number NzInputNumberComponent#nzBordered
ng-zorro-antd/mention NZ_MENTION_TRIGGER_ACCESSOR
ng-zorro-antd/select NzSelectComponent#nzBorderless
ng-zorro-antd/time-picker NzTimePickerComponent#nzBorderless
ng-zorro-antd/tooltip NzToolTipModule NzToolTipComponent

統一組件命名規範,變化如下:

Module Original Current
core NzConfig#backTop NzConfig#floatButton
core NzConfig#dropDown NzConfig#dropdown
dropdown NzDropDownModule NzDropdownModule
dropdown NzDropDownADirective NzDropdownADirective
menu NzIsMenuInsideDropDownToken NzIsMenuInsideDropdownToken
watermark NzWaterMarkModule NzWatermarkModule
watermark NzWaterMarkComponent NzWatermarkComponent

Deprecations

在 v21 中,以下 API 被標記為 deprecated,並將在下一個主要版本中移除。 參考相關文檔以獲取更好的替代方案。

Module API
ng-zorro-antd/collapse nz-collapse-panel[nzDisabled]
ng-zorro-antd/input textarea[nzAutosize], nz-input-group, [nz-input-group-slot]
ng-zorro-antd/upload nz-upload[nzTransformFile], NzUploadTransformFileType

更新説明:https://github.com/NG-ZORRO/ng-zorro-antd/releases/tag/21.0.0

user avatar
0 位用戶收藏了這個故事!
收藏

發佈 評論

Some HTML is okay.