热度:
作者:微信
收集:微信小程序学习
更新时间:2022-01-25 21:19:18
基础库 1.6.4 开始支持，低版本需做兼容处理。
承载网页的容器。会自动铺满整个小程序页面，个人类型的小程序暂不支持使用。
客户端 6.7.2 版本开始，navigationStyle: custom 对 web-view 组件无效
小程序插件中不能使用。
| 属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
|---|---|---|---|---|---|
| src | string | 否 | webview 指向网页的链接。可打开关联的公众号的文章，其它网页需登录小程序管理后台配置业务域名。 | 1.6.4 | |
| bindmessage | eventhandler | 否 | 网页向小程序 postMessage 时，会在特定时机（小程序后退、组件销毁、分享）触发并收到消息。e.detail = { data }，data是多次 postMessage 的参数组成的数组 | 1.6.4 | |
| bindload | eventhandler | 否 | 网页加载成功时候触发此事件。e.detail = { src } | 1.6.4 | |
| binderror | eventhandler | 否 | 网页加载失败的时候触发此事件。e.detail = { src } | 1.6.4 |
web-view网页中可使用JSSDK 1.3.2提供的接口返回小程序页面。
支持的接口有：
| 接口名 | 说明 | 最低版本 |
|---|---|---|
| wx.miniProgram.navigateTo | 参数与小程序接口一致 | 1.6.4 |
| wx.miniProgram.navigateBack | 参数与小程序接口一致 | 1.6.4 |
| wx.miniProgram.switchTab | 参数与小程序接口一致 | 1.6.5 |
| wx.miniProgram.reLaunch | 参数与小程序接口一致 | 1.6.5 |
| wx.miniProgram.redirectTo | 参数与小程序接口一致 | 1.6.5 |
| wx.miniProgram.postMessage | 向小程序发送消息，会在特定时机（小程序后退、组件销毁、分享）触发组件的message事件 | 1.7.1 |
| wx.miniProgram.getEnv | 获取当前环境 | 1.7.1 |
// web-view下的页面内
function ready() {
console.log(window.__wxjs_environment === 'miniprogram') // true
}
if (!window.WeixinJSBridge || !WeixinJSBridge.invoke) {
document.addEventListener('WeixinJSBridgeReady', ready, false)
} else {
ready()
}
// 或者
wx.miniProgram.getEnv(function(res) {
console.log(res.miniprogram) // true
})
从微信7.0.0开始，可以通过判断userAgent中包含miniProgram字样来判断小程序web-view环境。
从微信7.0.3开始，webview内可以通过判断下面的方式判断小程序是否在前台：
WeixinJSBridge.on('onPageStateChange', function(res) {
console.log('res is active', res.active)
})
