web-view
功能描述
承载网页的容器。会自动铺满整个小程序页面,个人类型的小程序暂不支持使用。
客户端 6.7.2 版本开始,navigationStyle: custom 对 web-view 组件无效
属性说明
| 属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
|---|---|---|---|---|---|
| src | string | 否 | webview 指向网页的链接。可打开关联的公众号的文章,其它网页需登录小程序管理后台配置业务域名。 | ||
| bindmessage | eventhandler | 否 | 网页向小程序 postMessage 时,会在以下特定时机触发并收到消息:小程序后退、组件销毁、分享、复制链接( )。e.detail = { data },data 是多次 postMessage 的参数组成的数组。 | ||
| bindload | eventhandler | 否 | 网页加载成功时候触发此事件。e.detail = { src } | ||
| binderror | eventhandler | 否 | 网页加载失败的时候触发此事件。e.detail = { url, fullUrl },其中 fullUrl 为加载失败时的完整 url |
相关接口 1
web-view网页中可使用JSSDK提供的接口返回小程序页面。 支持的接口有:
| 接口名 | 说明 | 最低版本 |
|---|---|---|
| bl.miniProgram.navigateTo | 参数与小程序接口一致 | |
| bl.miniProgram.navigateBack | 参数与小程序接口一致 | |
| bl.miniProgram.switchTab | 参数与小程序接口一致 | |
| bl.miniProgram.reLaunch | 参数与小程序接口一致 | |
| bl.miniProgram.redirectTo | 参数与小程序接口一致 | |
| bl.miniProgram.postMessage | 向小程序发送消息,会在以下特定时机触发组件的 message 事件:小程序后退、组件销毁、分享、复制链接( ) | |
| bl.miniProgram.getEnv | 获取当前环境 |
示例代码
// javascript
bl.miniProgram.navigateTo({ url: "/path/to/page" });
bl.miniProgram.postMessage({ data: "foo" });
bl.miniProgram.postMessage({ data: { foo: "bar" } });
bl.miniProgram.getEnv(function (res) {
console.log(res.miniprogram);
});