热度:
作者:微信
收集:微信小程序学习
更新时间:2022-01-25 21:19:19
基础库 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 |
tip：网页内 iframe 的域名也需要配置到域名白名单。tip：开发者工具上，可以在 web-view 组件上通过右键 - 调试，打开 web-view 组件的调试。tip：每个页面只能有一个 web-view，web-view 会自动铺满整个页面，并覆盖其他组件。tip：web-view 网页与小程序之间不支持除 JSSDK 提供的接口之外的通信。tip：在 iOS 中，若存在JSSDK接口调用无响应的情况，可在 web-view 的 src 后面加个#wechat_redirect解决。tip：避免在链接中带有中文字符，在 iOS 中会有打开白屏的问题，建议加一下 encodeURIComponent
