文档开发者中心
我的
|

HarmonyOS 6

ArkUI

ArkUI 组件隐藏但不销毁(保留节点、不布局、不删除)三种方案

1. visibility: Hidden(推荐,完全满足需求)

  • 组件节点保留、不销毁、不触发 onDisappear
  • 占据原有布局占位,只是视觉透明看不见
  • 可响应点击事件(仍可点击隐藏区域)
收起
自动换行
深色代码主题
复制
Text("测试文字")
  .visibility(Visibility.Hidden)

枚举:

  • Visibility.Visible:显示
  • Visibility.Hidden:隐藏,占位,组件存在
  • Visibility.None:直接移除组件(不占位,销毁)

2. opacity (0) 透明隐藏(仍占位、可点击)

透明度设为 0,组件实体还在,布局不变,交互生效

收起
自动换行
深色代码主题
复制
Text("测试文字")
  .opacity(0)

区别于 visibility(Hidden):

  • opacity=0:组件渲染像素完全透明,图层还在
  • visibility=Hidden:不渲染绘制内容,性能略好

3. 搭配 hitTestBehavior 禁止点击(隐藏后屏蔽交互)

如果隐藏后不想被点击,叠加点击穿透:

收起
自动换行
深色代码主题
复制
Text("测试文字")
  .visibility(Visibility.Hidden)
  .hitTestBehavior(HitTestMode.Transparent) // 点击穿透,不响应

三者核心对比表

方式 DOM 节点保留 占用布局空间 是否可点击 适用场景
visibility(Hidden) ✅ 不移除 ✅ 占位 ✅ 默认可点击 需要固定布局、组件不销毁
opacity(0) ✅ 不移除 ✅ 占位 ✅ 默认可点击 渐变显隐动画
visibility(None) ❌ 直接移除 ❌ 不占位 ❌ 无组件 彻底销毁组件

常用封装示例:控制显隐开关

收起
自动换行
深色代码主题
复制
@State isShow: boolean = false

build() {
  Column() {
    Text("常驻隐藏组件")
      .visibility(this.isShow ? Visibility.Visible : Visibility.Hidden)
  }
}

补充说明

  1. 使用 Visibility.Hidden 时,组件不会走销毁生命周期,状态、变量、定时器全部保留;
  2. 如果想隐藏同时释放布局空间,用 Visibility.None(组件直接移除);
  3. 动画过渡显隐优先用 opacity,布局固定不动优先用 visibility(Hidden)。
点赞
收藏
1
回复
1
分享
举报
浏览80 发布于2026-07-09 08:07浙江
全部评论
最多点赞
最新发布
最早发布
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

目录 收起
1. visibility: Hidden(推荐,完全满足需求)
2. opacity (0) 透明隐藏(仍占位、可点击)
3. 搭配 hitTestBehavior 禁止点击(隐藏后屏蔽交互)
三者核心对比表
常用封装示例:控制显隐开关
补充说明
了解社区公约,与您携手共创和谐专业的开发者社区。