PhotoSwipe.js 相册展示插件学习

PhotoSwipe是一个开发用于手机和Touch设备,功能强大的图片/照片集展示控件。它采用HTML、CSS+JavaScript实现,没有依赖任何JavaScript框架。

可以设置淡入/淡出的效果,激活放大功能,缩放图片等。PhotoSwipe支持的设备包括:iPhone、iPad、Android、Blackberry和桌面浏览器。它还有一个可选基于jQuery实现的版本。

photoswipe.jpg

优点:

  • 界面美观,简易的人性化操作

  • 兼容移动设备,图像展示友好。

  • 纯JS,不依赖其它JS库,轻量级!比FancyBox小太多太多了

官方网站:http://www.photoswipe.com/

源码示例:http://github.com/downloads/codecomputerlove/PhotoSwipe/code.photoswipe-3.0.5.zip

Github:https://github.com/codecomputerlove/PhotoSwipe

在线demo:http://www.photoswipe.com/latest/examples/04-jquery-mobile.html

如何使用

一、引入Css和Js文件:

<!-- photoswipe 之前先引用klass,如果需要提高加载速度,可以给 script 加上 defer 标记/属性-->  
<script type="text/javascript" src="klass.min.js"></script>

<!-- 重要提示,如果不使用jQuery版本,在IE下面会出错,当然,使用jQuery版本,则需要引入jQuery-->  
<script type="text/javascript" src="code.photoswipe-3.0.5.min.js"></script>

二、然后页面结构可以是这样子的:

<!-- ul li 之类是用于显示缩略图的,也可以根据需要调整.<a>下面的<img> 元素,即为缩略图,如果不需要,则src设置为空即可 -->  
<ul id="Gallery">  
    <li><a href="images/full/01.jpg"><img src="images/thumb/01.jpg" alt="Image 01" /></a></li>  
    <li><a href="images/full/02.jpg"><img src="images/thumb/02.jpg" alt="Image 02" /></a></li>  
    <li><a href="images/full/03.jpg"><img src="images/thumb/03.jpg" alt="Image 03" /></a></li>  
    <li><a href="images/full/04.jpg"><img src="images/thumb/04.jpg" alt="Image 04" /></a></li>  
    <li><a href="images/full/05.jpg"><img src="images/thumb/05.jpg" alt="Image 05" /></a></li>  
    <li><a href="images/full/06.jpg"><img src="images/thumb/06.jpg" alt="Image 06" /></a></li>  
</ul>

其实在这段html代码中除了页面结构外,真正有用的只有 id="Gallery"和<a href="图片路径"></a>(在后面会有说明),其他的class神马的只是起到美化最初的页面结构的作用(和你真正想要的效果的页面不同,也就是说,你只要按照上述页面的结构进行排版,你想要的页面效果是插件js自身完成的,是不需要你写效果布局的)。

页面需要的js和页面结构都有了,下面就是使用插件了。

三、你可以采用两种方式进行插件的声明:

1、是用浏览器默认的方式addEventListener()的方式进行

document.addEventListener("DOMContentLoaded", function () {
    Code.photoSwipe('a', '#Gallery'); //此处就涉及到上述页面结构中的  id="Gallery"和<a href="..."></a>,其中id="Gallery"是容器,
                           //<a href="图片路径"></a>,此处href中一定是当前所指向的图片的路径
}, false);

2、使用Jquery的方式:

$(document).ready(function(){
    $("#Gallery a").photoSwipe();
});

属性对照表

属性描述
allowUserZoom允许用户双击放大/移动方式查看图片. 默认值 = true
autoStartSlideshow当PhotoSwipe激活后,自动播放幻灯片. 默认值 = false
allowRotationOnUserZoom只有 iOS 支持 - 允许用户在缩放/平移模式下 用手势旋转图像. 默认值 = false
backButtonHideEnabled按返回键隐藏相册幻灯片. 主要是 Android 和 Blackberry使用. 支持 BB6, Android v2.1, iOS 4 以及更新版本. 默认值 = true
captionAndToolbarAutoHideDelay标题栏和工具栏自动隐藏的延迟时间. 默认值为 = 5000(毫秒). 如果设为 0 则不会自动隐藏(tap/单击切换显隐)
captionAndToolbarFlipPosition标题栏和工具栏切换位置(让 caption显示在底部而 toolbar显示在顶部). 默认值 = false
captionAndToolbarHide隐藏 标题栏和工具栏. 默认值 = false
captionAndToolbarOpacity标题栏和工具栏 的透明度(0-1). 默认值 = 0.8
captionAndToolbarShowEmptyCaptions即使当前图片的标题是空,也显示标题栏. 默认值 = true
cacheMode缓存模式,Code.PhotoSwipe.Cache.Mode.normal (默认,正常) 或者 Code.PhotoSwipe.Cache.Mode.aggressive(激进,积极). 决定 PhotoSwipe 如何管理图片缓存 cache
Aggressive模式将会积极地地设置非 "当前,上一张,下一张"的图片为空的类型. 对于老版本iOS 浏览器下的大图片内存溢出将会很有用. 大多数情况下,normal模式就可以了
doubleTapSpeed双击的最大间隔. 默认值 = 300(毫秒)
doubleTapZoomLevel当用户双击的时候,放大的倍数, 默认的 "zoom-in"(拉近) 级别. 默认值 = 2.5
enableDrag允许拖动上一张/下一张图片到当前界面. 默认值 = true
enableKeyboard允许键盘操作(左右箭头切换,Esc退出,Enter自动播放,空格键 显/隐标题栏/退出). 默认 = true
enableMouseWheel允许鼠标滚轮操作. 默认 = true
fadeInSpeed淡入效果元素的速度(持续时间),毫秒. 默认 = 250
fadeOutSpeed淡出效果元素的速度(持续时间),毫秒. 默认 = 250
imageScaleMethod图片缩放方法(模式). 可选值: "fit", "fitNoUpscale" 和 "zoom". 模式"fit" 保证图像适应屏幕. "fitNoUpscale" 和 "fit"类似但是不会放大图片. "zoom"将图片全屏, 但有可能图片缩放不是等比例的. 默认 = "fit"
invertMouseWheel反转鼠标滚轮。默认情况下,鼠标向下滚动将切换到下一张,向上切换到上一张 . 默认 = false
jQueryMobile

指示 PhotoSwipe 是否集成进了 jQuery Mobile 项目. 默认情况下, PhotoSwipe will try and work this out for you

jQueryMobileDialogHash

jQuery Mobile的window,dialog页面 所使用的hash标签。 默认值 = "&ui-state=dialog"

loop相册是否自动循环. 默认 = true
margin两张图之间的间隔,单位是像素. 默认 = 20
maxUserZoom最大放大倍数. 默认 = 5.0 (设置为0将被忽略)
minUserZoom图像最小的缩小倍数. 默认 = 0.5 (设置为0将会忽略)
mouseWheelSpeed响应鼠标滚轮的灵敏度. 默认 = 500(毫秒)
nextPreviousSlideSpeed当点击上一张,下一张按钮后,延迟多少毫秒执行切换. 默认 = 0 (立即切换)
preventHide阻止用户关闭 PhotoSwipe. 同时也会隐藏 工具栏上的"close"关闭按钮. 在独享的页面使用 (示例是源码中的 examples/08-exclusive-mode.html). 默认 = false
preventSlideshow阻止自动播放模式. 同时也会隐藏工具栏里的播放按钮. 默认 = false
slideshowDelay自动播放模式下,多长时间播放下一张. Default = 3000(毫秒)
slideSpeed图片滑进视图的时间. 默认 = 250(毫秒)
swipeThreshold手指滑动多少像素才触发一个 swipe 手势事件. 默认 = 50
swipeTimeThreshold定义触发swipe(滑动)手势的最大毫秒数,太慢了则不会触发滑动,只会拖动当前照片的位置. 默认 = 250
slideTimingFunction滑动时的 Easing function . 默认 = "ease-out"
zIndex初始的zIndex值. 默认 = 1000
enableUIWebViewRepositionTimeout检查设备的方向是否改变。默认 = false
uiWebViewResetPositionDelay定时检查设备的方向是否改变的时间 默认 = 500(毫秒)
preventDefaultTouchEvents阻止默认的touch事件,比如页面滚动。 默认 = true
target必须是一个合法的DOM元素(如DIV)。默认是window(全页面)。而如果是某个低级别的DOM,则在DOM内显示,可能非全屏


如果不需要展示第一个页面直接展示第二个页面,可以这样设置:

$(document).ready(function(){    
    // Set up PhotoSwipe, setting "preventHide: true"
    var thumbEls = Code.photoSwipe('a', '#Gallery', { preventHide: true });
    Code.PhotoSwipe.Current.show(0);
});

当然这个插件还有很多其他的监听函数:

document.addEventListener('DOMContentLoaded',function(){
    //onBeforeShow 在gallery将要展示之前调用该方法
  Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onBeforeShow,function(e){
    console.log("onBeforeShow");
});

// onshow 在gallery展示的时候调用
Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onShow,function(e){
    console.log("onShow");
});

// onBeforeHide 在gallery隐藏之前
Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onBeforeHide, function(e){            
  console.log('onBeforeHide');            
});

// onHide 在Gallery隐藏的时候
Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onHide, function(e){
   console.log('onHide');           
});

// onShowNext  在展示下一个的时候
Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onShowNext, function(e){
    console.log('onShowNext');
});

// onShowPrevious 在展示上一个的时候
Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onShowPrevious, function(e){
    console.log('onShowPrevious');
});

// onDisplayImage 在图片展示
Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onDisplayImage, function(e){
   console.log('onDisplayImage');
});

// onResetPosition 当Gallery的大小和位置发生变化时或者设备的方向或者窗口大小改变时,出发该方法
Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onResetPosition, function(e){
   console.log('onResetPosition');
});

// onSlideshowStart 当gallery开始滑动展示的时候(此方法可能是我理解有误,实验过程中一直没有触发过
的),原文是:When the gallery has started the slideshow
Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onSlideshowStart, function(e){
   console.log('onSlideshowStart');
});

// onSlideshowStop 当Gallery活动结束的时候
Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onSlideshowStop, function(e){
   console.log('onSlideshowStop');
});

// onBeforeCaptionAndToolbarShow 在顶部状态栏和底部的工具栏展示之前触发
Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onBeforeCaptionAndToolbarShow, function(e){
   console.log('onBeforeCaptionAndToolbarShow');
});

// onBeforeCaptionAndToolbarHide 在顶部状态栏和底部的工具栏隐藏之前触发
Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onBeforeCaptionAndToolbarHide, function(e){
   console.log('onBeforeCaptionAndToolbarHide');
});

// onViewportClick 在gallery中点击屏幕的时候触发,此时一般会触发onBeforeCaptionAndToolbarShow或者onBeforeCaptionAndToolbarHide 方法
Code.PhotoSwipe.Current.addEventListener(Code.PhotoSwipe.EventTypes.onViewportClick, function(e){
       console.log('onViewportClick');
    });
},false);

参考文章:

http://photoswipe.com/documentation/getting-started.html

http://blog.csdn.net/renfufei/article/details/10360855




未经允许请勿转载:程序喵 » PhotoSwipe.js 相册展示插件学习

点  赞 (1) 打  赏
分享到: