微信小程序嵌入 H5 页面（web-view）

原创已于 2025-01-03 23:01:08 修改 · 3.5w 阅读

124 ·

CC 4.0 BY-SA版权

文章标签：

#json

于 2017-12-15 16:11:32 首次发布

javascript 专栏收录该内容

70 篇文章

订阅专栏

在开发微信小程序的时候，我们有时候会遇到将 H5 页面嵌入到小程序页面中的情况；微信小程序自带的 web-view 组件相当于 HTML页面中的 iframe ，方便我们在微信小程序中打开一个 H5 页面；从微信小程序基础库1.6.4开始，我们就可以在小程序内放置一个<web-view>组件来链接我们的HTML页面了。

官网描述：

承载网页的容器；会自动铺满整个小程序页面，个人类型的小程序暂不支持使用；所以使用这个组件，必须是在企业号小程序里面；

使用：

1、配置业务域名

在微信小程序后台，开发-开发管理-开发设置-业务域名 这里添加需要嵌入到小程序里面 H5 页面的合法域名（最多200个）；

2、使用组件

每个页面只能有一个 web-view组件，并且 web-view组件将默认展示在最高层级；

<web-view src="xxxxxxxxxx"></web-view>

它的属性如下：
1、原生小程序提供属性

2、uni-app提供属性

3、H5 跳转回小程序

在内嵌网页中跳回小程序，需引入JS-SDK；这里以vue项目为例：

//安装插件
npm i -S weixin-js-sdk 
//引入
import wx from 'weixin-js-sdk'

在需要返回小程序的H5页面使用下面代码：

wx.miniProgram.navigateTo({
  url: "/pages/index", //小程序地址
});

注意：

1、web-view 网页与小程序之间不支持除 JSSDK 提供的接口之外的通信；
2、在 iOS 中，若存在JSSDK接口调用无响应的情况，可在 web-view 的 src 后面加个#wechat_redirect解决；
3、避免在链接中带有中文字符，在 iOS 中会有打开白屏的问题，建议加一下 encodeURIComponent；

4、小程序和H5之间传参

小程序和H5之间互相跳转，我们如果需要传递参数的话可以通过 url 路径拼接的方式来传递参数；

url:'/page/index?id=1'

参数传递之后，下面是参数的获取：
1、微信小程序

onLoad:function(options){
	console.log(options)
}

2、H5

mounted(){
	let name = this.getQueryString('name')
	console.log(name )
},
methods:{
	//解析url获取指定参数的值
	getQueryString(name)  {
	    const reg = new RegExp('(^|&)' + name + '=([^&]*)(&|$)', 'i');
	    const search = window.location.search.split('?')[1] || '';
	    const r = search.match(reg) || [];
	    return r[2];
   }
}

当有差异化功能时就可以通过微信sdk的接口进行当前是否小程序/公众号的判断，然后进行webview新页面的开发。

/ 判断是否是小程序端
    isMiniPrograms() {
      var isMiniprogram = false;
      // 判断是否是小程序打开
      wx.miniProgram.getEnv(res => {
        console.log(res.miniprogram)
        if (res.miniprogram) {
          //在小程序中
          isMiniprogram = true;
        }
      });
      return isMiniprogram;
    }

小程序缓存隔离

如果你的公众号有使用本地缓存，用户在使用完公众号网页后又切换回小程序，也就是当用户先后打开了这两个平台，因为微信内置浏览器的问题，同域的两个网站共享了同一个状态，这样会导致内部的网站本地存储的登录状态数据混乱，显然是不行的。那就要在访问小程序之前就要对当前状态及时进行清除，我这里简单对当前状态判断进行重置状态。

function clearCache() { 
    if (navigator.userAgent.indexOf("miniProgram") >-1) {     
      if (this.getBrowserData("isWxmini") === 'false') {     
        //小程序检查到公众网页缓存，清除之前的缓存，包括首次进入小程序情况
        // 给token一个默认值
        localStorage.setItem("token", "xxx");
        document.cookie = "token=xxx";
        sessionStorage.setItem("token", "xxx");
        this.setBrowserData("isWxmini", true);
        console.log("已清除微信来的缓存");
      } 
    } else if (this.getBrowserData("isWxmini") === 'true') {
       //公众网页检查到小程序缓存，清除之前的缓存
       localStorage.setItem("token", "xxx");
       document.cookie = "token=xxx";
       sessionStorage.setItem("token", "xxx");
       this.setBrowserData("isWxmini", false);
       console.log("已清除小程序来的缓存");
   }
}


fetch(myConfig) {
   clearCache.call(this);
   数据请求...
}

因为webview和真实公众号中的页面使用的是同一个前端资源，所以就可以在页面的全局网络请求函数fetch调用之前执行clearCache.call(this)。通过userAgent是否出现miniProgram标识来判断当前是否在小程序当中，使用isWxmini标识来区分环境进行不同环境数据的清除。

uniapp中微信小程序与H5相互跳转

<!-- wx和uni的SDK --> 
<script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script>
<script src="https://gitee.com/dcloud/uni-app/raw/dev/dist/uni.webview.1.5.3.js"></script>

跳转代码

<script>
document.addEventListener('UniAppJSBridgeReady', function() { 
    document.querySelector('.btn-list').addEventListener('click', function(evt) {
        //uni.navigateBack();  
        uni.reLaunch({
          url: '/pages/index/index',
        });
    });  
});
</script>
<button class="btn-list">首页</button>

微信小程序支持cookie实现

小程序原生的 request 网络请求接口并不支持传统的 Cookie，但有时候我们现有的后端接口确于依赖 Cookie（比如服务器用户登录态），weapp-cookie这个库可用一行代码为你的小程序实现 Cookie 机制，以保证基于 cookie 的服务会话不会失效，与 web 端共用会话机制