目录

ArkUI-Image组件图片显示异常问题定位

使用Image组件加载图片,发现图片变为了正方形

[h2]问题现象

使用Image加载图片,发现图片被压缩,且打印图片大小时发现,图片大小并非图片原本尺寸,而是高宽均为512像素尺寸。

错误现象展示如下:

正常现象展示如下:

[h2]定位过程

  1. 同一张图片,新建项目展示查看确认正常。
  2. 使用代码确认其尺寸,发现其尺寸被压缩到512像素尺寸。
  3. 全局搜索图片资源,发现该图片资源也被用于在module.json5中的icon属性引用。
  4. 修改module.json5的icon属性对该图片引用后,该图片应用内展示恢复正常。
  5. 重新设置icon属性复现之后,发现是编译打包后的HAP包内,该图片大小被压缩到512像素大小的正方形。

[h2]分析结论

应该是因为该图片被设置为应用桌面图标后,IDE编译打包时将其压缩到512像素尺寸的正方形,而后续应用内使用也只能拿到压缩后的图片。

[h2]修改建议

修改module.json5的icon属性,不要使用可能会在应用内使用的图片作为桌面应用图标。

怎么解决Image组件加载图片被旋转90度的问题

[h2]问题现象

使用Image组件加载图片时,图片自动被旋转了90度,如何使图片显示方向正确。问题代码如下:

@Entry
@Component
struct ImageRotationProblem {
  build() {
    Column() {
      // 运行时请按需替换图片资源
      Image($r('app.media.startIcon'));
    };
  }
}

左图为正常显示效果,右图为Image加载显示效果:

[h2]定位过程

  1. 使用Image组件加载其他图片,检查是否为组件问题。由于“新闻”图片正常显示,确认非组件问题。

  2. 检查原图片Exif信息,定位其orientation属性。通过在线网站查看图片信息得知该图片的拍摄方向为逆时针旋转90度。由此,定位到图片被旋转的原因。

    属性

    说明

    值

    ImageWidth

    像素宽度

    4032

    XResolution

    X分辨率

    72

    YResolution

    Y分辨率

    72

    Resolution

    分辨率单位

    英寸

    Orientation

    拍摄方向

    6(逆时针旋转90°)

[h2]分析结论

图片旋转是因为图像的拍摄方向属性固定为旋转90度导致的,需要旋转归位或者对图像进行其他处理。

[h2]修改建议

方案一:通过组件旋转属性,使图片显示方向正常:

直接给Image组件加上对应的旋转属性,使图片正常显示。因为图片的方向是逆时针90度,将Image组件顺时针旋转90度后,图片会正常显示。通过以下属性旋转:

@Entry
@Component
struct ImageRotationOne {
  build() {
    Column() {
      // 运行时请按需替换图片资源
      Image($r('app.media.startIcon'))
        .rotate({ angle: 90 });
    };
  }
}

这种方案只有在确定图片的方向信息时才能使用,如果是从网络加载的、不能确定方向的图片列表,该方案则不适用。

方案二:通过orientation属性,设置图片的显示方向:

利用orientation属性,设置图像内容的显示方向。如果需要显示携带旋转角度信息或翻转信息的图片建议使用ImageRotateOrientation.AUTO进行设置。示例代码如下:

// 运行时请按需替换图片资源
@Entry
@Component
struct ImageRotationTwo {
  build() {
    Column() {
      // 运行时请按需替换图片资源
      Image($r('app.media.startIcon'))
        .orientation(ImageRotateOrientation.AUTO);
    };
  }
}

这种方案不支持gif和svg类型的图片。

方案三:将图片转成ImageSource对象后读取旋转信息:

思路:读取每张图片的方向orientation信息,根据其方向,设置图片的显示方向。

  1. 使用Image Kit的createImageSource接口,将图片转换成image.ImageSource对象。
  2. 使用ImageSource的getImageProperty接口获取图片的image.PropertyKey.ORIENTATION旋转信息。
  3. 根据图片的EXIF方向信息设置orientation属性值进行旋转,使图片正常显示。

详细代码可以参考:获取图片的Exif信息并设置图像内容的显示方向。

长图渐变色效果未正常显示

[h2]问题现象

页面展示图片时通常先是展示缩略图,点击后才会显示原图。长图以缩略图样式展示时通常添加渐变色以提高用户体验。

图一:无渐变色的缩略图。

图二:有渐变色的缩略图。

[h2]定位过程

  1. 通过DevEco Testing查看问题组件,发现是Image组件。

  2. 排查该Image组件的同层组件的设置,发现没有使用linearGradient设置颜色渐变的同层组件。
    @Entry
    @Component
    struct ImgExample {
    
      build() {
        Stack() {
          Image($r('app.media.long')) // $r('app.media.long')需要替换为开发者需要的图片资源文件
            .width(200)
            .height(300)
            .objectFit(ImageFit.Auto)
            // 没有使用linearGradient设置颜色渐变的同层组件
        }
        .width('100%')
        .height('100%');
      }
    }

[h2]分析结论

Image组件没有使用linearGradient设置颜色渐变的同层组件,导致长图没有渐变色效果。

[h2]修改建议

添加使用linearGradient设置颜色渐变的同层组件。

@Entry
@Component
struct ImgExample {
  build() {
    Stack() {
      Stack() {
        Image($r('app.media.long')) // $r('app.media.long')需要替换为开发者需要的图片资源文件
          .width('100%')
          .height('100%')
          .objectFit(ImageFit.Auto);

        // 使用linearGradient设置颜色渐变的同层组件
        Row()
          .width('100%')
          .height('40')
          .linearGradient({
            direction: GradientDirection.Bottom,
            colors: [['#00000000', 0.0], ['#ff000000', 1.0]]
          });
      }
      .width(200)
      .height(300)
      .alignContent(Alignment.Bottom);
    }
    .width('100%')
    .height('100%');
  }
}

效果图如下:

页面上图片展示不完整

[h2]问题现象

加载应用内的图片时,图片显示不完整。

图一:完整显示。

图二:显示不完整。

[h2]定位过程

  1. 使用DevEco Testing查看问题组件,该组件为Image组件。

  2. 查看Image组件的objectFit属性是否正确,图片的缩放模式选用不当可能造成图片显示不完整,如果图片缩放模式设置为cover,图片会保持宽高比,并填满容器,超出部分会被裁剪。
    @Entry
    @Component
    struct ImgEmpty {
    
      build() {
        Stack() {
          Image($r('app.media.product')) // $r('app.media.product')需要替换为开发者需要的图片资源文件
            .width(300)
            .height(200)
            .objectFit(ImageFit.Cover) // 图片保持宽高比并填满容器,超出部分会被裁剪
        }
        .width('100%')
        .height('100%');
      }
    }

[h2]分析结论

图片使用了不合适的缩放模式,造成超出容器的部分被裁剪,导致图片显示不完整。

[h2]修改建议

objectFit属性设置为Contain,该缩放模式会保持宽高比,完整显示图片。

@Entry
@Component
struct ImgTruncation {
  build() {
    Stack() {
      Image($r('app.media.product')) // $r('app.media.product')需要替换为开发者需要的图片资源文件
        .width(300)
        .height(200)
        .objectFit(ImageFit.Contain) // 保持宽高比,完整显示图片
    }
    .width('100%')
    .height('100%');
  }
}

页面中的图片资源无法正常显示

[h2]问题现象

页面图片显示空白。

[h2]定位过程

  1. 使用DevEco Testing查看问题组件,问题所在位置缺少Image组件,而正常显示图片组件的相同位置使用了Image组件。

  2. 排查Image组件的设置,发现添加了判断图片资源是否存在的逻辑。
    @Entry
    @Component
    struct ImgEmpty {
      imgSrcs: ResourceStr[] = ['', $r('app.media.myposter2')];
    
      build() {
        Stack() {
          List() {
            ForEach(this.imgSrcs, (img: ResourceStr, index: number) => {
              ListItem() {
                Row() {
                  Text('图片' + (index + 1))
                    .fontSize(20)
                    .height('100%')
                    .width(100)
                    .textAlign(TextAlign.Center)
                    .borderRadius(10);
    
                  // 图片资源为空时不显示图片组件
                  if (img !== '') {
                    Image(img)
                      .width(150)
                      .objectFit(ImageFit.Contain);
                  }
                }
                .width('100%')
                .height(120)
                .justifyContent(FlexAlign.Start)
                .borderRadius(10)
                .backgroundColor('#f1f3f5');
              }
              .margin({ top: 5, bottom: 5 });
            }, (item: string) => item);
          }
          .nestedScroll({
            scrollForward: NestedScrollMode.PARENT_FIRST,
            scrollBackward: NestedScrollMode.SELF_FIRST
          })
          .scrollBar(BarState.Off)
          .width('80%');
        }
        .width('100%')
        .height('100%');
      }
    }

[h2]分析结论

该图片资源不存在,导致无法显示图片。

[h2]修改建议

无图片资源时通过alt属性使用占位图片替代。

@Entry
@Component
struct ImgEmpty {
  imgSrcs: ResourceStr[] = ['', $r('app.media.startIcon')]; // $r('app.media.startIcon')需要替换为开发者需要的图片资源文件

  build() {
    Stack() {
      List() {
        ForEach(this.imgSrcs, (img: ResourceStr, index: number) => {
          ListItem() {
            Row() {
              Text('图片' + (index + 1))
                .fontSize(20)
                .height('100%')
                .width(100)
                .textAlign(TextAlign.Center)
                .borderRadius(10);

              Image(img)
                .width(100)
                // $r('app.media.empty')需要替换为开发者需要的图片资源文件
                .alt($r('app.media.empty')) // 图片资源为空时显示占位图片
                .objectFit(ImageFit.Contain);
            }
            .width('100%')
            .height(120)
            .justifyContent(FlexAlign.Start)
            .borderRadius(10)
            .backgroundColor('#f1f3f5');
          }
          .margin({ top: 5, bottom: 5 });
        }, (item: string) => item);
      }
      .nestedScroll({
        scrollForward: NestedScrollMode.PARENT_FIRST,
        scrollBackward: NestedScrollMode.SELF_FIRST
      })
      .scrollBar(BarState.Off)
      .width('80%');
    }
    .width('100%')
    .height('100%');
  }
}

效果图如下: