diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001210111632.png b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001210111632.png
new file mode 100644
index 0000000000000000000000000000000000000000..fcb961a33b65ed24a4a0c68312df44bd02a71bcb
Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001210111632.png differ
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-overlay.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-overlay.md
index 95da98af8a3393950bb33a6a621671cacd1f33a4..4b3b45e97f5ef7c632a2060b12d1ae2aacd71661 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-overlay.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-overlay.md
@@ -10,7 +10,7 @@
| 名称 | 参数类型 | 默认值 | 描述 |
| -------- | -------- | -------- | -------- |
-| overlay | value: string,
options?: {
align?: [Alignment](ts-appendix-enums.md#alignment),
offset?: {x?: number, y?: number}
} | {
align: Alignment.Center,
offset: {0, 0}
} | 在当前组件上,增加遮罩文本。
value: 遮罩文本内容。
options: 文本定位,align设置文本相对于组件的方位,[offset](ts-universal-attributes-location.md)为文本基于自身左上角的偏移量。文本默认处于组件左上角。
两者都设置时效果重叠,文本相对于组件方位定位后再基于当前位置文本的左上角进行偏移。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
+| overlay | value: string | [CustomBuilder](../arkui-ts/ts-types.md#custombuilder8)10+,
options?: {
align?: [Alignment](ts-appendix-enums.md#alignment),
offset?: {x?: number, y?: number}
} | {
align: Alignment.Center,
offset: {0, 0}
} | 在当前组件上,增加遮罩文本。
value: 遮罩文本内容或自定义组件构造函数。
options: 文本定位,align设置文本相对于组件的方位,[offset](ts-universal-attributes-location.md)为文本基于自身左上角的偏移量。文本默认处于组件左上角。
两者都设置时效果重叠,文本相对于组件方位定位后再基于当前位置文本的左上角进行偏移。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
## 示例
@@ -39,3 +39,27 @@ struct OverlayExample {
```
![zh-cn_image_0000001205769446](figures/zh-cn_image_0000001205769446.png)
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct OverlayExample {
+ @Builder OverlayNode() {
+ Column() {
+ Image($r('app.media.img1'))
+ Text("This is overlayNode").fontSize(20).fontColor(Color.White)
+ }.width(180).height(180).alignItems(HorizontalAlign.Center)
+ }
+
+ build() {
+ Column() {
+ Image($r('app.media.img2'))
+ .overlay(this.OverlayNode(), { align: Alignment.Center })
+ .objectFit(ImageFit.Contain)
+ }.width('100%')
+ .border({ color: Color.Black, width: 2 }).padding(20)
+ }
+}
+```
+![zh-cn_image_0000001210111632](figures/zh-cn_image_0000001210111632.png)