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)