目录

如何解决Image组件切换网络图片失败后占位图未显示的问题

问题现象

如下图,在切换网络图片时,若目标图片加载失败,界面不会更新为占位图,而是继续显示之前已加载成功的图片。

问题代码如下:

@Entry
@Component
struct Page {
  @State imageUrl: string | Resource = '';

  build() {
    Column({ space: 30 }) {
      Image(this.imageUrl)
        .width(200)
        .height(200)
        // 本地资源自行替换
        .alt($r('app.media.startIcon'));
      Button('加载正常图片')
        .fontSize(20)
        .fontWeight(FontWeight.Bold)
        .onClick(() => {
          // 网络路径需自行替换
          this.imageUrl = 'XXX.XXX.png';
        });
      Button('加载其他图片')
        .fontSize(20)
        .fontWeight(FontWeight.Bold)
        .onClick(() => {
          // 网络路径需自行替换
          this.imageUrl = 'XXX.XXX.png';
        });
    }
    .height('100%')
    .width('100%')
    .justifyContent(FlexAlign.Center);
  }
}

背景知识

解决方案

方案一:对于API22及以后的版本可以设置alt属性实现图片加载过程中和图片加载失败时显示指定图片,具体案例可以查看使用alt属性实现设置加载失败中图片和加载失败时图片。

方案二:对于API22以前的版本,由于该问题是由于Image组件在成功加载当前图片后,若将其路径更新为无效值(包括空值),组件不会自动触发重新渲染,导致界面仍保留已加载的图片,占位图因此无法显示。可以参考以下方案达到预期的效果:

  1. 为Image组件添加onError事件回调,用于监听图片加载失败的情况。
  2. 在onError回调函数中,将图片源替换为占位图的路径,从而实现显示默认占位图的效果。

参考代码如下:

@Entry
@Component
struct Index {
  @State imageUrl: string | Resource = '';

  build() {
    Column({ space: 30 }) {
      Image(this.imageUrl)
        .width(200)
        .height(200)
        .onError((err: ImageError) => {
          console.error(`${err.message}`);
          console.error(`${err.error?.code}`);
          // 本地资源自行替换
          this.imageUrl = $r('app.media.startIcon');
        });
      Button('加载正常图片')
        .fontSize(20)
        .fontWeight(FontWeight.Bold)
        .onClick(() => {
          // 网络路径需自行替换
          this.imageUrl = 'XXX.XXX.png';
        });
      Button('加载失败显示占位图')
        .fontSize(20)
        .fontWeight(FontWeight.Bold)
        .onClick(() => {
          // 网络路径需自行替换
          this.imageUrl = 'XXX.XXX.png';
        });
    }
    .height('100%')
    .width('100%')
    .justifyContent(FlexAlign.Center);
  }
}

效果图如下: