diff --git a/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md b/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md
index 494e6bc3c7a86e0c49c8162e23abc67895071e52..3d33972541e065887bf3c88180bca8fe3f601aa4 100644
--- a/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md
+++ b/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md
@@ -50,6 +50,7 @@
     - 模态转场设置
       - [全屏模态转场](ts-universal-attributes-modal-transition.md)
       - [半模态转场](ts-universal-attributes-sheet-transition.md)
+    - [隐私遮罩](ts-universal-attributes-obscured.md)
   - [文本通用属性](ts-universal-attributes-text-style.md)
   - 手势处理
     - [绑定手势方法](ts-gesture-settings.md)
diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/obscured.png b/zh-cn/application-dev/reference/arkui-ts/figures/obscured.png
new file mode 100644
index 0000000000000000000000000000000000000000..6cb469730fae3b5df6c5b252bb7bbc050c958fe2
Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/obscured.png differ
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-appendix-enums.md b/zh-cn/application-dev/reference/arkui-ts/ts-appendix-enums.md
index 694fd314a6a83aadad95aa532c6cd7a4ff15ef4f..735f9fb57a49c34e7fe91453c0e4b8e3117ceba4 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-appendix-enums.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-appendix-enums.md
@@ -533,7 +533,16 @@
 | MIN_FONT_SIZE_FIRST     | 设置文本高度自适应方式为以缩小字体优先。     |
 | LAYOUT_CONSTRAINT_FIRST | 设置文本高度自适应方式为以布局约束（高度）优先。 |
 
+## ObscuredReasons<sup>10+</sup>
+
+该接口支持在ArkTS卡片中使用。
+
+| 名称        | 描述                     |
+| ----------- | ------------------------ |
+| PLACEHOLDER | 显示的数据为通用占位符。 |
+
 ## TransitionEdge<sup>10+<sup>
+
 | 名称     | 描述     |
 | ------ | ------ |
 | TOP    | 窗口的上边缘 |
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-obscured.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-obscured.md
new file mode 100644
index 0000000000000000000000000000000000000000..db2af7596c44f30c33b494092f7f478ad2c8e7b0
--- /dev/null
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-obscured.md
@@ -0,0 +1,58 @@
+# 隐私遮罩
+
+用于对组件内容进行隐私遮罩处理。
+
+>  **说明：**
+>
+> 从API Version 10开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
+
+## 属性
+
+
+| 名称    | 参数类型                                     | 描述                                  |
+| -----| ------------------------------------------ | ------------------------------------ |
+| obscured | Array<[ObscuredReasons](ts-appendix-enums.md#obscuredreasons10)> | 设置组件内容的遮罩类型。<br>默认值：[]<br/>该接口支持在ArkTS卡片中使用。<br/>仅支持[Image](ts-basic-components-image.md)组件和[Text](ts-basic-components-text.md)组件的隐私遮罩处理。<br/>**说明：**<br/>如需在图片加载过程中显示隐私遮罩，需要设置Image组件的宽度和高度。 |
+
+## 示例
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct ObscuredExample {
+  build() {
+    Row() {
+      Column() {
+        Text('Text not set obscured attribute').fontSize(10).fontColor(Color.Black)
+        Text('This is an example for text obscured attribute.')
+          .fontSize(30)
+          .width('600px')
+          .fontColor(Color.Black)
+          .border({ width: 1 })
+        Text('Image not set obscured attribute').fontSize(10).fontColor(Color.Black)
+        Image($r('app.media.icon'))
+          .width('200px')
+          .height('200px')
+        Text('Text set obscured attribute').fontSize(10).fontColor(Color.Black)
+        Text('This is an example for text obscured attribute.')
+          .fontSize(30)
+          .width('600px')
+          .fontColor(Color.Black)
+          .border({ width: 1 })
+          .obscured([ObscuredReasons.PLACEHOLDER])
+        Text('Image set obscured attribute').fontSize(10).fontColor(Color.Black)
+        Image($r('app.media.icon'))
+          .width('200px')
+          .height('200px')
+          .obscured([ObscuredReasons.PLACEHOLDER])
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+![obscured](figures/obscured.png)
+