第三方应用开发 客户端API JS-SDK 界面 界面操作
界面操作

目录

  • 监听页面返回事件
  • 隐藏右上角菜单接口
  • 显示右上角菜单接口
  • 关闭当前网页窗口接口
  • 批量隐藏功能按钮接口
  • 批量显示功能按钮接口
  • 隐藏所有非基础按钮接口
  • 显示所有功能按钮接口
  • 打开系统默认浏览器
  • 用户截屏事件
  • 监听页面返回事件

    接口说明:该接口可在用户返回上个页面时,回调开发者注册的函数,处理业务需要的逻辑(如确认或重定向到指定的页面)

    wx.onHistoryBack(function(){
        return confirm('确定要放弃当前页面的修改?')
    });
    响应函数须返回布尔值false或true。false表示中断此次返回操作,否则继续执行返回操作
    当页面左上角没有关闭按钮(即已是顶级页面),不产生该事件,强制执行返回
    iOS系统使用手势返回时,不产生该事件,强制执行返回
    此接口在企业微信iOS/Android端2.2.0及以后版本支持,PC/Mac端在2.4.5版本及以后版本支持

     

    隐藏右上角菜单接口

    wx.hideOptionMenu();

    显示右上角菜单接口

    wx.showOptionMenu();

    关闭当前网页窗口接口

    wx.closeWindow();

    批量隐藏功能按钮接口

    wx.hideMenuItems({
        menuList: [] // 要隐藏的菜单项
    });

     

    批量显示功能按钮接口

    wx.showMenuItems({
        menuList: [] // 要显示的菜单项
    });
    菜单项列表见附录3

    隐藏所有非基础按钮接口

    wx.hideAllNonBaseMenuItem();

    显示所有功能按钮接口

    wx.showAllNonBaseMenuItem();

     

    打开系统默认浏览器

    接口说明:该接口可在PC版企业微信用系统浏览器打开指定的URL,以获得更好的体验。指定的URL支持oauth2标准,从而实现在系统浏览器内免登录的效果。

    wx.invoke('openDefaultBrowser', {
            'url': "https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&agentid=AGENTID&state=STATE#wechat_redirect", // 在默认浏览器打开redirect_uri,并附加code参数;也可以直接指定要打开的url,此时不会附带上code参数。
            }, function(res){
            if(res.err_msg != "openDefaultBrowser:ok"){
                //错误处理
                    }
            }); 
    
    此接口仅在企业微信PC版2.3及以后版本支持。其中url支持oauth2链接,具体参考“企业自建应用网页授权登录”或"第三方应用网页授权登录"。

     

    用户截屏事件

    监听用户主动截屏事件,用户使用系统截屏按键截屏时触发此事件

    用户截屏事件接口在企业微信2.5.0版本及以上支持,仅andriod及ios端支持。
    wx.onUserCaptureScreen(function(res) {
        console.log('用户截屏了')
    })
    上一篇
    分享接口
    下一篇
    企业微信扫一扫