由于安卓项目涉及到h5页面嵌入,需要查看图片相册集,本来打算使用baguetteBox,但是它不太兼容手机,并且页面效果跟灵活性欠缺,后来在文档中看到PhotoSwipe,虽然开发者很懒,好多东西东西没有嵌入到插件中,但是使用效果还是不错的
首先根据他提供的git,我发现有好多没有用的文件,于是决定不使用composer,直接把有用的文件放入到项目中,可以选择压缩发布版dist,也可以选用src源码版,这里才用的是dist
首先 引入css
<link rel="stylesheet prefetch" href="photoswipe/css/photoswipe.css">
<link rel="stylesheet prefetch" href="photoswipe/css/default-skin/default-skin.css">
js放到最后
<script src="photoswipe/js/photoswipe.js"></script>
<script src="photoswipe/js/photoswipe-ui-default.min.js"></script>
开发者很懒,需要引入它的PhotoSwipe元素到DOM中
<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>
完整的html代码
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, user-scalable=no">
<meta name="apple-touch-fullscreen" content="yes"> <!-- 一会试验下是否有必要存在 -->
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black">
<meta name="format-detection" content="telephone=no">
<meta http-equiv="x-rim-auto-match" content="none"/>
<meta name="HandheldFriendly" content="true"/>
<link rel="stylesheet" href="news_css/news_1.css">
<link rel="stylesheet" href="news_css/news_2.css">
<link rel="stylesheet prefetch" href="photoswipe/css/photoswipe.css">
<link rel="stylesheet prefetch" href="photoswipe/css/default-skin/default-skin.css">
<style>
* {margin: 0;padding: 0;}
.clearfix::before, .clearfix::after {
display: block;
content: '';
visibility: hidden;
height: 100%;
clear: both;
}
body {padding-top: 2%;}
.my-gallery {width:96%;margin: 0 auto;}
.my-gallery .img-dv {width:100%;margin-bottom: 1%;}
.my-gallery .img-dv a {display:block;width:100%;text-align: center}
.my-gallery .img-dv a img {width:100%;}
</style>
</head>
<body>
<div class="wrapper" style="color:#333333;font-size: 15px">
<header class="con_hd infoBg">
<a href="?app=app_order@detail&order_id={$order_id}" class="hd-back"></a>
<h2 class="hd-tit">{$data.name}</h2>
</header>
<div class="my-gallery" data-pswp-uid="1">
{foreach $data['img_list'] $k=>$v}
<figure>
<div class="img-dv"><a href="{$v['value']}" data-size="1920x1080"><img src="{$v['value']}"></a></div>
<figcaption style="display:none;">{$v['name']}</figcaption>
</figure>
{/foreach}
</div>
<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>
</body>
<script src="photoswipe/js/photoswipe.js"></script>
<script src="photoswipe/js/photoswipe-ui-default.min.js"></script>
<script type="text/javascript">
var initPhotoSwipeFromDOM = function(gallerySelector) {
// 解析来自DOM元素幻灯片数据(URL,标题,大小...)
var parseThumbnailElements = function(el) {
var thumbElements = el.childNodes,
numNodes = thumbElements.length,
items = [],
figureEl,
linkEl,
size,
item,
divEl;
for(var i = 0; i < numNodes; i++) {
figureEl = thumbElements[i]; // <figure> element
// 仅包括元素节点
if(figureEl.nodeType !== 1) {
continue;
}
divEl = figureEl.children[0];
linkEl = divEl.children[0]; // <a> element
size = linkEl.getAttribute('data-size').split('x');
// 创建幻灯片对象
item = {
src: linkEl.getAttribute('href'),
w: parseInt(size[0], 10),
h: parseInt(size[1], 10)
};
if(figureEl.children.length > 1) {
item.title = figureEl.children[1].innerHTML;
}
if(linkEl.children.length > 0) {
// <img> 缩略图节点, 检索缩略图网址
item.msrc = linkEl.children[0].getAttribute('src');
}
item.el = figureEl; // 保存链接元素 for getThumbBoundsFn
items.push(item);
}
return items;
};
// 查找最近的父节点
var closest = function closest(el, fn) {
return el && ( fn(el) ? el : closest(el.parentNode, fn) );
};
// 当用户点击缩略图触发
var onThumbnailsClick = function(e) {
e = e || window.event;
e.preventDefault ? e.preventDefault() : e.returnValue = false;
var eTarget = e.target || e.srcElement;
var clickedListItem = closest(eTarget, function(el) {
return (el.tagName && el.tagName.toUpperCase() === 'FIGURE');
});
if(!clickedListItem) {
return;
}
var clickedGallery = clickedListItem.parentNode,
childNodes = clickedListItem.parentNode.childNodes,
numChildNodes = childNodes.length,
nodeIndex = 0,
index;
for (var i = 0; i < numChildNodes; i++) {
if(childNodes[i].nodeType !== 1) {
continue;
}
if(childNodes[i] === clickedListItem) {
index = nodeIndex;
break;
}
nodeIndex++;
}
if(index >= 0) {
openPhotoSwipe( index, clickedGallery );
}
return false;
};
var photoswipeParseHash = function() {
var hash = window.location.hash.substring(1),
params = {};
if(hash.length < 5) {
return params;
}
var vars = hash.split('&');
for (var i = 0; i < vars.length; i++) {
if(!vars[i]) {
continue;
}
var pair = vars[i].split('=');
if(pair.length < 2) {
continue;
}
params[pair[0]] = pair[1];
}
if(params.gid) {
params.gid = parseInt(params.gid, 10);
}
return params;
};
var openPhotoSwipe = function(index, galleryElement, disableAnimation, fromURL) {
var pswpElement = document.querySelectorAll('.pswp')[0],
gallery,
options,
items;
items = parseThumbnailElements(galleryElement);
// 这里可以定义参数
options = {
barsSize: {
top: 100,
bottom: 100
},
fullscreenEl : false,
shareButtons: [
{id:'wechat', label:'分享微信', url:'#'},
{id:'weibo', label:'新浪微博', url:'#'},
{id:'download', label:'保存图片', url:'{{raw_image_url}}', download:true}
],
galleryUID: galleryElement.getAttribute('data-pswp-uid'),
getThumbBoundsFn: function(index) {
var thumbnail = items[index].el.getElementsByTagName('img')[0], // find thumbnail
pageYScroll = window.pageYOffset || document.documentElement.scrollTop,
rect = thumbnail.getBoundingClientRect();
return {x:rect.left, y:rect.top + pageYScroll, w:rect.width};
}
};
if(fromURL) {
if(options.galleryPIDs) {
for(var j = 0; j < items.length; j++) {
if(items[j].pid == index) {
options.index = j;
break;
}
}
} else {
options.index = parseInt(index, 10) - 1;
}
} else {
options.index = parseInt(index, 10);
}
if( isNaN(options.index) ) {
return;
}
if(disableAnimation) {
options.showAnimationDuration = 0;
}
gallery = new PhotoSwipe( pswpElement, PhotoSwipeUI_Default, items, options);
gallery.init();
};
var galleryElements = document.querySelectorAll( gallerySelector );
for(var i = 0, l = galleryElements.length; i < l; i++) {
galleryElements[i].setAttribute('data-pswp-uid', i+1);
galleryElements[i].onclick = onThumbnailsClick;
}
var hashData = photoswipeParseHash();
if(hashData.pid && hashData.gid) {
openPhotoSwipe( hashData.pid , galleryElements[ hashData.gid - 1 ], true, true );
}
};
initPhotoSwipeFromDOM('.my-gallery');
</script>
</html>
就可以使用了
文件和DOM都准备好之后,使用js来调用PhotoSwipe:
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()
就可调用了。
选项设置options
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方法
PhotoSwipe也提供了许多方法调用,以下方法有可能你会用得到:
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
});