简介
ImageViewZoom 支持加载 Resource 或 PixelMap 图片，支持设置图像显示类型功能，支持缩放功能，支持平移功能，双击放大功能，可以监听图片大小，资源变化事件，支持清除显示图片功能。
效果展示
下载安装
bash
ohpm install @ohos/imageviewzoom 使用说明
ets 代码依赖
ts
import {ImageViewTouchDate, ImageViewTouch, DisplayType} from "@ohos/imageviewzoom"
import {PixelMapUtils} from "./PixelMapUtils"
...
//创建model对象
@State private model: ImageViewTouch.Model = new ImageViewTouch.Model();
...
//使用ImageViewTouch组件
ImageViewTouch({ model: $model });
...在Swiper组件内使用，如果有图片放大后切图的场景，需要在Swiper组件的onAnimationEnd方法内调用gestureConversion方法，调整手势方向，以避免图片index未变化时，出现手势竞争问题，如下所示：
ts
if (this.currentIndex == index && this.data[this.currentIndex].getScale() > 1) {
this.data[this.currentIndex].gestureConversion(PanDirection.All, SwipeDirection.None)
}DD一下： 欢迎大家关注工粽号<程序猿百晓生>，可以了解到以下知识点。
erlang
`欢迎大家关注工粽号<程序猿百晓生>，可以了解到以下知识点。`
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.鸿蒙版性能优化指南
.......接口说明
-
设置图片资源
public setImageSrc(src ?: Resource | PixelMap | string | null, matrix ?: object | null, minZoom ?: number, maxZoom ?: number): voidsetImageSrc接口新增src参数的string类型 -
设置默认图像显示类型
public setDisplayType(type: DisplayType)public getDisplayType(): DisplayType
DisplayType.NONE：图像默认不缩放。 DisplayType.FIT_TO_SCREEN：图像将始终使用此视图的边界呈现。 DisplayType.FIT_IF_BIGGER：仅当大于此视图的边界时才会缩放图像。 DisplayType.FIT_HEIGHT：图像将被缩放以适合设备的高度。 DisplayType.FIT_WIDTH：图像将被缩放以适合设备的宽度。
-
清除当前显示的图片
public dispose(): void -
设置是否能够双击
public setDoubleTapEnabled(value: boolean): void -
设置是否能够缩放
public setScaleEnabled(value: boolean): void -
设置是否能够滚动
public setScrollEnabled(value: boolean): void -
设置图片资源变化监听事件
public setOnDrawableChangedListener(listener: OnDrawableChangeListener): void -
设置图片大小变化监听事件
public setOnLayoutChangeListener(listener: OnLayoutChangeListener): void -
恢复显示
public resetDisplay(): void -
恢复视图矩阵
public resetMatrix(): void
- 获取当前允许的最大图像比例
public getMaxScale(): number
- 获取当前允许的最小图像比例
public getMinScale(): number
- 设置当前视图矩阵
public setImageMatrix(matrix: object): void
- 返回当前视图矩阵
public getImageViewMatrix(): object
- 打印矩阵详细信息
public printMatrix(matrix: object): void
- 返回当前视图比例
public getScale(): number
- 缩放到目标比例
public zoomTo(scale: number, durationMs: number): void
DD一下： 欢迎大家关注工粽号<程序猿百晓生>，可以了解到以下知识点。
erlang
`欢迎大家关注工粽号<程序猿百晓生>，可以了解到以下知识点。`
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.鸿蒙版性能优化指南
.......- 设置是否能够双击
public setDoubleTapEnabled(value: boolean): void
- 设置是否能够缩放
public setScaleEnabled(value: boolean): void
- 返回是否能够双击状态值
public getDoubleTapEnabled(): boolean
- 判断图片能否根据手势滚动
public canScroll(): boolean
- 设置双击监听事件
public setDoubleTapListener(listener: OnImageViewTouchDoubleTapListener): void
- 设置单击监听事件
public setSingleTapListener(listener: OnImageViewTouchSingleTapListener): void
- 设置滑动手势与拖拽手势的方向
public gestureConversion(panDirection: PanDirection, swipeDirection?: SwipeDirection, vertical?: boolean)
gestureConversion接口是用于处理拖拽手势PanGesture和滑动手势SwipeGesture的手势竞争问题，通过动态的设置两个手势的触发方向，解决手势竞争。
- 图片资源变化监听
onDrawableChanged(src: Resource | PixelMap | string): void onDrawableChanged方法新增src参数的string类型
约束与限制
在下述版本验证通过：
- DevEco Studio: NEXT Beta1-5.0.3.806,SDK:API12 Release(5.0.0.66)
- DevEco Studio NEXT Developer Beta3: 5.0(5.0.3.530), SDK: API12 (5.0.0.35(SP3))
目录结构
lua
|---- ImageViewZoom
| |---- entry # 示例代码文件夹
| |---- library # ImageViewZoom库文件夹
| |----src
| |----main
| |----ets
| |---- components
| |---- utils # 工具库
| |---- IDisposable.ets # 提供清除图片接口
| |---- ImageViewTouch.ets # 自定义控件
| |---- index.ets # 对外接口
| |---- README.MD # 安装使用方法
| |---- README_zh.MD # 安装使用方法
| |---- LICENSE #证书