web-view

更新时间：2024-09-18 14:46:35

基础库1.2.0开始支持,低版本需做兼容处理

开发者工具1.22.0开始支持

承载网页的容器。会自动铺满整个小程序页面

属性

属性	类型	必填	说明
src	string	否	webview 指向网页的链接

网页中使用小程序能力

网页中可以使用注入的 ks 对象调用一些 api。sdk 由小程序框架在每个页面完成注入，开发者无需手动引入 js 文件。

路由

路由相关 api 和小程序 api 的使用方式基本保持一致。其中 url 参数只能使用绝对路径，无法使用相对路径。

api	说明	示例
navigateTo	新开一个页面，打开小程序页面	ks.navigateTo({url:'pages/index/index'})
redirectTo	打开小程序页面，替换现有页面	ks.redirectTo({url:'pages/index/index'})
navigateBack	关闭当前页面，返回上一个页面	ks.navigateBack()

环境判断

从快手9.3.10开始，可以通过判断 userAgent 中包含 miniProgram 字样来判断小程序 web-view 环境。

代码示例

console.log(window.navigator.userAgent);

//"Mozilla/5.0... miniProgram/1.91.0..." 携带了 miniProgram字样和小程序基础库的版本号

Bug & Tip

Tip：webview url域名也需要配置到域名白名单

扫码体验

示例代码