#Language
Chinese
English

一款用于图片滚动放大拖动，且可以添加标记的jQuery插件

在项目中需要实现类似地图应用那样的，具有鼠标滚动缩放和拖动功能的插件效果，且可以添加具有回调功能的标记点。在网上找了一圈都没有找到合适的，所以图方便自己写了一个。
如有任何功能问题或改进意见，欢迎反馈，感谢。

点击这里查看使用ZoomMarker和EasyLoading构建的图片拖拽、缩放、标记及加载动画的示例，使用鼠标或触屏点击在图片上添加标记点，鼠标悬浮在上面查看悬浮提示窗口，使用顶部按钮实现图片切换、清空标记点和加载动画示例等。
点击这里查看带的分区域显示的例子。

在本例子中，还使用了自行编写的开源加载动画插件EasyLoading，该插件同样需要jQuery支持。 如果您对EasyLoading感兴趣，欢迎加星。

引入ZoomMarker的JavaScript和CSS文件

<link rel="stylesheet" href="css/zoom-marker.css">
<script src="js/zoom-marker.js"></script>

引入第三方依赖库

<script src="js/jquery-1.11.3.min.js"></script>
<script src="js/jquery.mousewheel.min.js"></script>
<script src="js/hammer.min.js"></script>

在示例中，使用了图像加载动画，为此您还需要引入EasyLoading插件，它也可以单独使用。如果您的项目中不需要使用加载动画，则不需要 引入该插件。

<link rel="stylesheet" href="css/easy-loading.css">
<script src="js/easy-loading.js"></script>

添加必要的html标签，注意img标签必须包含唯一的id属性

<div id="zoom-marker-div" class="zoom-marker-div">
    <img class="zoom-marker-img" id="zoom-marker-img" alt="..." name="viewArea"  draggable="false"/>
</div>

在ready()中调用初始化方法

$(document).ready(function () {
    $('#zoom-marker-img').zoomMarker({
        src: "img/mountain.jpg",
        rate: 0.2,
        width: 600,
        max: 3000,
        markers:[
            {src:"img/marker.svg", x:500, y:500}
            ]
    });
})

在上述例子中，你还需要在img/目录下添加一个名为moutain.jpg的文件用于显示图片，在img/目录下添加名为marker.svg的文件作为marker文件资源，我们已经在该工程对应目录下添加这两个文件。 现在你可以看到效果了，单击鼠标拖动图片，鼠标滚轮滚动放大缩小图片，添加的标记也会跟着移动。

Canvas画布功能在图片div标签上覆盖一层Canvas绘图层，可通过该图层绘制图形。 为了使用Canvas画布功能，需要在初始化ZoomMarker对象时手动配置enable_canvas为true。

$('#zoom-marker-img').zoomMarker({
    src: "img/mountain.jpg",
    rate: 0.2,
    width: 400,
    max: 3000,
    markers:[
        {src:"img/marker.svg", x:200, y:200}
    ],
    enable_canvas: true
});

Canvas图层的大小和图片的实际像素大小相同。 如下例子在鼠标点击图像时，手动绘制一条从[100, 100]坐标出发，至点击坐标点结束的红线。

item.on("zoom_marker_mouse_click", function(event, position){
    // 画线
    const context = item.zoomMarker_Canvas();
    if(context !== null) {
        context.strokeStyle = 'red';
        context.moveTo(position.x, position.y);
        context.lineTo(100,100);
        context.stroke();
    }
});

初始化时可传入以下可选参数。

缺省值0.2 该浮点型参数决定了图片滚动放大时的速率，值越大图片缩放速度越快，范围{0, 1}。

缺省值null，不加载图片 图片加载的路径

用于配置图片加载后的宽度，请不要使用100%之类的相对宽度定位，会影响ZoomMarker的工作。 如果你要使图片的宽度与父节点宽度相同，可以使用jQuery的方法获取父节点宽度，或直接获取"zoom-marker-div"标签的宽度，如：

$("#zoom-marker-img").parent().width();
$("#zoom-marker-div").width();

限定图片缩放的最小宽度，默认最小宽度为300px。

限定图片缩放的最大宽度，默认不做限制。

记录了标记点的参数，包含以下几个参数。

{
    src: "img/marker.png",   // (required)图片加载路径
    x: 500,                  // (required)标记点在图片中的X坐标
    y: 500,                  // (required)标记点在图片中的Y坐标
    click: function(object){
        // 点击回调方法，object为marker的jQuery对象
    }
}

标记点尺寸只能为正方形，通过这个参数可以配置标记点的大小，你也可以在"zoomMarker_AddMarker"添加标记点方法中通过参数配置单个标记点的大小。

是否允许当前图像拖拽

自动管理图像和标记点的层级信息，在点击和拖拽的时候自动将当前图像和标记点置顶

添加Canvas绘图层，因为可能影响性能，默认关闭

缩放锁定，开启则以图片中点作为缩放中点，默认关闭 关闭状态下以鼠标或双指缩放中心作为图片放大或缩小的中点

拖动锁边，开启则只允许图片在父容器内部拖动

ZoomMarker的方法全都以"zoomMarker_"开头，直接在你的图片标签jQuery对象上使用jQuery插件的方法调用即可，如清空所有标记点：

    $("#viewArea").zoomMarker_CleanMarker();

用于加载图像，src传入图片URL或本地路径。

缩放图片。

移动图片位置，笛卡尔坐标系，左上角坐标为(0, 0)。

添加标记点并返回添加标记点的相关参数，marker的配置参数如下表所示。 配置中的"x"和"y"参数均为标记点在图像中的坐标位置。

删除标记点，传入标记点ID，ID可从"zoomMarker_AddMarker(marker)"返回结构体中的"id"项获取。

清空所有标记点。

获取加载图片的真实尺寸，只有当图片加载结束的时候才会返回正确的图片尺寸。

设置是否允许图像拖动。

图像和对应的标记点有层级关系，通过这个方法将当前图像和标记点层级置顶。

需要在初始化图像时配置enable_canvas参数为true。 获取Canvas的上下文context，通过Canvas绘图方法在图像上绘制图形。 需要注意的是，绘图坐标都是以图像的分辨率为基准。

清空Canvas的绘图数据。

重置图像尺寸和位置，包括marker和canvas信息。

有网友反馈在移动端加载新图片后，标记点会发生漂移，手动拖拽图片后图标位置恢复正常。
个人判断是因为不同浏览器的onload图像加载回调触发时间节点不一样导致的，因此添加这个接口，供用户手动重新加载标记点。

通过"on"或"bind"监听ZoomMarker发送的事件。

// 监听图片资源加载结束消息，更新UI资源。
$('#zoom-marker-img').on("zoom_marker_img_loaded", function(event, size){
    console.log("image has been loaded with size: "+JSON.stringify(size));
    /** 更新UI操作 **/
    ...
});