xZoom是一款多功能的jquery图片预览放大镜插件。它支持多种图片放大模式,可以和Fancy Box或Magnific Pop-up等插件结合使用,功能非常强大。
使用方法
在页面中引入jquery和xzoom.css以及xzoom.js文件。
<link rel="stylesheet" href="css/xzoom.css"> <script src="jquery.min.js"></script> <script src="js/xzoom.min.js"></script>
HTML结构
xZoom要求使用下面的基本HTML结构,你可以按自己的需求设置图片的数量。
<img class="xzoom" src="path/to/preview_image_01.jpg" xoriginal="path/to/original_image_01.jpg" /> <div class="xzoom-thumbs"> <a href="path/to/original_image_01.jpg"> <img class="xzoom-gallery" width="80" src="path/to/thumbs_image_01.jpg" xpreview="path/to/preview_image_01.jpg"> </a> <a href="path/to/original_image_02.jpg"> <img class="xzoom-gallery" width="80" src="path/to/preview_image_02.jpg"> </a> <a href="path/to/original_image_03.jpg"> <img class="xzoom-gallery" width="80" src="path/to/preview_image_03.jpg"> </a> <a href="path/to/original_image_04.jpg"> <img class="xzoom-gallery" width="80" src="path/to/preview_image_04.jpg"> </a> </div>
初始化插件
在页面DOM元素加载完毕之后,可以通过下面的方法来初始化xZoom插件。
$(".xzoom").xzoom();
配置参数
xZoom图片放大镜插件的可用配置参数如下:
属性 | 默认值 | 描述 |
position | right | 图片放大窗口的位置。可用值有:"top", "left", "right", "bottom", "inside", "lens", "#ID"。 |
rootOutput | true | 该参数可以将输出的放大窗口设置在任何位置。 |
Xoffset | 0 | 图片放大窗口水平位置的偏移。 |
Yoffset | 0 | 图片放大窗口垂直位置的偏移。 |
fadeIn | true | 显示放大图片是否使用淡入效果。 |
fadeTrans | true | 淡入淡出效果的过渡时间。 |
fadeOut | false | 关闭放大图片是否使用淡出效果。 |
smoothZoomMove | 3 | 在大窗口中图片的平滑移动级别,数值越大越平滑。 |
smoothLensMove | 1 | 圆形镜片的平滑移动级别。 |
smoothScale | 6 | 放大缩小的平滑级别。 |
defaultScale | 0 | 放大图片打开时的默认放大级别。-1表示-100%,1表示100%。 |
scroll | true | 是否在滚动鼠标滚轮时放大缩小图片。 |
tint | false | 背景颜色。建议使用十六进制的颜色值。 |
tintOpacity | 0.5 | 背景的透明度,值在0-1之间。 |
lens | false | 放大镜的颜色,建议使用十六进制的颜色值。 |
lensOpacity | 0.5 | 放大镜的透明度。 |
lensShape | box | 放大镜的的形状,"box" 或 "circle"。 |
zoomWidth | auto | 放大镜的宽度,单位像素。 |
zoomHeight | auto | 放大镜的高度,单位像素。 |
sourceClass | xzoom-source | 原图div的class名称。 |
loadingClass | xzoom-loading | 预加载div的class名称。 |
lensClass | xzoom-lens | 放大镜div的class名称。 |
zoomClass | xzoom-preview | 放大窗口div的class名称。 |
activeClass | xactive | 当前缩略图的class名称。 |
adaptive | true | 是否开启自适应功能。 |
lensReverse | false | 当旋转内部放大镜并且该选项为true时,放大镜的移动和显示方向相反。 |
adaptiveReverse | false | 和lensReverse相同,但是只有在adaptive选项为true是有效。 |
title | false | 是否在输出窗口中显示图片标题。 |
titleClass | xzoom-caption | 图片标题div的class名称。 |
bg | false | 放大图片作为背景输出。 |
xZoom图片放大镜插件的github地址为:https://github.com/payalord/xZoom
版权声明
版权说明: 仅限用于学习和研究目的;不得将上述内容用于商业和非法用途!否则一切后果自负。我们非常重视版权问题,如有侵权请邮件至(171373236#qq.com)与我们联系处理,敬请谅解!