目录

ArkWeb网页加载常见问题

Q:Web组件加载某个页面,出现白屏、页面显示不出来,如何解决和定位?

A:使用Web组件时确认以下条件:

  1. 若加载在线页面,需确保手机联网且网络畅通。
  2. 访问在线页面时,应用需添加网络权限ohos.permission.INTERNET。
  3. 确认fileAccess、imageAccess、onlineImageAccess等权限已开启,以加载相关资源。

满足上述条件后,根据HTML的报错信息进行调试。

如果仍然出现白屏,建议开发者使用浏览器打开对应URL验证页面是否存在代码问题,或者参考使用Devtools工具调试前端页面进行调试。

Q:如何控制只在Web组件第一次加载url的时候触发onPageBegin,onPageEnd?

A:使用onAppear事件控制仅在首次加载URL时触发onPageBegin和onPageEnd,参考代码如下:

import { webview } from '@kit.ArkWeb';

@Entry
@Component
struct OnlyOnTheFirstTrigger {
  controller: webview.WebviewController = new webview.WebviewController();
  isFirst: boolean = false;

  build() {
    Column() {
      Web({
        src: 'www.example.com', controller: this.controller
      })
        .onAppear(() => {
          this.isFirst = true;
        })
        .onPageBegin(() => {
          if (this.isFirst) {
            this.isFirst = false;
            console.info('First page loading triggered');
          }
        })
    }
    .width('100%')
    .height('100%')
  }
}