refactor(module:pipe): deprecated nz-safe-null pipe (#8026)

NG-ZORRO · Nov 14, 2023 · d14869e · d14869e
1 parent 0a312e3
commit d14869e
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 0 deletions.
diff --git a/components/pipes/demo/safe-null.md b/components/pipes/demo/safe-null.md
@@ -9,7 +9,18 @@ title:
 
 转换 Null 和 Undefined 为指定字符串
 
+警告：在 `v17.0.0` 中被弃用，请使用空置合并运算符（??）替代，例如：
+
+```
+{{ value ?? '-' }}
+```
+
 ## en-US
 
 Convert Null and Undefined to the specified string
 
+WARNING: Deprecated in `v17.0.0`, please use the nullish coalescing operator (??) instead, eg:
+
+```
+{{ value ?? '-' }}
+```
diff --git a/components/pipes/nz-safe-null.pipe.ts b/components/pipes/nz-safe-null.pipe.ts
@@ -7,6 +7,9 @@ import { Pipe, PipeTransform } from '@angular/core';
 
 import { isNil } from 'ng-zorro-antd/core/util';
 
+/**
+ * @deprecated v17.0.0 - Use Nullish coalescing operator (??) instead of `NzSafeNullPipe`.
+ */
 @Pipe({
   name: 'nzSafeNull'
 })
-Original file line number
+Diff line change
@@ Expand Up / @@ -7,6 +7,9 @@ import { Pipe, PipeTransform } from '@angular/core'; @@
     import { isNil } from 'ng-zorro-antd/core/util';
+    /**
+     * @deprecated v17.0.0 - Use Nullish coalescing operator (??) instead of `NzSafeNullPipe`.
+     */
     @Pipe({
       name: 'nzSafeNull'
     })
@@ Expand Down @@