設置組件的遮罩文本。

說明：

從API Version 7開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。

overlay

overlay(value: string | CustomBuilder, options?: { align?: Alignment; offset?: { x?: number; y?: number } })

在當前組件上，增加遮罩文本或者疊加自定義組件作為該組件的浮層。

卡片能力：?從API version 9開始，該接口支持在ArkTS卡片中使用。

系統能力：?SystemCapability.ArkUI.ArkUI.Full

參數：

參數名	類型	必填	說明
value	string?|?CustomBuilder10+	是	遮罩文本內容或自定義組件構造函數。 說明： 自定義組件作為浮層時，不支持鍵盤走焦到自定義組件中。
options	?{ align?:?Alignment,? offset?:?{x?:?number, y?:?number} }	否	浮層的定位。 -?align：設置浮層相對于組件的方位。 -?offset：設置浮層基于自身左上角的偏移量。浮層默認處于組件左上角。 說明： 兩者都設置時效果重疊，浮層相對于組件方位定位后再基于當前位置的左上角進行偏移。

示例

示例1

// xxx.ets
@Entry
@Component
struct OverlayExample {build() {Column() {Column() {Text('floating layer').fontSize(12).fontColor(0xCCCCCC).maxLines(1)Column() {Image($r('app.media.img')).width(240).height(240).overlay("Winter is a beautiful season, especially when it snows.", {align: Alignment.Bottom,offset: { x: 0, y: -15 }})}.border({ color: Color.Black, width: 2 })}.width('100%')}.padding({ top: 20 })}
}

示例2

// 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)}
}

最后，有很多小伙伴不知道學習哪些鴻蒙開發技術？不知道需要重點掌握哪些鴻蒙應用開發知識點？而且學習時頻繁踩坑，最終浪費大量時間。所以有一份實用的鴻蒙（Harmony NEXT）資料用來跟著學習是非常有必要的。?

這份鴻蒙（Harmony NEXT）資料包含了鴻蒙開發必掌握的核心知識要點，內容包含了（ArkTS、ArkUI開發組件、Stage模型、多端部署、分布式應用開發、音頻、視頻、WebGL、OpenHarmony多媒體技術、Napi組件、OpenHarmony內核、Harmony南向開發、鴻蒙項目實戰等等）鴻蒙（Harmony NEXT）技術知識點。

希望這一份鴻蒙學習資料能夠給大家帶來幫助，有需要的小伙伴自行領取，限時開源，先到先得~無套路領取！！

?獲取這份完整版高清學習路線，請點擊→純血版全套鴻蒙HarmonyOS學習資料

鴻蒙（Harmony NEXT）最新學習路線

• ?HarmonOS基礎技能

• HarmonOS就業必備技能?
• ?HarmonOS多媒體技術

• 鴻蒙NaPi組件進階

• HarmonOS高級技能

• 初識HarmonOS內核?
• 實戰就業級設備開發

有了路線圖，怎么能沒有學習資料呢，小編也準備了一份聯合鴻蒙官方發布筆記整理收納的一套系統性的鴻蒙（OpenHarmony ）學習手冊（共計1236頁）與鴻蒙（OpenHarmony ）開發入門教學視頻，內容包含：ArkTS、ArkUI、Web開發、應用模型、資源分類…等知識點。

獲取以上完整版高清學習路線，請點擊→純血版全套鴻蒙HarmonyOS學習資料

《鴻蒙 (OpenHarmony)開發入門教學視頻》

《鴻蒙生態應用開發V2.0白皮書》

《鴻蒙 (OpenHarmony)開發基礎到實戰手冊》

OpenHarmony北向、南向開發環境搭建

?《鴻蒙開發基礎》

• ArkTS語言
• 安裝DevEco Studio
• 運用你的第一個ArkTS應用
• ArkUI聲明式UI開發
• .……

?《鴻蒙開發進階》

• Stage模型入門
• 網絡管理
• 數據管理
• 電話服務
• 分布式應用開發
• 通知與窗口管理
• 多媒體技術
• 安全技能
• 任務管理
• WebGL
• 國際化開發
• 應用測試
• DFX面向未來設計
• 鴻蒙系統移植和裁剪定制
• ……

《鴻蒙進階實戰》

• ArkTS實踐
• UIAbility應用
• 網絡案例
• ……

?獲取以上完整鴻蒙HarmonyOS學習資料，請點擊→純血版全套鴻蒙HarmonyOS學習資料

總結

總的來說，華為鴻蒙不再兼容安卓，對中年程序員來說是一個挑戰，也是一個機會。只有積極應對變化，不斷學習和提升自己，他們才能在這個變革的時代中立于不敗之地。?