接口声明

{"name": "system.webview"}

导入模块

import webview from '@system.webview' 或 const webview = require('@system.webview')

接口定义

webview.loadUrl(OBJECT)

打开网页，标题栏样式与打开 webview 的页面的标题栏样式相同，在 webview 的 useragent 后追加内容，格式是 hap/<平台版本号>/<厂商标识> <平台应用包名>/<平台应用版本号> <应用名>/<应用版本号> (<来源信息>)。“来源信息”与 app 接口的 getInfo 方法返回结果中的 source 字段相同。

参数：

参数名	类型	必填	说明
url	String	是	要加载的页面 url
allowthirdpartycookies 1030+	Boolean	否	是否支持第三方 cookies，设置为 true 时开启接收第三方 cookies。 注意：allowthirdpartycookies只支持安卓 5.0 及以上系统。5.0 以下默认为 true
showloadingdialog 1070+	Boolean	否	是否展示默认加载框，默认值是 false

示例：

webview.loadUrl({
  url: 'http://www.example.com'
})

WebView内部API

在 webview 打开的网页中可以使用的 api

system.go(path)

跳转到当前应用的指定页面

参数：

参数名	类型	必填	说明
path	String	是	要跳转的页面，例:/detail?param1=value1特殊的,如果path的值是"/",则跳转到path为"/"的页,没有则跳转到首页

示例：

system.go('/detail?param1=value1')

在 WebView 通过 deeplink 打开快应用

在 webview 打开的网页中，支持通过 deeplink 打开快应用，deeplink 支持的格式参见 deeplink

示例：

location.href='hap://app/org.hapjs.demo.sample/page?key=value'
location.href='http://hapjs.org/app/org.hapjs.demo.sample/page?key=value'
location.href='https://hapjs.org/app/org.hapjs.demo.sample/page?key=value'

后台运行限制

禁止使用。后台运行详细用法参见 后台运行脚本。