Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
Tonvia
Docs
提交
eef5cc5a
D
Docs
项目概览
Tonvia
/
Docs
与 Fork 源项目一致
Fork自
OpenHarmony / Docs
通知
1
Star
0
Fork
0
代码
文件
提交
分支
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,发现更多精彩内容 >>
提交
eef5cc5a
编写于
1月 27, 2022
作者:
L
lixingchi1
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
lixingchi1@huawei.com
Signed-off-by:
N
lixingchi1
<
lixingchi1@huawei.com
>
上级
9b03f4a8
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
115 addition
and
0 deletion
+115
-0
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md
...ication-dev/reference/arkui-ts/ts-basic-components-web.md
+115
-0
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md
0 → 100644
浏览文件 @
eef5cc5a
# Web
>![](../../public_sys-resources/icon-note.gif) **说明:**
>该组件从 API Version 8 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
提供具有页面显示能力的 WebView 组件。
## 权限列表
ohos.permission.INTERNET(使用网络图片)
ohos.permission.READ_USER_STORAGE
## 子组件
无
## 接口
-
Web
\(
options: {src: string, controller?: WebController}
\)
表1 options 参数说明
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| ---------- | ------------- | ---- | ---- | ----- |
| src | string | 是 | - | 网页地址。 |
| controller | WebController | 否 | - | 控制器。 |
## 属性
| 名称 | 参数类型 | 默认值 | 描述 |
| ---------------- | ------- | ----- | ---------------------------------------- |
| javaScriptAccess | boolean | false | 是否允许执行 JavaScript 脚本,当设置为 false 时,不允许执行。 |
| fileAccess | boolean | false | 启用或禁用 WebView 中是否能通过 file 方式访问应用中的本地文件,当设置为 false 时,禁用。 |
## 事件
| 名称 | 功能描述 |
| ---------------------------------------- | -------------------- |
| onPageEnd(callback: (event?: { url: string }) => void) | 网页加载结束时触发该回调。 |
| onRequestSelected(callback: () => void) | 获取 WebView 焦点时触发该回调。 |
## WebController
WebView 组件的控制器。
### 创建对象
```
webController: WebController = new WebController()
```
### webController.runJavaScript
runJavaScript(options: { script: string, callback?: (error, data) => void }): void
执行 JavaScript 脚本。
-
参数
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | --------------------- | ---- | ---- | --------------------- |
| script | string | 是 | - | JavaScript 脚本。 |
| callback | (error, data) => void | 否 | - | 执行 JavaScript 脚本时的回调。 |
### webController.loadUrl
loadUrl(options: { url: string, headerMap?: Map
<string
,
string
>
}): void
加载 URL。
-
参数
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| --------- | ------------------- | ---- | ---- | ---------- |
| url | string | 是 | - | 需要加载的 URL。 |
| headerMap | Map
<string
,
string
>
| 否 | - | 请求头集合。 |
## 示例
```
@Entry
@Component
struct WebComponent {
@State javaScriptAccess: boolean = true;
@State fileAccess: boolean = true;
controller: WebController = new WebController();
build() {
Column() {
Web(src: 'https://gitee.com/openharmony', controller: this.controller)
.javaScriptAccess(javaScriptAccess)
.fileAccess(fileAccess)
.onRequestSelected(() => {
// Gitee.initNavbar() 函数定义在网页中
this.controller.runJavaScript('javascript:Gitee.initNavbar()',
(err, data) => {
if (err) {
console.error('Operation failed. Cause: ', JSON.stringify(err));
return;
}
console.info('Operation successful. Data: ', JSON.stringify(data));
})
})
.onPageEnd((event) => {
console.log("url: ", event.url);
})
}
}
}
```
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录