logo
积分中心
鸿蒙UI开发——隐私遮罩效果
头像 蓝亭书序 2026-11-18 14:10:07    发布
0 浏览 0 收藏

1、概 述

如果我们希望对某些文字或图片做隐私遮罩处理,ArkUI为组件提供了一个属性可以方便的实现此效果,效果类似如下:

图片

2、具体使用

我们在实现组件时,可以为组件添加obscured属性,用于为该属性设置隐私遮罩,接口定义如下:


// 设置组件内容的遮罩类型。
obscured(reasons: Array<ObscuredReasons>)


入参ObscuredReasons是一个枚举,目前只有一个值,如下:


PLACEHOLDER // 显示的数据为通用占位符。


需要注意:

  • 目前支持的组件类型只有:Text文本组件、Image图片显示组件。
  • 在为Image组件设置隐私遮罩时,最好设置一个默认宽高,因为如果图片是异步加载的,在图片加载完成前,如果没有默认宽高,会导致遮罩没有宽高信息。
  • 如果Text组件设置了属性字符串,则隐私遮罩不生效(后续会有例子介绍)。


3、示例

👉🏻 step1:我们创建一个基本文本组件和图片显示组件,代码如下:


@Entry
@Component
struct ObscuredExample {
  build() {
    Row() {
      Column() {
        Text('欢迎加入【Harmony自习室】')
          .fontSize(30)
          .width(300)
          .fontColor(Color.Black)
          .border({ width: 1 })
        Image($r('app.media.send_heart'))
          .width('200px')
          .height('200px')
      }
      .width('100%')
    }
    .height('100%')
  }
}


效果如下:

图片

👉🏻 step2:我们为刚刚创建的文本组件与图片组件添加隐私遮罩(12、16行)


@Entry
@Component
struct ObscuredExample {
  build() {
    Row() {
      Column() {
        Text('欢迎加入【Harmony自习室】')
          .fontSize(30)
          .width(300)
          .fontColor(Color.Black)
          .border({ width: 1 })
          .obscured([ObscuredReasons.PLACEHOLDER])
        Image($r('app.media.send_heart'))
          .width('200px')
          .height('200px')
          .obscured([ObscuredReasons.PLACEHOLDER])
      }
      .width('100%')
    }
    .height('100%')
  }
}


效果如下:

图片


如果我们为Text组件设置了属性字符串,将不会生效隐私遮罩,代码如下:


@Entry
@Component
struct ObscuredExample {
  fontStyle1: StyledString = new StyledString("欢迎加入【Harmony自习室】");
  controller1: TextController = new TextController();
  async onPageShow() {
    this.controller1.setStyledString(this.fontStyle1)
  }
  build() {
    Row() {
      Column() {
        // 显示属性字符串
        Text(undefined, { controller: this.controller1 })
          .obscured([ObscuredReasons.PLACEHOLDER])
      }
      .width('100%')
    }
    .height('100%')
  }
}


效果如下:

图片


©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255