字节跳动小程序开发组件文档 web-view
2020-07-13 11:17 更新
web-view 组件是一个可以用来承载网页的容器,会自动铺满整个页面。
属性名 | 类型 | 默认值 | 说明 | 最低版本 |
src | String | N/A | webview 指向网页的链接。可打开关联的头条号的文章,其它网页需登录字节小程序开发者平台配置业务域名。 | 1.0.0 |
bindmessage | EventHandler | N/A | 网页向小程序 postMessage 时,会在特定时机(小程序后退、组件销毁、分享)触发并收到消息。 | 1.17.0 |
bindload | EventHandler | N/A | 当网页加载完成时触发当消息。 | 1.28.0 |
binderror | EventHandler | N/A | 当网页加载失败时触发的消息。 | 1.0.0 |
progressbar-color | String | #51a0d8 | webview 的进度条颜色。 | 1.0.0 |
示例
<web-view src="http://some-domain/some/path" rel="external nofollow" ></web-view>
API
<web-view /> 网页中可使用JSSDK提供的接口返回小程序页面。支持的接口有:
接口名 | 说明 |
---|---|
tt.miniProgram.redirectTo | 参数与小程序接口一致。 |
tt.miniProgram.navigateTo | 参数与小程序接口一致。 |
tt.miniProgram.switchTab | 参数与小程序接口一致。 |
tt.miniProgram.reLaunch | 参数与小程序接口一致。 |
tt.miniProgram.navigateBack | 参数与小程序接口一致。 |
tt.miniProgram.postMessage | 向小程序发送消息,会在特定时机(小程序后退、组件销毁、分享)触发组件的 message 事件。 |
redirectTo、navigateTo 等页面跳转的 api 只支持 url 为 / 开始的绝对路径
Bug & Tip
web-view 组件的 userAgent 的特征值是 ToutiaoMicroApp,可以通过 navigator.userAgent.toLowerCase().includes('toutiaomicroapp') 来判断页面环境是否为字节小程序。
以上内容是否对您有帮助:
更多建议: