在类似于朋友圈动态中,时常会配有图片,但是图片常常不能展示完全,所以需要放大来浏览图片。
今天利用PhotoSwipe进行图片预览的功能;
首先放出PhotoSwipe的github地址:PhotoSwipe
下面是我在项目中的使用:
1.首先需要引用
<link rel="stylesheet" type="text/css" href="../js/common/photoSwipe/default-skin/default-skin.css" />
<link rel="stylesheet" type="text/css" href="../js/common/photoSwipe/photoswipe.css" />
<script src="../js/common/photoSwipe/photoswipe-ui-default.min.js" type="text/javascript" charset="utf-8"></script>
<script src="../js/common/photoSwipe/photoswipe.min.js" type="text/javascript" charset="utf-8"></script>
2.添加PhotoSwipe元素到DOM中
我们可以使用JS动态的将html代码添加到页面中,也可以在页面的</body>中直接添加html代码。
<div class="pswp" tabindex="-1" role="dialog" aria-hidden="true">
<div class="pswp__bg"></div>
<div class="pswp__scroll-wrap">
<div class="pswp__container">
<div class="pswp__item"></div>
<div class="pswp__item"></div>
<div class="pswp__item"></div>
</div>
<div class="pswp__ui pswp__ui--hidden">
<div class="pswp__top-bar">
<div class="pswp__counter"></div>
<button class="pswp__button pswp__button--close" title="Close (Esc)"></button>
<button class="pswp__button pswp__button--share" title="Share"></button>
<button class="pswp__button pswp__button--fs" title="Toggle fullscreen"></button>
<button class="pswp__button pswp__button--zoom" title="Zoom in/out"></button>
<div class="pswp__preloader">
<div class="pswp__preloader__icn">
<div class="pswp__preloader__cut">
<div class="pswp__preloader__donut"></div>
</div>
</div>
</div>
</div>
<div class="pswp__share-modal pswp__share-modal--hidden pswp__single-tap">
<div class="pswp__share-tooltip"></div>
</div>
<button class="pswp__button pswp__button--arrow--left" title="Previous (arrow left)">
</button>
<button class="pswp__button pswp__button--arrow--right" title="Next (arrow right)">
</button>
<div class="pswp__caption">
<div class="pswp__caption__center"></div>
</div>
</div>
</div>
</div>
3.初始化
var pswpElement = document.querySelectorAll('.pswp')[0];
var items = [
{
src: 'https://placekitten.com/600/400',
w: 600,
h: 400
},
{
src: 'https://placekitten.com/1200/900',
w: 1200,
h: 900
}
];
var options = {
index: 0 // start at first slide
};
var gallery = new PhotoSwipe( pswpElement, PhotoSwipeUI_Default, items, options);
gallery.init();
pswpElement
是指定位当前图片展示区域的元素,PhotoSwipeUI_Default
是UI样式,items
是滑动图片组,数组形式,options
是选项设置。
通过new PhotoSwipe()
就可调用了。
一些其他选项设置
PhotoSwipe提供了丰富的选项设置,可以满足各种开发需求。以下列举一些常用的选项:
index
:开始的滑块(图片),必须为数字,默认0(第一张)
showHideOpacity
:当调用时是否展示透明度和比例变化动画,默认false。
showAnimationDuration
:展示动画过渡时间,默认333,数字。
hideAnimationDuration
:隐藏动画过渡间隔时间,默认333,数字。
maxSpreadZoom
:最大放大倍数。
loop
:是否循环展示图片,当左右滑动图片时。
closeOnScroll
:在页面上滚动关闭图集, 仅适用于没有硬件触摸支持的设备。
escKey
:是否可以使用Esc键关闭图集,默认true。
arrowKeys
:是否可以使用左右方向键导航切换,默认true。
history
:是否使用history模式,默认true,历史记录模式支持url返回。
galleryUID
:当多个图集时,用来表示某个图集,默认1,数字,URL会变成http://example.com/#&gid=1&pid=2
galleryPIDs
:表示某一张图片,配合图集galleryUID
一起使用。
preload
:预加载,数组,默认[1,1],是指在切换图片时,预先懒加载前后图片的张数,不能小于1。
API
var pswp = new PhotoSwipe( /* ... */ );
pswp.init(); //初始化
pswp.goTo(index); //跳到第几张图
pswp.next(); //下一张
pswp.prev(); //上一张
pswp.close(); //关闭图集
pswp.destroy(); //关闭图集后销毁图集
// 动态添加图片
pswp.items.push({
src: "path/to/image.jpg",
w:1200,
h:500
});
PS:
使用PhotoSwipe需要知道图片的宽和高,那如何获取图片的宽高呢?
var items = [];
var _index = 0;
$(".imgView").each(function(index){
var _src = $(this).attr('src');
if (thisSrc == _src) {
_index = index
}
var _img = new Image();
_img.src = _src;
// 判断是否有缓存
if(_img.complete){
items.push({
src: _src,
w: _img.width,
h: _img.height
})
}else{
_img.onload = function(){
items.push({
src: _src,
w: _img.width,
h: _img.height
})
}
};
})
需要注意的时候在img.onload的时候才会有宽高,没有完成图片加载直接取图片宽高会出现值为0的情况。
另外在图片已经加载完成了,下一次图片会从缓存里面去取,所以不会执行onload,因此需要判断图片是否从缓存里面取的,
从缓存里面取的话就直接获取图片宽高就行