目录

页面中的图片无法被放大

问题现象

页面中图片无法通过点击或手势放大查看。

背景知识

问题定位

排查Image组件是否有使用transform属性并绑定手势对图片进行缩放操作。如果没有使用transform和matrix4矩阵,且没有配置gesture属性,则页面中图片无法通过点击或手势放大查看。

分析结论

没有使用transform属性通过matrix4矩阵对图片进行缩放操作,也没有绑定手势方法,导致无法点击放大或者通过手势放大图片。

修改建议

建议通过transform和matrix控制图片的放大。完整的图片预览缩放功能(包含手势捏合缩放等能力)可以参考图片预览。

以下是简单的缩放功能的代码示例:

import { matrix4 } from '@kit.ArkUI';

@Entry
@Component
struct IndexMatrix {
  @State matrix: matrix4.Matrix4Transit = matrix4.identity().copy(); // 初始化矩阵对象并复制
  @State targetScale: number = 3;
  private lastScaleValue: number = 1; // 上次缩放的比例
  build() {
    Column() {
      Image($r('app.media.startIcon')) // 示例图片
        .width(100)
        .autoResize(false) // 设置图片解码过程中是否对图源自动缩放
        .transform(this.matrix) // 通过matrix控制图片的缩放
        .offset({
          // 上下偏移,避免超出屏幕,可以根据需要调整具体偏移的数值
          y: this.targetScale === 3 ? 100 : 200
        })
        .gesture(
          GestureGroup(
            GestureMode.Exclusive, // 互斥识别,仅识别一种手势
            TapGesture({ count: 1 }).onAction(() => {
              this.lastScaleValue = this.targetScale; // 记录缩放比例
              // 构造缩放矩阵,在原始比例和放大3倍之间切换
              this.matrix = matrix4.identity().scale({
                x: this.targetScale,
                y: this.targetScale
              });
              // 固定缩放比例在1、3之间切换,可以根据需要自行调整
              this.targetScale = this.targetScale === 3 ? 1 : 3;
            }),
            // 双指缩放
            PinchGesture({ fingers: 2, distance: 1 })
              .onActionUpdate((event: GestureEvent) => {
                // 根据双指缩放的事件调整matrix4矩阵的缩放比例
                this.matrix = matrix4.identity().scale({
                  x: this.lastScaleValue * event.scale,
                  y: this.lastScaleValue * event.scale
                }).copy();
              })
          )
        )
    }
    .height('100%')
    .width('100%')
    .padding({ top: 50 })
  }
}