承载网页的容器。
此组件会自动铺满整个页面,每个页面只允许添加一个web-view组件。
起始版本:1.0.4
属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
src | string | - | 是 | webview 指向网页的链接。 |
bindload | eventhandler | - | 否 | 网页加载成功时候触发此事件。e.detail = { src }。 |
binderror | eventhandler | - | 否 | 网页加载失败的时候触发此事件。e.detail = { src }。 |
bindmessage | eventhandler | - | 否 | 网页通过 postMessage 方法向元服务发送消息,会在特定时机(如:网页后退、组件销毁)触发并收到。e.detail = { data },data 是多次 postMessage 的参数组成的数组。 |
hxml文件:
<view class="index">
<web-view class="webview" src="{{url}}" binderror="onError" bindload="onWebviewLoad" bindmessage="onWebviewMessage">
</web-view>
</view> js 代码:
Page({
data: {
url: ''
},
extraLine: [],
onLoad(options) {
this.setData({
url: options.webUrl,
});
},
onWebviewMessage: function(e) {
console.log('[DBG][webview test page][onMessage]:', e);
},
onError: function(e) {
console.log('[DBG][webview test page][onError]:', e);
},
onWebviewLoad: function(e) {
console.log('[DBG][webview test page][onWebviewLoad]:', e);
}
}) has.ascfweb.navigateTo(Object object)
保留当前页面,跳转到应用内的某个页面。但是不能跳转到 tabBar 页面。使用 has.ascfweb.navigateBack 可以返回到原页面。
起始版本:1.0.4
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 是 | 需要跳转的应用内非tabBar的页面路径(在app.json中定义的代码包路径),路径后可以带参数。参数与路径之间用?分隔,参数与键值用=相连,多个参数用&分隔。 支持格式:(假设app.json中定义了页面: "page/path/path")
|
success | function | 否 | 接口调用成功的回调函数。 |
fail | function | 否 | 接口调用失败的回调函数。 |
complete | function | 否 | 接口调用结束的回调函数。(调用成功、失败都会执行) |
示例:
has.ascfweb.navigateTo({
url: '/page/path/path?key=1',
success: function(res) {
},
fail: function(err) {
},
complete(res) {
}
}) has.ascfweb.navigateBack(Object object)
关闭当前页面,返回上一页面或多级页面。
起始版本:1.0.4
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
delta | number | 1 | 否 | 返回的页面数,如果 delta 大于现有页面数,则返回到首页。 |
success | function | - | 否 | 接口调用成功的回调函数。 |
fail | function | - | 否 | 接口调用失败的回调函数。 |
complete | function | - | 否 | 接口调用结束的回调函数(调用成功、失败都会执行)。 |
示例:
// 注意:调用 navigateTo 跳转时,调用该方法的页面会被加入堆栈,而 redirectTo 方法则不会。见下方示例代码
// 此处是A页面
has.ascfweb.navigateTo({
url: 'B?id=1'
})
// 此处是B页面
has.ascfweb.navigateTo({
url: 'C?id=1'
})
// 在C页面内 navigateBack,将返回A页面
has.ascfweb.navigateBack({
delta: 2
}) has.ascfweb.reLaunch(Object object)
关闭所有页面,打开到应用内的某个页面。
起始版本:1.0.4
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 是 | 需要跳转的应用内页面路径(在app.json中定义的代码包路径),非tabBar的页面路径后可以带参数。参数与路径之间用?分隔,参数与键值用=相连,多个参数用&分隔。 支持格式:(假设app.json中定义了页面: "page/path/path")
|
success | function | 否 | 接口调用成功的回调函数。 |
fail | function | 否 | 接口调用失败的回调函数。 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行)。 |
示例:
has.ascfweb.reLaunch({
url: 'test?id=1'
})
// options内含有路径后携带参数
Page({
onLoad (option) {
console.log(option.query)
}
}) has.ascfweb.switchTab(Object object)
如果应用定义了多标签(tab),即客户端窗口的底部或顶部有可切换页面的标签(tab),那么可以通过此接口跳转到 tabBar 页面,同时关闭其他所有非 tabBar 页面。
起始版本:1.0.4
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 是 | 需要跳转的tabBar页面路径(需要在app.json的tabbar字段定义的页面),路径后不能带参数。 支持格式:(假设app.json的tabbar字段定义了页面: "page/tab1/tab1")
|
success | function | 否 | 接口调用成功的回调函数。 |
fail | function | 否 | 接口调用失败的回调函数。 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行)。 |
示例:
// app.json{
"tabBar": {
"list": [{
"pagePath": "index",
"text": "首页"
},{
"pagePath": "other",
"text": "其他"
}]
}} has.ascfweb.switchTab({
url: '/index'
}) has.ascfweb.redirectTo(Object object)
关闭当前页面,跳转到应用内的某个页面,但是不允许跳转到 tabBar 页面。
起始版本:1.0.4
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 是 | 需要跳转的应用内非tabBar的页面路径(在app.json中定义的代码包路径),路径后可以带参数。参数与路径之间用?分隔,参数与键值用=相连,多个参数用&分隔。 支持格式:(假设app.json中定义了页面: "page/path/path")
|
success | function | 否 | 接口调用成功的回调函数。 |
fail | function | 否 | 接口调用失败的回调函数。 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行)。 |
示例
has.ascfweb.redirectTo({
url: 'test?id=1'
}) has.ascfweb.postMessage(Object object)
此方法用于网页向元服务发送消息,会在特定时机(元服务后退、组件销毁)触发组件的 bindmessage 上绑定的方法,方法的回调参数为网页postMessage的信息的数组队列。
起始版本:1.0.4
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
data | string | Object | 是 | 发出的消息对象或字符串。 |
success | function | 否 | success 回调表示把 data 数据存储成功。存储成功的数据会在元服务后退、组件销毁时,通过 bindmessage 发送给用户。 |
fail | function | 否 | 回调表示没有把 data 数据存储成功。 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行)。 |
示例
has.ascfweb.postMessage({ data: 'foo' })
has.ascfweb.postMessage({ data: {foo: 'bar'} }) has.ascfweb.getEnv(function callback)
获取当前环境。以callback形式返回结果。
起始版本:1.0.4
参数:
参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
callback | function | 否 | 获取当前环境的回调函数。 |
callback返回值:
Object类型,包括以下字段。
参数 | 类型 | 描述 |
|---|---|---|
ascfweb | boolean | 判断当前是否在 ascfweb 环境中。 |
systemInfo | object | 系统信息 |
systemInfo说明:
参数 | 类型 | 描述 |
|---|---|---|
deviceType | string | 设备类型。 |
brand | string | 设备品牌名称。 |
productModel | string | 认证型号。 |
osFullName | string | 系统版本。 |
示例
has.ascfweb.getEnv(function(res) {
console.log(res.ascfweb); // true
console.log(res.systemInfo);
}) has.checkJsApi(Object object)
使用checkJsApi判断当前宿主是否支持某些API。
起始版本:1.0.4
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
jsApiList | string[] | 是 | 需要 check 的 api 名称数组。 |
success | function | 否 | 接口调用成功的回调函数。 |
fail | function | 否 | 接口调用失败的回调函数。 |
complete | function | 否 | 接口调用结束的回调函数。(调用成功、失败都会执行) |
示例:
has.checkJsApi({
jsApiList: ['chooseImage', 'previewImage', 'compressImage', 'uploadFile'],
success(res) {
console.log('checkJsApi fail: ', res);
},
fail(res) {
console.log('checkJsApi fail: ', res);
}
}) has.chooseImage(Object object)
从本地相册选择图片或使用相机拍照。
起始版本:1.0.4
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
count | number | 9 | 否 | 最多可以选择的图片张数。默认值为9,最大不能超过20。 |
sizeType | string[] | ['original', 'compressed'] | 否 | 所选的图片的尺寸。
|
sourceType | string[] | ['album', 'camera'] | 否 | 选择图片的来源。
|
success | function | - | 否 | 接口调用成功的回调函数。 |
fail | function | - | 否 | 接口调用失败的回调函数。 |
complete | function | - | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success返回值:
参数 | 类型 | 描述 |
|---|---|---|
tempFilePaths | Array<string> | 图片的本地临时文件路径列表 (本地路径)。 |
tempFiles | Array<object> | 图片的本地临时文件列表。 |
示例:
has.chooseImage({
count: 1, // 默认9
sizeType: ['original', 'compressed'], // 可以指定是原图还是压缩图,默认二者都有
sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机,默认二者都有
success: function (res) {
}
}); has.previewImage(Object object)
在新页面中预览图片,预览的过程中用户可以进行保存图片等操作。
起始版本:1.0.4
注意事项:在调用此接口时如果使用网络资源,需要先完成配置服务器域名。
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
current | string | urls的第一个元素(即第一张图片url) | 否 | 当前显示的图片的链接。 |
urls | string[] | - | 是 | 需要预览的图片列表(支持网络图片和本地图片,本地图片路径以internal://开头)。 |
showmenu | boolean | true | 否 | 是否显示长按菜单。 |
success | function | - | 否 | 接口调用成功的回调函数。 |
fail | function | - | 否 | 接口调用失败的回调函数。 |
complete | function | - | 否 | 接口调用结束的回调函数。(调用成功、失败都会执行) |
示例:
has.previewImage({
current: '', // 当前显示图片的http链接
urls: [] // 需要预览的图片http链接列表
}); has.uploadImage(Object object)
将本地图片上传到服务器。
起始版本:1.0.4
需要权限:在module.json5中声明ohos.permission.INTERNET。
注意事项:在调用此接口前,需要先完成配置服务器域名。
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 是 | 开发者服务器地址。 |
filePath | string | 是 | 要上传文件资源的路径 。(本地路径) |
name | string | 是 | 文件对应的 key,开发者在服务端可以通过这个 key 获取文件的二进制内容。 |
header | string | 否 | HTTP 请求 Header,Header 中不能设置 Referer。 |
formData | Object | 否 | HTTP 请求中其他额外的 form data。 |
success | function | 否 | 接口调用成功的回调函数。 |
fail | function | 否 | 接口调用失败的回调函数。 |
complete | function | 否 | 接口调用结束的回调函数。(调用成功、失败都会执行) |
示例:
has.chooseImage({
success (res) {
const tempFilePaths = res.tempFilePaths
has.uploadImage({
url: 'https://www.example.com', // 此处仅为样例,请开发者更换为可用接口地址
filePath: tempFilePaths[0],
name: 'file',
formData: {
'user': 'test'
},
success (res){
const data = res.data
//do something
}
})
}}) has.downloadImage(Object object)
下载图片资源到本地。
起始版本:1.0.4
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 是 | 开发者服务器地址。 |
header | string | 否 | HTTP 请求 Header,Header 中不能设置 Referer。 |
filePath | string | 否 | 指定文件下载后存储的路径 。(本地路径) |
success | function | 否 | 接口调用成功的回调函数。 |
fail | function | 否 | 接口调用失败的回调函数。 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例:
has.downloadImage({
url: 'https://www.example.com', // 此处仅为样例,请开发者更换为可用接口地址
success(res) {
// 只要服务器有响应数据,就会把响应内容写入文件并进入 success 回调,业务需要自行判断是否下载到了想要的内容
if (res.statusCode === 200) {
let filePath = res.filePath;
}
}
}); has.getNetworkType(Object object)
获取网络类型。
起始版本:1.0.4
需要权限:在module.json5中声明ohos.permission.GET_NETWORK_INFO。
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
success | function | 否 | 接口调用成功的回调函数。 |
fail | function | 否 | 接口调用失败的回调函数。 |
complete | function | 否 | 接口调用结束的回调函数。(调用成功、失败都会执行) |
success返回值:
参数 | 类型 | 描述 |
|---|---|---|
networkType | string | 网络类型。
|
示例:
has.getNetworkType({
success: function (res) {
var networkType = res.networkType; // 返回网络类型2g,3g,4g,wifi
}
}); has.openLocation(Object object)
使用引擎内置地图查看具体位置。
起始版本:1.0.4
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
latitude | number | - | 是 | 纬度,范围为-90 ~ 90,负数表示南纬。 说明: 中国大陆及港澳地区,请使用 gcj02,其他地区请使用 wgs84。 |
longitude | number | - | 是 | 经度,范围为-180 ~ 180,负数表示西经。根据type字段决定使用哪套坐标系。 说明: 中国大陆及港澳地区,请使用 gcj02,其他地区请使用 wgs84。 |
name | string | - | 是 | 位置名。 |
address | string | - | 否 | 地址的详情说明。 |
success | function | - | 否 | 接口调用成功的回调函数。 |
fail | function | - | 否 | 接口调用失败的回调函数。 |
complete | function | - | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例:
has.openLocation({
latitude: 0, // 纬度,浮点数,范围为90 ~ -90
longitude: 0, // 经度,浮点数,范围为180 ~ -180。
name: '', // 位置名
address: '' // 地址详情说明
}); has.getLocation(Object object)
获取当前的地理位置、速度。开启高精度定位,接口耗时会增加,可指定 highAccuracyExpireTime 作为超时时间。
起始版本:1.0.4
需要权限:在module.json5中声明ohos.permission.LOCATION和ohos.permission.APPROXIMATELY_LOCATION。
参数:
参数为Object对象,包括以下字段。
参数 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
type | string | wgs84 | 否 | wgs84 返回 gps 坐标,gcj02 返回国测局坐标。 |
altitude | boolean | false | 否 | 传入 true 会返回高度信息,由于获取高度需要较高精确度,会减慢接口返回速度。 |
isHighAccuracy | boolean | false | 否 | 开启高精度定位。 |
highAccuracyExpireTime | number | 否 | 高精度定位超时时间(ms),指定时间内返回最高精度,该值3000ms以上高精度定位才有效果。 | |
success | function | 否 | 接口调用成功的回调函数。 | |
fail | function | 否 | 接口调用失败的回调函数。 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success返回值:
属性 | 类型 | 说明 |
|---|---|---|
latitude | number | 纬度,范围为 -90~90,负数表示南纬,根据type参数确定使用坐标。 |
longitude | number | 经度,范围为 -180~180,负数表示西经,根据type参数确定使用坐标。 |
speed | number | 速度,单位 m/s。 |
accuracy | number | 位置的精确度,反应与真实位置之间的接近程度,可以理解成10即与真实位置相差10m,越小越精确。 |
altitude | number | 高度,单位 m。 |
verticalAccuracy | number | 垂直精度,单位 m。 |
示例:
has.getLocation({
type: 'wgs84', // 默认为wgs84的gps坐标,如果要返回直接给openLocation用的火星坐标,可传入'gcj02'
success: function (res) {
let latitude = res.latitude; // 纬度,浮点数,范围为90 ~ -90
let longitude = res.longitude; // 经度,浮点数,范围为180 ~ -180。
let speed = res.speed; // 速度,以米/每秒计
let accuracy = res.accuracy; // 位置精度
}
});