首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >专栏 >HarmonyOS实战:实现任意拖动的应用悬浮窗口

HarmonyOS实战:实现任意拖动的应用悬浮窗口

原创
作者头像
IT小码哥
发布2025-05-22 13:16:47
发布2025-05-22 13:16:47
28100
代码可运行
举报
文章被收录于专栏:HarmonyOSHarmonyOS
运行总次数:0
代码可运行

前言

为了增加应用程序功能的丰富性和便利性,很多应用都会提供一个悬浮窗口实现多页面显示。特别是一些性能检测工具,比如 dokit 。在鸿蒙上怎么实现类似的全局悬浮窗口呢?阅读完本篇文章你将学会在鸿蒙上如何实现这一功能。

实现效果

需求分析

要想实现全局悬浮窗口,必须满足以下几个要求:

  1. 窗口可以悬浮在任意页面。
  2. 窗口可以跟随手势拖动。
  3. 边界处理。

技术实现

在 ArkUI 中,页面只有 Window 和 View 两种组成。View 通常都是显示在 Window 中,如果要想实现一个可以在任意页面都能停留显示的悬浮窗,只能通过 window 来实现。

  1. 通过 windowState 调用 createSubWIndow 来创建一个子 Window。
代码语言:javascript
代码运行次数:0
运行
复制
 this.windowState.createSubWindow("subWindow", (err: BusinessError, window) => {
     

    })

2. 对于 windowState 的获取,一般都在 EntryAbility 中的 onWindowStateCreate 中提供,如果不想通过传递参数的方式获取 windowStage,系统也提供了工具类可以在任意地方获取。

代码语言:javascript
代码运行次数:0
运行
复制
//存储windowStage
WindowManager.setWindowStage(windowStage);
//获取windowstage
 this.windowState = WindowManager.getWindowStage()

3. 初始化 Window。url 为 window 页面的路径。

代码语言:javascript
代码运行次数:0
运行
复制
     window.setWindowLayoutFullScreen(false) //设置window是否全屏显示
      window.setUIContent(url, (error) => {
        window.showWindow((error) => {
          window.setWindowBackgroundColor("#00000000") //设置window背景色
        })

      })

      window.resize(this.size, this.size)//设置window大小
      window.moveWindowTo(this.locationX, this.locationY) //设置window的初始位置

4. 手势移动,通过调研 PanGesture()的 onActionUpdate 方法不断更新 window 的位置。

代码语言:javascript
代码运行次数:0
运行
复制
 .gesture(GestureGroup(
      GestureMode.Exclusive,
      PanGesture().onActionUpdate((event)=>{
        this.currentWindow?.moveWindowTo(event.offsetX,event.offsetY)
      })
    ))

5. 边界处理,计算最小移动范围和最大移动范围。确保 window 不会移出当前页面。

代码语言:javascript
代码运行次数:0
运行
复制
 this.locationX = Math.min(Math.max(this.locationX + x, this.minX), this.maxX)
 this.locationY = Math.min(Math.max(this.locationY + y, this.minY), this.maxY)

6. window 销毁。当退出应用时,需要将 window 关闭,调用 window 的 destroyWindow 方法销毁 window。

代码语言:javascript
代码运行次数:0
运行
复制
 this.contentWindow.destroyWindow(() => {
        this.contentWindow = undefined
      })

总结

通过 window 不仅能实现全局悬浮窗,还可以实现自定义弹窗,Poupwindow,toast 等一系列弹窗。使用 window 的好处在于可以彻底和当前页面分离,不依赖页面存在。可以实现在任意地方弹窗。快动手试试吧!

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 前言
  • 实现效果
  • 需求分析
  • 技术实现
  • 总结
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档