设置组件的遮罩文本。
说明:
从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
&

本文介绍了自APIVersion7开始支持的组件遮罩文本功能,如何使用overlay方法在组件上添加浮层,并特别提到了在ArkTS和卡片能力方面的应用。同时,文章还推荐了针对鸿蒙开发者的学习资源,包括核心技术点和开发教程。
最低0.47元/天 解锁文章
1797

被折叠的 条评论
为什么被折叠?



