visibilitychange监听页面可见性改变事件

参考文章1
参考文章2
参考文章3

一、功能需求

项目是企业微信内打开的webview页面,用户进入指定页面时,会调用企微提供的,持续监听用户位置变化的API,当用户将企微切后台一定时间后重新回到该页面,API监听不生效(方法并未销毁,只是不生效),查询官方文档,该企微API不支持后台监听,切后台就会被打断,故代码逻辑需改为,判断用户离开页面时,主动销毁该监听,判断用户进入页面时,重新创建监听,而判断用户是否离开或回到页面,可使用visibilitychange事件来判断页面的可见性。

二、visibilitychange事件

在H5中,文档对象(document对象)具有一个visibilityState属性,该属性表示当前文档对象的可见性状态,页面被隐藏或显示时,document.visibilityState属性就会发生变化,继而触发visibilitychange事件

visibilityState属性可能的取值:

  • visible 当前页面是非最小化窗口的屏幕最上层的页面

  • hidden 当前页面不可见处于后台或被最小化

  • prerender 当前页面处于预渲染状态,不可见

  • unloaded 当前页面正被销毁

简单范例:

javascript 复制代码
document.addEventListener('visibilitychange', function () {
  // 用户离开当前页面
  if (document.visibilityState === 'hidden') {
    document.title = '页面不可见';
  }

  // 用户打开或回到页面
  if (document.visibilityState === 'visible') {
    document.title = '页面可见';
  }
});

三、项目代码实例

javascript 复制代码
mounted(){
	this.bindEvent()
},
methods:{
	bindEvent(){
      // 开启监听页面是否可见事件
      const _this = this;
      // 判断当前浏览器支持何种类型的hidden
      let visProp = this.getHiddenProp();
      console.log('visProp-',visProp);
      if (visProp && typeof document.addEventListener !== 'undefined') {
        console.log('可设置监听事件');
        // 部分浏览器也需要对这个事件加前缀以便识别。
        let evtname = visProp.replace(/[H|h]idden/, '') + 'visibilitychange';
        document.addEventListener(evtname, handleVisibilityChange, false);
        _this.$once("hook:beforeDestroy",()=>{
          console.log('销毁监听事件')
          document.removeEventListener(evtname, handleVisibilityChange)
        })
      }else{
        console.error('当前浏览器不兼容!')
      }
      // 页面可见性变化时的回调函数
      async function handleVisibilityChange(){
        console.log('document.visibilityState-', document.visibilityState);
        if (document.visibilityState == "hidden") {
          try{
            await stopGetCoordinateLongTime();// 息屏时主动关闭持续监听位置变化
          }catch(e){
            console.error('息屏时关闭持续定位/罗盘有点问题,' + err);
          }
        } else{
          // 开启持续监听获取定位
          _this.getPositionByEnvi();
        }
      }
      
    },
    // 兼容性判断,判断当前浏览器支持何种类型的hidden
    getHiddenProp(){
      let prefixes = ['webkit','moz','ms','o'];
      // 如果hidden 属性是原生支持的,我们就直接返回
      if ('hidden' in document) 
        return 'hidden';
      
      // 其他的情况就循环现有的浏览器前缀,拼接我们所需要的属性 
      for (let i = 0; i < prefixes.length; i++){
        // 如果当前的拼接的前缀在 document对象中存在 返回即可
        if ((prefixes[i] + 'Hidden') in document) {
          return prefixes[i] + 'Hidden';
        }  
      }
      // 其他的情况 直接返回null
      return null;
    },}
相关推荐
袋鼠云数栈UED团队20 小时前
基于 Lexical 实现变量输入编辑器
前端·javascript·架构
亦妤20 小时前
JS执行机制、作用域及作用域链
javascript
SuperEugene1 天前
表单最佳实践:从 v-model 到自定义表单组件(含校验)
前端·javascript·vue.js
不会敲代码11 天前
React性能优化:深入理解useMemo和useCallback
前端·javascript·react.js
YukiMori231 天前
一个有趣的原型继承实验:为什么“男人也会生孩子”?从对象赋值到构造函数继承的完整推演
前端·javascript
摸鱼的春哥1 天前
惊!黑客靠AI把墨西哥政府打穿了,海量数据被黑
前端·javascript·后端
小兵张健1 天前
Playwright MCP 截图标注方案调研(推荐方案1)
前端·javascript·github
我叫黑大帅1 天前
Vue3和Uniapp的爱恨情仇:小白也能懂的跨端秘籍
前端·javascript·vue.js
None3211 天前
【NestJs】使用Winston+ELK分布式链路追踪日志采集
javascript·node.js
Qinana1 天前
从代码到智能体:MCP 协议如何重塑 AI Agent 的边界
前端·javascript·mcp