纯血鸿蒙APP实战开发——图片缩放效果实现

原创

小帅聊鸿蒙

发布于 2025-01-23 14:08:30

1070

文章被收录于专栏：鸿蒙开发笔记鸿蒙开发笔记

介绍

图片预览在应用开发中是一种常见场景，在诸如QQ、微信、微博等应用中均被广泛使用。本模块基于Image组件实现了简单的图片预览功能。

使用说明：

双指捏合对图片进行缩放
双击图片进行图片的大小切换，在放大状态下，双击可恢复默认状态
图片在放大模式下，滑动图片查看图片的对应位置

效果图预览

实现思路

使用matrix实现图片的缩放。

    @State matrix: matrix4.Matrix4Transit = matrix4.identity().copy();
    Image(this.imagePixelMap)
        .transform(this.matrix)

使用offset属性对图片进行偏移。

    @State imageOffsetInfo: OffsetModel = new OffsetModel(0, 0);
    Image(this.imagePixelMap)
        .offset({
            x: this.imageOffsetInfo.currentX,
            y: this.imageOffsetInfo.currentY
        })

Image的objectFit属性设置为Cover，锁定图片宽高比，并使其能够超出父组件边界显示。

   Image(this.imagePixelMap)
       .objectFit(ImageFit.Cover)

DD一下：`欢迎大家关注公众号<程序猿百晓生>，可以了解到一下知识点。`

1.OpenHarmony开发基础
2.OpenHarmony北向开发环境搭建
3.鸿蒙南向开发环境的搭建
4.鸿蒙生态应用开发白皮书V2.0 & V3.0
5.鸿蒙开发面试真题（含参考答案） 
6.TypeScript入门学习手册
7.OpenHarmony 经典面试题(含参考答案)
8.OpenHarmony设备开发入门【最新版】
9.沉浸式剖析OpenHarmony源代码
10.系统定制指南
11.【OpenHarmony】Uboot 驱动加载流程
12.OpenHarmony构建系统--GN与子系统、部件、模块详解
13.ohos开机init启动流程
14.鸿蒙版性能优化指南
.......

提前计算图片信息，并通过Image的宽或高配合aspectRatio设置默认尺寸。

   initCurrentImageInfo(): void {
       this.matrix = matrix4.identity().copy();
       const imageSource: image.ImageSource = image.createImageSource(this.imageUri);
       imageSource.getImageInfo(0).then((data: image.ImageInfo) => {
           this.imageWHRatio = data.size.width / data.size.height;
           this.imageDefaultSize = this.calcImageDefaultSize(this.imageWHRatio, windowSizeManager.get());
           if (this.imageDefaultSize.width === windowSizeManager.get().width) {
               this.fitWH = "width";
           } else {
               this.fitWH = "height";
           }
           this.imageScaleInfo.maxScaleValue += this.fitWH === "width" ? 
               (windowSizeManager.get().height / this.imageDefaultSize.height) : 
               (windowSizeManager.get().width / this.imageDefaultSize.width);
       }).catch((err: BusinessError) => {
           console.error(`[error][getImageInfo]${err.message}`);
       });
       imageSource.createPixelMap().then((data: image.PixelMap) => {
           this.imagePixelMap = data;
       }).catch((err: BusinessError) => {
           console.error(`[error][createPixelMap]${err.message}`);
       });
   }
   
   Image(this.imagePixelMap)
      .width(this.fitWH === "width" ? $r("app.string.image_default_width") : undefined)
      .height(this.fitWH === "height" ? $r("app.string.image_default_height") : undefined)
      .aspectRatio(this.imageWHRatio)

工程结构&模块类型

imageviewer                                     // har类型
|---constants                                   // 常量
|---model                                       // 模型层-自定义数据模型
|---utils                                       // 工具类
|---view                                        // 视图层-图片预览方案涉及的主要组件
|---|---ImageViewerView.ets                     // 视图层-入口
|---|---ImageItemView.ets                       // 视图层-单张图片的显示组件