1# web
2展示网页内容的组件。
3>  **说明：**
4>
5>  该组件从API version 6开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
6
7## 权限列表
8访问在线网页时需添加网络权限：ohos.permission.INTERNET
9
10## 约束
11web组件不跟随转场动画。一个页面仅支持一个web组件。
12
13## 子组件
14不支持。
15
16## 属性
17
18| 名称 | 参数类型 | 默认值 | 必填 | 描述 |
19| -------- | -------- | -------- | -------- | -------- |
20| src      | string |   -    |   否     |设置需要显示网页的地址，网址的域名必须为https协议且经过ICP备案。|
21| id  | string | -  | 否  |  组件的唯一标识。  |
22
23
24## 样式
25不支持通用样式设置。
26
27## 事件
28仅支持如下事件：
29
30| 名称 | 参数 | 描述 |
31| -------- |  -------- | -------- |
32| pagestart      | {url: string} | 加载网页时触发。 |
33| pagefinish  | {url: string} |  网页加载结束时触发。  |
34| error  | {url: string, errorCode: number, description: string} |  加载网页出现错误时触发或打开网页出错时触发。  |
35
36## 方法
37仅支持如下方法：
38
39| 名称 | 参数 | 描述 |
40| -------- |  -------- | -------- |
41| reload      | - | 重新加载页面。 |
42
43## 示例
44```html
45<!-- xxx.hml -->
46<div style="height: 500px; width: 500px; flex-direction: column;">
47    <button onclick="reloadWeb">click to reload</button>
48    <web src="www.example.com" id="web" onpagestart="pageStart" onpagefinish="pageFinish" on:error="pageError"></web>
49</div>
50```
51
52```js
53// xxx.js
54export default {
55    reloadWeb() {
56        this.$element('web').reload()
57    },
58
59    pageStart: function(e) {
60        console.info('web pageStart: ' + e.url)
61    },
62
63    pageFinish: function(e) {
64        console.info('web pageFinish: ' + e.url)
65    },
66
67    pageError: function(e) {
68        console.info('web pageError url: ' + e.url)
69        console.info('web pageError errorCode: ' + e.errorCode)
70        console.info('web pageError description: ' + e.description)
71    }
72}
73```