最近在開發項目的時候,遇到一個需求,需要移動端實現放大查看圖片的功能,然後我就在網上搜索了一下資料,看到了photoswipe這個插件,後來試了試,確實挺好用的,它可以實現手勢放大縮小查看圖片,左右滑動切換圖片以及上下滑動關閉大圖。現在簡單分享一下。
一、需要引入的css和js文件、
頁面中需要引入如下文件:photoswipe.css,default-skin.css,photoswipe.js,photoswipe-ui-default.min.js
首先可以到它的官網或者github網站上下載插件,就可以找到需要的資源,官網地址:http://photoswipe.com;GitHub網址:https://github.com/dimsemenov/PhotoSwip
二、html頁面中需要添加如下部分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>
放置圖片部分的html代碼按照如下結構:
<div class="my-gallery" data-pswp-uid="1">
<figure>
<div class="img-dv"><a href="img/img1-big.jpg" data-size="1920x1080"><img src="img/img1.jpg"></a></div>
<figcaption style="display:none;">在這裏可增加圖片描述</figcaption>
</figure>
<figure>
<div class="img-dv"><a href="img/img1-big.jpg" data-size="1920x1080"><img src="img/img1.jpg"></a></div>
<figcaption style="display:none;">在這裏可增加圖片描述</figcaption>
</figure>
<figure>
<div class="img-dv"><a href="img/img1-big.jpg" data-size="1920x1080"><img src="img/img1.jpg"></a></div>
<figcaption style="display:none;">在這裏可增加圖片描述</figcaption>
</figure>
</div>
三、完整代碼
以下是完整代碼
<!doctype html> <html> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no"> <meta name="apple-mobile-web-app-capable" content="yes"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <title>photoswipe的使用</title> <link rel="stylesheet prefetch" href="css/photoswipe.css"> <link rel="stylesheet prefetch" href="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> <!--如果有多個data-pswp-uid 它的值是不能重複的--> <div class="my-gallery" data-pswp-uid="1"> <figure> <div class="img-dv"><a href="img/img1-big.jpg" data-size="1920x1080"><img src="img/img1.jpg"></a></div> <figcaption style="display:none;">在這裏可增加圖片描述</figcaption> </figure> <figure> <div class="img-dv"><a href="img/img2-big.jpg" data-size="1920x1080"><img src="img/img2.jpg"></a></div> <figcaption style="display:none;">在這裏可增加圖片描述2</figcaption> </figure> <figure> <div class="img-dv"><a href="img/img3-big.jpg" data-size="1920x1080"><img src="img/img3.jpg"></a></div> <figcaption style="display:none;">在這裏可增加圖片描述3</figcaption> </figure> </div> <!--該段代碼用於顯示大圖功能,必須加到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> </body> <script src="js/photoswipe.js"></script> <script src="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>
需要注意的是:
1.下載完的插件在引用css和js的時候,需要按格式來引入,
直接將default-skin文件夾放在css裏面,和photoswipe.css同等級,引入的時候引用default-skin文件夾下的default-skin.css。反之,如果直接將default-skin.css和photoswipe.css放到css文件下,會導致圖片無法左右滑動查看,而且圖標也顯示不出來。
js直接放在js文件夾就行。
2.用過photoswipe做移動端圖片預覽的小夥伴都知道,這個插件存在一個data-size,必須要填寫,但是如果你的圖片尺寸比例不是固定的,那這個屬性就會帶來無盡的煩惱,我個人在使用jQuery時,發現一種解決辦法
window.onload=function(){
auto_data_size();
};
function auto_data_size(){
var imgss= $("figure img");
$("figure img").each(function() {
var imgs = new Image();
imgs.src=$(this).attr("src");
var w = imgs.width,
h =imgs.height;
$(this).parent("a").attr("data-size","").attr("data-size",w+"x"+h);
})
};