智能客服
你问我答，随时在线为你解决问题
该组件从API version 6开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
高级筛选
API version全部版本
ArkTS API参考
Archived
Native API参考
Archived
您当前浏览的3.1/4.0版本文档归档不再维护，推荐您使用最新的HarmonyOS NEXT版本文档。详细请参考文档维护策略变更。
展示网页内容的组件。
说明
权限列表
访问在线网页时需添加网络权限：ohos.permission.INTERNET
约束
web组件不跟随转场动画。一个页面仅支持一个web组件。
子组件
不支持。
属性
展开
| 名称 | 参数类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| src | string | - | 否 | 设置需要显示网页的地址，网址的域名必须为https协议且经过ICP备案。 |
| id | string | - | 否 | 组件的唯一标识。 |
样式
不支持通用样式设置。
事件
仅支持如下事件：
展开
| 名称 | 参数 | 描述 |
|---|---|---|
| pagestart | {url: string} | 加载网页时触发。 |
| pagefinish | {url: string} | 网页加载结束时触发。 |
| error | {url: string, errorCode: number, description: string} | 加载网页出现错误时触发或打开网页出错时触发。 |
方法
仅支持如下方法：
展开
| 名称 | 参数 | 描述 |
|---|---|---|
| reload | - | 重新加载页面。 |
示例
收起
自动换行
深色代码主题
复制
- <!-- xxx.hml -->
- <div style="height: 500px; width: 500px; flex-direction: column;">
- <button onclick="reloadWeb">click to reload</button>
- <web src="www.example.com" id="web" onpagestart="pageStart" onpagefinish="pageFinish" on:error="pageError"></web>
- </div>
收起
自动换行
深色代码主题
复制
- // xxx.js
- export default {
- reloadWeb() {
- this.$element('web').reload()
- },
-
- pageStart: function(e) {
- console.info('web pageStart: ' + e.url)
- },
-
- pageFinish: function(e) {
- console.info('web pageFinish: ' + e.url)
- },
-
- pageError: function(e) {
- console.info('web pageError url: ' + e.url)
- console.info('web pageError errorCode: ' + e.errorCode)
- console.info('web pageError description: ' + e.description)
- }
- }
华为开发者联盟 版权所有 ©2026
在 API参考 中进行搜索
请输入您想要搜索的关键词