1# 浮层 2 3设置组件的遮罩文本。 4 5> **说明：** 6> 7> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 8 9## 属性 10 11| 名称 | 参数类型 | 默认值 | 描述 | 12| -------- | -------- | -------- | -------- | 13| overlay | value: string,<br/>options?: {<br/>align?: [Alignment](ts-appendix-enums.md#alignment), <br/>offset?: {x?: number, y?: number}<br/>} | {<br/>align: Alignment.Center,<br/>offset: {0, 0}<br/>} | 在当前组件上，增加遮罩文本。<br/> value: 遮罩文本内容。<br/>options: 文本定位，align设置文本相对于组件的方位，[offset](ts-universal-attributes-location.md)为文本基于自身左上角的偏移量。文本默认处于组件左上角。<br>两者都设置时效果重叠，文本相对于组件方位定位后再基于当前位置文本的左上角进行偏移。<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 | 14 15## 示例 16 17```ts 18// xxx.ets 19@Entry 20@Component 21struct OverlayExample { 22 build() { 23 Column() { 24 Column() { 25 Text('floating layer') 26 .fontSize(12).fontColor(0xCCCCCC).maxLines(1) 27 Column() { 28 Image($r('app.media.img')) 29 .width(240).height(240) 30 .overlay("Winter is a beautiful season, especially when it snows.", { 31 align: Alignment.Bottom, 32 offset: { x: 0, y: -15 } 33 }) 34 }.border({ color: Color.Black, width: 2 }) 35 }.width('100%') 36 }.padding({ top: 20 }) 37 } 38} 39``` 40 41 42
