# ZoomImage

**Repository Path**: zhan-weisong/zoom-image

## Basic Information

- **Project Name**: ZoomImage
- **Description**: 鸿蒙JS组件——局部放大图片组件
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2022-10-24
- **Last Updated**: 2023-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 组件介绍

本图片组件在显示图片的基础上附带局部放大功能，在原本设定的图片区域将局部进行放大显示，在不占用其余布局空间的情况下，满足用户仔细欣赏图片细节的需要。实现效果如下：

![效果演示](resource/效果演示.gif)

## 项目结构

![项目结构](resource/项目结构.png)

## 组件开发

### 页面布局

- 为组件绑定doubleclick双击事件和touchmove触屏移动事件，分别用于切换图片缩放和控制局部显示区域移动。

```
<div style="width: {{ imageWidth }}px; height: {{ imageHeight }}px;">
    <canvas src="{{ imageSrc }}" ref="zoom" class="canvas-border"
            @doubleclick="zoomswitch" @touchmove="getmove"></canvas>
</div>
```

### 组件属性参数设置

| 参数名       | 描述           | 参数类型  | 默认值 |
| ----------- | ---------------| -------- | ------ |
| imageWidth  | 设置图片宽度    | Number   | 500    |
| imageHeight | 设置图片高度    | Number   | 500    |
| imageSrc    | 设置图片地址    | String   | 无     |
| scale       | 图片放大的比例  | Number   | 2      |

### 实现原理

- 主要通过canvas组件的drawImage方法实现图片显示。该方法需要输入9个参数，分别是图片对象，原图的X轴裁剪起点，原图的Y轴裁剪起点，裁剪的宽度，裁剪的高度，画布X轴画图的起点，画布Y轴画图的起点，画布的宽度，画布的高度。

```JS
    ctx0.drawImage(changeview,
        this.initwidth / 2 - this.initwidth / this.scale / 2,
        this.initheight / 2 - this.initheight / this.scale / 2,
        changeview.width / this.scale,
        changeview.height / this.scale,
        0, 0,
        this.imageWidth, this.imageHeight);
```

![关于drawImage方法](resource/关于drawImage方法.png)

- 给canvas组件绑定doubleclick双击事件，变化布尔型变量isZoom的值，用于切换局部放大模式和原始视图。

```JS
    zoomswitch() {
        this.isZoom = !this.isZoom;
        let changeview = new Image();
        changeview.src = this.img.src;
        if (true == this.isZoom) {
            console.log("拉近镜头");
            changeview.onload = () => {
                ctx0.drawImage(changeview,
                    this.initwidth / 2 - this.initwidth / this.scale / 2,
                    this.initheight / 2 - this.initheight / this.scale / 2,
                    changeview.width / this.scale,
                    changeview.height / this.scale,
                    0, 0,
                    this.imageWidth, this.imageHeight);
            };
        }
        else {
            console.log("恢复全局视角");
            changeview.onload = () => {
                ctx0.drawImage(changeview,
                    0, 0,
                this.initwidth, this.initheight,
                    0, 0,
                this.imageWidth, this.imageHeight);
            };
        }
    },
```

- 给canvas组件绑定touchmove事件，获取touchmove事件的触点坐标，经过计算得出drawImage方法中的几个关键参数值，并添加判断条件，当触点坐标过于接近边缘时设置极限值。

```JS
    getmove(event) {
        if (false == this.isZoom) {
            return;
        }
        this.points.x = (event.touches[0].localX - this.imageWidth / this.scale / 2) / this.imageWidth * this.initwidth;
        this.points.y = (event.touches[0].localY - this.imageHeight / this.scale / 2) / this.imageHeight * this.initheight;
        if (((this.imageWidth / this.scale / 2) > event.touches[0].localX)
        || ((this.imageWidth - this.imageWidth / this.scale / 2) < event.touches[0].localX)) {
            if ((this.imageWidth / this.scale / 2) > event.touches[0].localX) {
                this.points.x = 0;
            }
            else {
                this.points.x = this.initwidth - this.initwidth / this.scale;
            }
        }
        if (((this.imageHeight / this.scale / 2) > event.touches[0].localY)
        || ((this.imageHeight - this.imageHeight / this.scale / 2) < event.touches[0].localY)) {
            if ((this.imageHeight / this.scale / 2) > event.touches[0].localY) {
                this.points.y = 0;
            }
            else {
                this.points.y = this.initheight - this.initheight / this.scale;
            }
        }
        let newview = new Image();
        newview.src = this.img.src;
        newview.onload = () => {
            ctx0.drawImage(newview,
            this.points.x, this.points.y,
                newview.width / this.scale, newview.height / this.scale,
                0, 0,
            this.imageWidth, this.imageHeight);
        };
    },
```

## 组件引用

- 引用声明

```
<element name="zoomimage" src="common/zoomimage/zoomimage.hml"></element>
```

- 参数传递

```
<zoomimage image-width="660" image-height="550" image-src="common/images/mural.jpg" scale="3"></zoomimage>
```

## 结语

假如大家有自定义组件的创意，可以自己试着实现一下，或是在其他的项目中学习下别人是如何设计开发一个组件的，从一些简单的组件入手对新手来说是很不错的选择。