微信小程序内联h5页面——webview组件

前言
  • 官方文档
  • web-view是小程序提供的一个可以直连h5页面的组件,只要传递一个h5页面的地址,就可以在小程序里直接打开预览该h5页面。
  • 如果已有移动端h5版本的模块,要开发小程序版本,使用web-view组件做直连就会非常方便。
准备工作
  • 首先要登录小程序管理后台,把web-view直连的h5页面地添加到配置域名白名单中。
  • 比如我想要小程序直连地址为https://m.lechebang.cn/paint/index的页面,那就应该把https://m.lechebang.cn添加到webview 业务域名白名单中(注意不是request的域名白名单)。配置完成后,在微信开发者工具配置详情可以看到,例如下图:
    image
具体实现
  • 使用web-view组件时,最好在小程序上单独配置一个页面路由,比如:pages/webview/index。该页面只有一个组件就是web-view,link就是对应的h5页面地址。域名配置完成后,进入小程序pages/webview/index路径,页面就会打开web-view从而直连link对应的h5页面了。
  • bindmessage用于监听web-view的h5页面向小程序发送信息的,对应的处理函数就是在小程序里自己自定义的getMessage。这是h5页面向小程序通信的唯一手段,后面会再做介绍
  • web-view目前只有src和bindmessage两个属性。
<web-view src="{{link}}" bindmessage="getMessage"></web-view>
调试
  • 在微信开发者中,打开一个web-view页面之后,单击鼠标右键会出现一个"调试"按钮,点击会弹出另一个调试窗口。
  • h5页面的代码以及调取接口的信息会在新的调试窗口里展示,包括h5页面的debug断点也要在新的调试窗口里添加,该web-view关闭后对应的调试窗口也跟着关闭。


    image
h5页面与小程序之间通信
  • 首先,在h5页面要引入微信的JSSDK文件,引入完成后可以调用wx.miniProgram暴露的一些接口。
<!-- html -->
<script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.3.2.js"></script>
  • 在h5页面,可以通过window.__wxjs_environment属性来判断当前是否在小程序的web-view环境中,
    也可以调用wx.miniProgram.getEnv接口来判断是否在web-view环境。
wx.miniProgram.getEnv(function(res) {
  console.log(res.miniprogram) // true
})
  • 确认在web-view环境之后,可以调用wx.miniProgram.postMessage(data{...})接口来向小程序传递数据,调用后会在小程序触发bindmessage的监听。
  • wx.miniProgram还有其他一些接口,比如wx.miniProgram.navigateTo({url: '...'})就可以直接从当前web-view跳转到小程序的其他页面。
  • 而小程序向h5通信,就只能刚打开web-view时,把参数从url上带过去。
限制
  • 个人类型与海外类型的小程序暂不支持使用
  • 基础库版本需要1.6.4及以上
  • 使用web-view会覆盖掉其他组件,并充满屏幕,所以只能单独使用
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,117评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,328评论 1 293
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,839评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,007评论 0 206
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,384评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,629评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,880评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,593评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,313评论 1 243
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,575评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,066评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,392评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,052评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,082评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,844评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,662评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,575评论 2 270