目录

web-view

承载网页的容器。

此组件会自动铺满整个页面,每个页面只允许添加一个web-view组件。

起始版本:1.0.4

约束与限制

使用web-view组件之前需要完成开发准备,具体请参照开发web-view组件。

属性

属性

类型

默认值

必填

描述

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);
  }
})

接口

[h2]has.ascfweb.navigateTo

has.ascfweb.navigateTo(Object object)

保留当前页面,跳转到应用内的某个页面。但是不能跳转到 tabBar 页面。使用 has.ascfweb.navigateBack 可以返回到原页面。

起始版本:1.0.4

参数:

参数为Object对象,包括以下字段。

参数

类型

必填

说明

url

string

是

需要跳转的应用内非tabBar的页面路径(在app.json中定义的代码包路径),路径后可以带参数。参数与路径之间用?分隔,参数与键值用=相连,多个参数用&分隔。

支持格式:(假设app.json中定义了页面: "page/path/path")

  1. 以"/"开头,是全局路径。
  2. 其他路径,例如:a.png、./a.png、../a.png。

success

function

否

接口调用成功的回调函数。

fail

function

否

接口调用失败的回调函数。

complete

function

否

接口调用结束的回调函数。(调用成功、失败都会执行)

示例:

has.ascfweb.navigateTo({
  url: '/page/path/path?key=1',
  success: function(res) {
  },
  fail: function(err) {
  },
  complete(res) {
  }
})

[h2]has.ascfweb.navigateBack

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
})

[h2]has.ascfweb.reLaunch

has.ascfweb.reLaunch(Object object)

关闭所有页面,打开到应用内的某个页面。

起始版本:1.0.4

参数:

参数为Object对象,包括以下字段。

参数

类型

必填

说明

url

string

是

需要跳转的应用内页面路径(在app.json中定义的代码包路径),非tabBar的页面路径后可以带参数。参数与路径之间用?分隔,参数与键值用=相连,多个参数用&分隔。

支持格式:(假设app.json中定义了页面: "page/path/path")

  1. 以"/"开头,是全局路径。
  2. 其他路径,例如:a.png、./a.png、../a.png。

success

function

否

接口调用成功的回调函数。

fail

function

否

接口调用失败的回调函数。

complete

function

否

接口调用结束的回调函数(调用成功、失败都会执行)。

示例:

has.ascfweb.reLaunch({
  url: 'test?id=1'
})

// options内含有路径后携带参数
Page({
  onLoad (option) {
    console.log(option.query)
  }
})

[h2]has.ascfweb.switchTab

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")

  1. 以"/"开头,加上tabbar字段定义的页面路径;例如:"/page/tab1/tab1"。
  2. 其他路径,例如:tab1、./tab1、../tab1。

success

function

否

接口调用成功的回调函数。

fail

function

否

接口调用失败的回调函数。

complete

function

否

接口调用结束的回调函数(调用成功、失败都会执行)。

示例:

// app.json{
  "tabBar": {
    "list": [{
      "pagePath": "index",
      "text": "首页"
    },{
      "pagePath": "other",
      "text": "其他"
    }]
  }}
has.ascfweb.switchTab({
  url: '/index'
})

[h2]has.ascfweb.redirectTo

has.ascfweb.redirectTo(Object object)

关闭当前页面,跳转到应用内的某个页面,但是不允许跳转到 tabBar 页面。

起始版本:1.0.4

参数:

参数为Object对象,包括以下字段。

参数

类型

必填

说明

url

string

是

需要跳转的应用内非tabBar的页面路径(在app.json中定义的代码包路径),路径后可以带参数。参数与路径之间用?分隔,参数与键值用=相连,多个参数用&分隔。

支持格式:(假设app.json中定义了页面: "page/path/path")

  1. 以"/"开头,是全局路径。
  2. 其他路径,例如:a.png、./a.png、../a.png。

success

function

否

接口调用成功的回调函数。

fail

function

否

接口调用失败的回调函数。

complete

function

否

接口调用结束的回调函数(调用成功、失败都会执行)。

示例

has.ascfweb.redirectTo({
  url: 'test?id=1'
})

[h2]has.ascfweb.postMessage

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'} })

[h2]has.ascfweb.getEnv

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);
})

[h2]has.checkJsApi

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);
  }
})

[h2]has.chooseImage

has.chooseImage(Object object)

从本地相册选择图片或使用相机拍照。

起始版本:1.0.4

参数:

参数为Object对象,包括以下字段。

参数

类型

默认值

必填

说明

count

number

9

否

最多可以选择的图片张数。默认值为9,最大不能超过20。

sizeType

string[]

['original', 'compressed']

否

所选的图片的尺寸。

  • original:原图。
  • compressed:压缩图。

sourceType

string[]

['album', 'camera']

否

选择图片的来源。

  • 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) {
  }
});

[h2]has.previewImage

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链接列表
});

[h2]has.uploadImage

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
      }
    })
 }})

[h2]has.downloadImage

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;
    }
  }
});

[h2]has.getNetworkType

has.getNetworkType(Object object)

获取网络类型。

起始版本:1.0.4

需要权限:在module.json5中声明ohos.permission.GET_NETWORK_INFO。

参数:

参数为Object对象,包括以下字段。

参数

类型

必填

说明

success

function

否

接口调用成功的回调函数。

fail

function

否

接口调用失败的回调函数。

complete

function

否

接口调用结束的回调函数。(调用成功、失败都会执行)

success返回值:

参数

类型

描述

networkType

string

网络类型。

  • cellular:蜂窝网络
  • wifi:Wi-Fi网络
  • bluetooth:蓝牙网络
  • ethernet:以太网网络
  • vpn:VPN网络
  • none:无网络
  • unknown:不常见的网络类型

示例:

has.getNetworkType({
  success: function (res) {
    var networkType = res.networkType; // 返回网络类型2g,3g,4g,wifi
  }
});

[h2]has.openLocation

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: '' // 地址详情说明
});

[h2]has.getLocation

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; // 位置精度
  }
});