在开发微信小程序的时候,我们有时候会遇到将 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 端共用会话机制