Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
82e259cf
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
82e259cf
编写于
7月 19, 2022
作者:
O
openharmony_ci
提交者:
Gitee
7月 19, 2022
浏览文件
操作
浏览文件
下载
差异文件
!6901 更新web文档
Merge pull request !6901 from 周礼亭/master
上级
8ad23392
c74f4427
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
310 addition
and
13 deletion
+310
-13
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md
...ication-dev/reference/arkui-ts/ts-basic-components-web.md
+310
-13
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md
浏览文件 @
82e259cf
...
...
@@ -27,8 +27,6 @@
> **说明:**
>
> - 不支持转场动画;
> - 不支持多实例;
> - 仅支持本地音视频播放。
## 属性
| 名称 | 参数类型 | 默认值 | 描述 |
...
...
@@ -75,6 +73,7 @@
| onShowFileSelector(callback: (event?: { result:
[
FileSelectorResult
](
#fileselectorresult对象说明
)
, fileSelector:
[
FileSelectorParam
](
#fileselectorparam对象说明
)
}) => void) |
<p>
调用此函数以处理具有“文件”输入类型的HTML表单,以响应用户按下的“选择文件”按钮
<br/>
- result:用于通知Web组件文件选择的结果。
<br/>
- fileSelector:文件选择器的相关信息。
</p>
|
| onUrlLoadIntercept(callback: (event?: { data:string
\|
[
WebResourceRequest
](
#webresourcerequest对象说明
)
}) => boolean) |
<p>
当Web组件加载url之前触发该回调,用于是否阻止此次访问。callback返回true表示阻止此次加载,否则允许此次加载。
<br/>
- data:url的相关信息。
</p>
|
| onInterceptRequest
<sup>
9+
</sup>
(callback: (event?: { request:
[
WebResourceRequest
](
#webresourcerequest对象说明
)
}) =>
[
WebResourceResponse
](
#webresourceresponse对象说明
)
) |
<p>
当Web组件加载url之前触发该回调,用于拦截url并返回响应数据。callback返回响应数据为空表示按原来方式加载,否则加载响应数据。
<br/>
- request:url请求的相关信息。
</p>
|
| onHttpAuthRequest
<sup>
9+
</sup>
(callback: (event?: { handler:
[
HttpAuthHandler
](
#httpauthhandlersup9sup
)
, host: string, realm: string}) => boolean) |
<p>
通知收到http auth认证请求。callback返回false表示此次认证失败,否则成功。
<br/>
- handler:通知Web组件用户操作行为。
<br/>
- host:HTTP身份验证凭据应用的主机。
<br/>
- realm:HTTP身份验证凭据应用的域。
</p>
|
## ConsoleMessage对象说明
...
...
@@ -200,6 +199,59 @@ onRenderExited接口返回的渲染进程退出的具体原因。
| FileOpenFolderMode | 打开上传文件夹模式。 |
| FileSaveMode | 文件保存模式。 |
## HitTestType枚举说明
| 名称 | 描述 |
| ------------- | ----------------------------------------- |
| EditText | 可编辑的区域。 |
| Email | 电子邮件地址。 |
| HttpAnchor | 超链接,其src为http。 |
| HttpAnchorImg | 带有超链接的图片,其中超链接的src为http。 |
| Img | HTML::img标签。 |
| Map | 地理地址。 |
| Unknown | 未知内容。 |
## HttpAuthHandler<sup>9+</sup>
Web组件返回的http auth认证请求确认或取消和使用缓存密码认证功能对象。
### cancel<sup>9+</sup>
cancel(): void
通知Web组件用户取消HTTP认证操作。
### confirm<sup>9+</sup>
confirm(userName: string, pwd: string): boolean
使用用户名和密码进行HTTP认证操作。
-
参数
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | ---- | ------ | -------------- |
| userName | string | 是 | - | HTTP认证用户名。|
| pwd | string | 是 | - | HTTP认证密码。 |
-
返回值
| 参数类型 | 说明 |
| -------- | ------------------------------- |
| boolean | 认证成功返回true,失败返回false。 |
### isHttpAuthInfoSaved<sup>9+</sup>
isHttpAuthInfoSaved(): boolean
通知Web组件用户使用服务器缓存的账号密码认证。
-
返回值
| 参数类型 | 说明 |
| -------- | ------------------------------------- |
| boolean | 存在密码认证成功返回true,其他返回false。|
## WebController
通过WebController可以控制Web组件各种行为。一个WebController对象只能控制一个Web组件,且必须在Web组件和WebController绑定后,才能调用WebController上的方法。
...
...
@@ -264,23 +316,76 @@ forward(): void
按照历史栈,前进一个页面。一般结合accessForward一起使用。
### backOrForward<sup>9+</sup>
backOrForward(step: number): void
按照历史栈,前进或者后退指定步长的页面,当历史栈中不存在对应步长的页面时,不会进行页面跳转。
-
参数
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| ---- | ------ | ---- | ---- | ---------------------------------------- |
| step | number | 是 |- |需要前进或后退的步长。 |
### getHitTest
getHitTest(): HitTestType
获取当前被点击区域的元素类型。
-
HitTestType枚举说明
-
返回值
| 参数类型 | 说明 |
| -------- | ------------------ |
|
[
HitTestType
](
#hittesttype枚举说明
)
| 被点击区域的元素类型。 |
| 名称 | 描述 |
| ------------- | ----------------------------------------- |
| EditText | 可编辑的区域。 |
| Email | 电子邮件地址。 |
| HttpAnchor | 超链接。其src为http。 |
| HttpAnchorImg | 带有超链接的图片,其中超链接的src为http。 |
| Img | HTML::img标签。 |
| Map | 地理地址。 |
| Unknown | 未知内容。 |
### getHitTestValue<sup>9+</sup>
getHitTestValue(): HitTestValue
获取当前被点击区域的元素信息。
-
返回值
| 参数类型 | 说明 |
|----------|------|
|
[
HitTestValue
](
#hittestvaluesup9sup
)
| 点击区域的元素信息。 |
### getWebId<sup>9+</sup>
getWebId(): number
获取当前Web组件的索引值,用于多个Web组件的管理。
-
返回值
| 参数类型 | 说明 |
|----------|------|
| number | 当前Web组件的索引值。 |
### getTitle<sup>9+</sup>
getTitle(): string
获取当前网页的标题。
-
返回值
| 参数类型 | 说明 |
|----------|------|
| string | 当前网页的标题。 |
### getPageHeight<sup>9+</sup>
getPageHeight(): number
获取当前网页的页面高度。
-
返回值
| 参数类型 | 说明 |
|----------|------|
| number | 当前网页的页面高度。 |
### getDefaultUserAgent<sup>9+</sup>
getDefaultUserAgent(): string
获取当前默认用户代理。
-
返回值
| 参数类型 | 说明 |
|----------|------|
| string | 默认用户代理。 |
### loadData
...
...
@@ -331,6 +436,33 @@ onInactive(): void
调用此接口通知Web组件进入未激活状态。
### zoom
zoom(factor: number): void
调整当前网页的缩放比例。
-
参数
| 参数名 | 参数类型 | 必填 | 参数描述 |
|--------|----------|------|---------|
| factor | number | 是 | 基于当前网页所需调整的相对缩放比例,正值为放大,负值为缩小。 |
### zoomIn<sup>9+</sup>
zoomIn(): boolean
调用此接口将当前网页进行放大,比列20%。
-
返回值
| 参数类型 | 说明 |
|----------|------|
| boolean | 放大操作是否成功执行。 |
### zoomOut<sup>9+</sup>
zoomOut(): boolean
调用此接口将当前网页进行缩小,比列20%。
-
返回值
| 参数类型 | 说明 |
|----------|------|
| boolean | 缩小操作是否成功执行。 |
### refresh
refresh(): void
...
...
@@ -385,6 +517,28 @@ getCookieManager(): WebCookie
| 参数类型 | 说明 |
| --------- | -------------------------------------------------------- |
| WebCookie | web组件cookie管理对象,参考
[
WebCookie
](
#webcookie
)
定义。 |
## HitTestValue<sup>9+</sup>
提供点击区域的元素信息。
### getType<sup>9+</sup>
getType(): HitTestType
获取当前被点击区域的元素类型。
-
返回值
| 参数类型 | 说明 |
|----------|------|
|
[
HitTestType
](
#hittesttype枚举说明
)
| 当前被点击区域的元素类型。 |
### getExtra<sup>9+</sup>
getExtra(): string
若被点击区域为图片或链接,则附加参数信息为其url地址。
-
返回值
| 参数类型 | 说明 |
|----------|------|
| string | 点击区域的附加参数信息。 |
## WebCookie
通过WebCookie可以控制Web组件中的cookie的各种行为,其中每个应用中的所有web组件共享一个WebCookie。通过controller方法中的getCookieManager方法可以获取WebCookie对象,进行后续的cookie管理操作。
### setCookie
...
...
@@ -392,7 +546,7 @@ setCookie(url: string, value: string): boolean
设置cookie,该方法为同步方法。设置成功返回true,否则返回false。
-
参数
说明
-
参数
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| ------ | -------- | ---- | ------ | ------------------------- |
...
...
@@ -411,6 +565,149 @@ saveCookieSync(): boolean
| 参数类型 | 说明 |
| -------- | ---------------------------------- |
| boolean | 同步内存cookie到磁盘操作是否成功。 |
## WebDataBase<sup>9+</sup>
web组件数据库管理对象。
### existHttpAuthCredentials<sup>9+</sup>
static existHttpAuthCredentials(): boolean
判断是否存在任何已保存的HTTP身份验证凭据,该方法为同步方法。存在返回true,不存在返回false。
-
返回值
| 参数类型 | 说明 |
| -------- | ----------------------------------- |
| boolean | 是否存在任何已保存的HTTP身份验证凭据。存在返回true,不存在返回false |
### deleteHttpAuthCredentials<sup>9+</sup>
static deleteHttpAuthCredentials(): void
清除所有已保存的HTTP身份验证凭据,该方法为同步方法。
### getHttpAuthCredentials<sup>9+</sup>
static getHttpAuthCredentials(host: string, realm: string): Array
\<
string
\>
检索给定主机和域的HTTP身份验证凭据,该方法为同步方法。检索成功返回一个包含用户名和密码的组数,检索不成功返回空数组。
-
参数
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| ------ | -------- | ---- | ------ | -------------------------- |
| host | string | 是 | - | HTTP身份验证凭据应用的主机。 |
| realm | string | 是 | - | HTTP身份验证凭据应用的域。 |
-
返回值
| 参数类型 | 说明 |
| ---------------- | --------------------------------------------- |
| Array
\<
string
\>
| 包含用户名和密码的组数,检索失败返回空数组。 |
### saveHttpAuthCredentials<sup>9+</sup>
static saveHttpAuthCredentials(host: string, realm: string, username: string, password: string): void
保存给定主机和域的HTTP身份验证凭据,该方法为同步方法。
-
参数
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | ---- | ------ | -------------------------- |
| host | string | 是 | - | HTTP身份验证凭据应用的主机。 |
| realm | string | 是 | - | HTTP身份验证凭据应用的域。 |
| username | string | 是 | - | 用户名。 |
| password | string | 是 | - | 密码。 |
## WebStorage<sup>9+</sup>
通过WebStorage可管理Web SQL数据库接口和HTML5 Web存储接口,每个应用中的所有Web组件共享一个WebStorage。
### deleteAllData<sup>9+</sup>
static deleteAllData(): void
清除Web SQL数据库当前使用的所有存储。
### deleteOrigin<sup>9+</sup>
static deleteOrigin(origin : string): void
清除指定源所使用的存储。
-
参数
| 参数名 | 参数类型 | 必填 | 说明 |
|---------|---------|-----|-----|
| origin | string | 是 | 指定源的字符串索引。 |
### getOrigins<sup>9+</sup>
static getOrigins(callback: AsyncCallback
<Array
<[
WebStorageOrigin
](
#webstorageoriginsup9sup
)
>
>) : void
以回调方式异步获取当前使用Web SQL数据库的所有源的信息。
-
参数
| 参数名 | 参数类型 | 必填 | 说明 |
|---------|---------|-----|----|
| callback | AsyncCallback
<Array
<[
WebStorageOrigin
](
#webstorageoriginsup9sup
)
>
> | 是 | 以数组方式返回源的信息,信息内容参考WebStorageOrigin。|
### getOrigins<sup>9+</sup>
static getOrigins() : Promise
<Array
<[
WebStorageOrigin
](
#webstorageoriginsup9sup
)
>
>
以Promise方式异步获取当前使用Web SQL数据库的所有源的信息。
-
返回值
| 类型 | 说明 |
|------|------|
| Promise
<Array
<[
WebStorageOrigin
](
#webstorageoriginsup9sup
)
>
> | Promise实例,用于获取当前所有源的信息,信息内容参考WebStorageOrigin。 |
### getOriginQuota<sup>9+</sup>
static getOriginQuota(origin : string, callback : AsyncCallback
<number>
) : void
使用callback回调异步获取指定源的Web SQL数据库的存储配额,配额以字节为单位。
-
参数
| 参数名 | 参数类型 | 必填 | 说明 |
|----------|-----------|------|------|
| origin | string | 是 | 指定源的字符串索引 |
| callback | AsyncCallback
<number>
| 是 | 指定源的存储配额。 |
### getOriginQuota<sup>9+</sup>
static getOriginQuota(origin : string) : Promise
<number>
以Promise方式异步获取指定源的Web SQL数据库的存储配额,配额以字节为单位。
-
参数
| 参数名 | 参数类型 | 必填 | 说明 |
|----------|---------|------|-------|
| origin | string | 是 | 指定源的字符串索引。 |
-
返回值
| 类型 | 说明 |
|------|------|
| Promise
<number>
| Promise实例,用于获取指定源的存储配额。 |
### getOriginUsage<sup>9+</sup>
static getOriginUsage(origin : string, callback : AsyncCallback
<number>
) : void
以回调方式异步获取指定源的Web SQL数据库的存储量,存储量以字节为单位。
-
参数
| 参数名 | 参数类型 | 必填 | 说明 |
|----------|----------|------|------|
| origin | string | 是 | 指定源的字符串索引。 |
| callback | AsyncCallback
<number>
| 是 | 指定源的存储量。 |
### getOriginUsage<sup>9+</sup>
static getOriginUsage(origin : string) : Promise
<number>
以Promise方式异步获取指定源的Web SQL数据库的存储量,存储量以字节为单位。
-
参数
| 参数名 | 参数类型 | 必填 | 说明 |
|----------|----------|------|------|
| origin | string | 是 | 指定源的字符串索引。 |
-
返回值
| 类型 | 说明 |
|------|------|
| Promise
<number>
| Promise实例,用于获取指定源的存储量。 |
## WebStorageOrigin<sup>9+</sup>
提供Web SQL数据库的使用信息。
-
参数
| 参数名 | 参数类型 | 必填 | 说明 |
|----------|----------|------|------|
| origin | string | 是 | 指定源的字符串索引。 |
| usage | number | 是 | 指定源的存储量。 |
| quota | number | 是 | 指定源的存储配额。 |
## 示例
```
ts
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录