手機版的相簿需要能左右滑動切換、雙指縮放、雙擊放大,還要在放大後拖曳平移。這些手勢用原生事件實作相當繁瑣,這個元件以 zepto.js(相容 jQuery 語法、體積小適合行動裝置)為基礎,把整套互動封裝成一個 ImageView(index, imgData) 函式。
ImageView(index, imgData); // index 預設顯示的圖片索引,Number // imgData 圖片網址陣列,Array
使用前需先引入 zepto.js。
/*
* ImageView v1.0.0
* --基於 zepto.js 的大圖查看
* --調用方法 ImageView(index, imgData)
* --index 圖片默認顯示索引, Number
* --imgData 圖片 url 數組, Array
* */
var ImageView = (function(window, $){
var _this = $("#slideView"), _ImgData = [], _index = 0, _length = 0,
_start = [], _org = [], _orgTime = null,
_lastTapDate = null,
_zoom = 1, _zoomXY = [0, 0], _transX = null,
_advancedSupport = false,
_doubleDistOrg = 1, _doubleZoomOrg = 1, isDoubleZoom = false,
isSlide = true, isDrag = false, timer = null,
winW = window.innerWidth, winH = window.innerHeight;
var Event = {
touchstart: function(e){
e.preventDefault();
// 雙指:記錄起始距離與倍率
if (_advancedSupport && e.touches && e.touches.length >= 2) {
var img = getImg();
$(img).css({"-webkit-transitionDuration":"0ms","transitionDuration":"0ms"});
_doubleZoomOrg = _zoom;
_doubleDistOrg = getDist(e.touches[0].pageX, e.touches[0].pageY,
e.touches[1].pageX, e.touches[1].pageY);
isDoubleZoom = true;
return;
}
e = e.touches ? e.touches[0] : e;
isDoubleZoom = false;
_start = [e.pageX, e.pageY];
_org = [e.pageX, e.pageY];
_orgTime = Date.now();
_transX = -_index * winW;
if (_zoom != 1) {
_zoomXY = _zoomXY || [0, 0];
_orgZoomXY = [_zoomXY[0], _zoomXY[1]];
var img = getImg();
img && ($(img).css({"-webkit-transitionDuration":"0ms","transitionDuration":"0ms"}));
isDrag = true;
} else {
_this.find(".pv-inner").css({"-webkit-transitionDuration":"0ms","transitionDuration":"0ms"});
isSlide = true;
}
},
touchmove: function(e){
e.preventDefault();
// 雙指縮放
if (_advancedSupport && e.touches && e.touches.length >= 2) {
var newDist = getDist(e.touches[0].pageX, e.touches[0].pageY,
e.touches[1].pageX, e.touches[1].pageY);
_zoom = (newDist / _doubleDistOrg) * _doubleZoomOrg;
var img = getImg();
$(img).css({"-webkit-transitionDuration":"0ms","transitionDuration":"0ms"});
if (_zoom < 1) {
_zoom = 1;
_zoomXY = [0, 0];
$(img).css({"-webkit-transitionDuration":"200ms","transitionDuration":"200ms"});
} else if (_zoom > getScale(img) * 2) {
_zoom = getScale(img) * 2;
}
$(img).css({
"-webkit-transform": "scale(" + _zoom + ") translate(" + _zoomXY[0] + "px," + _zoomXY[1] + "px)",
"transform": "scale(" + _zoom + ") translate(" + _zoomXY[0] + "px," + _zoomXY[1] + "px)"
});
return;
}
if (isDoubleZoom) { return; }
e = e.touches ? e.touches[0] : e;
if (_zoom != 1) {
// 放大狀態:拖曳平移,超出邊界時阻尼衰減
var deltaX = (e.pageX - _start[0]) / _zoom;
var deltaY = (e.pageY - _start[1]) / _zoom;
_start = [e.pageX, e.pageY];
var img = getImg();
var newWidth = img.clientWidth * _zoom,
newHeight = img.clientHeight * _zoom;
var borderX = (newWidth - winW) / 2 / _zoom,
borderY = (newHeight - winH) / 2 / _zoom;
(borderX >= 0) && (_zoomXY[0] < -borderX || _zoomXY[0] > borderX) && (deltaX /= 3);
(borderY > 0) && (_zoomXY[1] < -borderY || _zoomXY[1] > borderY) && (deltaY /= 3);
_zoomXY[0] += deltaX;
_zoomXY[1] += deltaY;
(_length == 1 && newWidth < winW || newWidth < winW) && (_zoomXY[0] = 0);
(_length == 1 && newHeight < winH || newHeight < winH) && (_zoomXY[1] = 0);
$(img).css({
"-webkit-transform": "scale(" + _zoom + ") translate(" + _zoomXY[0] + "px," + _zoomXY[1] + "px)",
"transform": "scale(" + _zoom + ") translate(" + _zoomXY[0] + "px," + _zoomXY[1] + "px)"
});
} else {
// 正常狀態:左右滑動換圖
if (!isSlide) { return; }
var deltaX = e.pageX - _start[0];
(_transX > 0 || _transX < -winW * (_length - 1)) && (deltaX /= 4);
_transX = -_index * winW + deltaX;
_this.find(".pv-inner").css({
"-webkit-transform": "translate(" + _transX + "px,0px) translateZ(0)"
});
}
},
touchend: function(e){
if (isDoubleZoom) { return; }
if (_zoom != 1) {
if (!isDrag) { return; }
var img = getImg();
var newWidth = img.clientWidth * _zoom,
newHeight = img.clientHeight * _zoom;
var borderX = (newWidth - winW) / 2 / _zoom,
borderY = (newHeight - winH) / 2 / _zoom;
// 拖曳超過門檻時切換到上一張或下一張
if (_length > 1 && borderX >= 0) {
var updateDelta = 0, switchDelta = winW / 6;
if (_zoomXY[0] < -borderX - switchDelta / _zoom && _index < _length - 1) {
updateDelta = 1;
} else if (_zoomXY[0] > borderX + switchDelta / _zoom && _index > 0) {
updateDelta = -1;
}
if (updateDelta != 0) {
scaleDown(img);
changeIndex(_index + updateDelta);
return;
}
}
// 依停留時間套用慣性或使用阻尼回彈
var delta = Date.now() - _orgTime;
if (delta < 300) {
(delta <= 10) && (delta = 10);
var deltaDis = Math.pow(180 / delta, 2);
_zoomXY[0] += (_zoomXY[0] - _orgZoomXY[0]) * deltaDis;
_zoomXY[1] += (_zoomXY[1] - _orgZoomXY[1]) * deltaDis;
$(img).css({"-webkit-transition":"400ms cubic-bezier(0.08,0.65,0.79,1)",
"transition":"400ms cubic-bezier(0.08,0.65,0.79,1)"});
} else {
$(img).css({"-webkit-transition":"200ms linear","transition":"200ms linear"});
}
if (borderX >= 0) {
if (_zoomXY[0] < -borderX) { _zoomXY[0] = -borderX; }
else if (_zoomXY[0] > borderX) { _zoomXY[0] = borderX; }
}
if (borderY > 0) {
if (_zoomXY[1] < -borderY) { _zoomXY[1] = -borderY; }
else if (_zoomXY[1] > borderY) { _zoomXY[1] = borderY; }
}
if (Math.abs(_zoomXY[0]) < 10) {
$(img).css({"-webkit-transform": "scale(" + _zoom + ") translate(0px," + _zoomXY[1] + "px)",
"transform": "scale(" + _zoom + ") translate(0px," + _zoomXY[1] + "px)"});
return;
} else {
$(img).css({"-webkit-transform": "scale(" + _zoom + ") translate(" + _zoomXY[0] + "px," + _zoomXY[1] + "px)",
"transform": "scale(" + _zoom + ") translate(" + _zoomXY[0] + "px," + _zoomXY[1] + "px)"});
}
isDrag = false;
} else {
if (!isSlide) { return; }
var deltaX = _transX - (-_index * winW);
var updateDelta = 0;
if (deltaX > 50) { updateDelta = -1; }
else if (deltaX < -50) { updateDelta = 1; }
_index = _index + updateDelta;
changeIndex(_index);
isSlide = false;
}
},
click: function(e){
_zoom = 1;
_zoomXY = [0, 0];
_this.css("opacity", "0");
timer = setTimeout(function(){
_this.css({"display":""}).html("");
unbind();
}, 150);
},
dobelTap: function(e){
clearTimeout(timer);
var now = new Date;
if (now - _lastTapDate < 500) { return; }
_lastTapDate = now;
var img = getImg();
if (!img) { return; }
if (_zoom != 1) { scaleDown(img); } else { scaleUp(img); }
},
setView: function(e){
winW = window.innerWidth;
winH = window.innerHeight;
_this.width(winW).height(winH);
translate((-_index * winW), 0, 0, $(".pv-inner")[0]);
scaleDown(getImg());
}
};
var handleEvent = function(e){
switch (e.type){
case "touchstart": Event.touchstart(e); break;
case "touchmove": Event.touchmove(e); break;
case "touchcancel":
case "touchend": Event.touchend(e); break;
case "orientationchange":
case "resize": Event.setView(e); break;
}
};
/** 綁定事件 */
var bind = function(){
_this.on("singleTap", function(e){
e.preventDefault();
var now = new Date;
if (now - _lastTapDate < 500) { return; }
_lastTapDate = now;
Event.click(e);
return false;
}).on("doubleTap", function(e){
e.preventDefault();
Event.dobelTap(e);
return false;
});
_this.on("touchstart touchmove touchend touchcancel", function(e){
handleEvent(e);
});
Event.setView();
"onorientationchange" in window
? window.addEventListener("orientationchange", Event.setView, false)
: window.addEventListener("resize", Event.setView, false);
};
/** 解除事件 */
var unbind = function(){
_this.off();
"onorientationchange" in window
? window.removeEventListener("orientationchange", Event.setView, false)
: window.removeEventListener("resize", Event.setView, false);
};
var getDist = function(x1, y1, x2, y2){
return Math.sqrt(Math.pow(x2 - x1, 2) + Math.pow(y2 - y1, 2), 2);
};
/** 圖片縮放倍率計算 */
var getScale = function(img){
var h = img.naturalHeight, w = img.naturalWidth,
Scale = w * h / (img.clientHeight * img.clientWidth);
return Scale;
};
var scaleUp = function(img){
var scale = getScale(img);
if (scale > 1)
$(img).css({"-webkit-transform": "scale(" + scale + ")",
"transform": "scale(" + scale + ")",
"-webkit-transition": "200ms", "transition": "200ms"});
_zoom = scale;
};
var scaleDown = function(img){
_zoom = 1;
_zoomXY = [0, 0];
_doubleDistOrg = 1;
_doubleZoomOrg = 1;
$(img).css({"-webkit-transform": "scale(1)", "transform": "scale(1)",
"-webkit-transition": "200ms", "transition": "200ms"});
};
/** 位移 */
var translate = function(distX, distY, speed, ele){
if (!!ele) { ele = ele.style; } else { return; }
ele.webkitTransitionDuration = ele.MozTransitionDuration = ele.msTransitionDuration =
ele.OTransitionDuration = ele.transitionDuration = speed + 'ms';
ele.webkitTransform = 'translate(' + distX + 'px,' + distY + 'px) translateZ(0)';
ele.msTransform = ele.MozTransform = ele.OTransform =
'translateX(' + distX + 'px) translateY(' + distY + 'px)';
};
/** 更改索引 */
var changeIndex = function(index, force){
if (index < 0) { index = 0; }
else if (index >= _length) { index = _length - 1; }
_index = index;
translate((-_index * window.innerWidth), 0, force ? "0" : "200", $(".pv-inner")[0]);
$("#J_index").html(_index + 1 + "/" + _length);
imgLoad();
};
/** 取得目前圖片元素 */
var getImg = function(index){
var img = _this.find("li").eq(index || _index).find("img");
if (img.size() == 1) { return img[0]; } else { return null; }
};
/** 圖片載入 */
var imgLoad = function(){
if ($(".pv-img").eq(_index).find("img")[0]) {
$("#J_loading").css("display", "");
return;
} else {
$("#J_loading").css("display", "block");
var tempImg = new Image();
tempImg.src = _ImgData[_index];
$(".pv-img").eq(_index)[0].appendChild(tempImg);
tempImg.onload = function(){ $("#J_loading").css("display", ""); };
}
};
/** 建立 DOM 結構 */
var Create = function(){
_this.append("<ul class='pv-inner'></ul>")
.append("<p class='counts'><span class='value' id='J_index'>" +
(_index + 1) + "/" + _length + "</span></p>")
.append("<span class='ui-loading' id='J_loading'><i class='t1'></i>" +
"<i class='t2'></i><i class='t3'></i></span>");
for (var i = 0; i < _length; i++){
$(".pv-inner").append("<li class='pv-img'></li>");
}
imgLoad();
};
/** 初始化 */
var init = function(){
!!_this[0] || $("body").append("<div class='slide-view' id='slideView'></div>");
_this = $("#slideView");
($.os.iphone || $.os.android && parseFloat($.os.version) >= 4) && (_advancedSupport = true);
}();
/** 對外介面 */
var ImageView = function(index, data){
_ImgData = data;
_index = index;
_length = data.length;
Create();
_this.css("display", "block");
bind();
};
return ImageView;
})(window, Zepto);
/* 大圖查看 */
.slide-view {
background:#000; position:fixed; width:100%; height:100%; overflow:hidden;
top:0; left:0; z-index:100; opacity:0; display:none;
-webkit-animation:fadeIn .2s linear forwards;
animation:fadeIn .2s linear forwards;
-webkit-touch-callout:none; -webkit-transform-style:preserve-3d;
}
.slide-view .counts {
position:absolute; top:5%; left:0; right:0; text-align:center; font-size:0;
-webkit-transform-style:preserve-3d;
}
.slide-view .counts .value {
border-radius:9px; line-height:18px; padding:0 6px; font-size:11px;
display:inline-block; background-color:rgba(102,102,102,.6); color:#f1f1f1;
}
.pv-inner {
position:relative; z-index:-1; display:-webkit-box; display:box;
width:100%; height:100%; -webkit-transition:all 350ms linear;
-webkit-backface-visibility:hidden; transition:all 350ms linear;
backface-visibility:hidden; -webkit-touch-callout:none;
-webkit-transform-style:preserve-3d;
}
.pv-inner li {
text-align:center; display:-webkit-box; display:box;
-webkit-box-align:center; overflow:hidden; width:100%; height:100%;
-webkit-touch-callout:none; backface-visibility:hidden;
-webkit-transform-style:preserve-3d;
}
.pv-inner img {
max-width:97%; max-height:100%;
-webkit-transform:scale(1) translate(0px,0px);
transform:scale(1) translate(0px,0px);
visibility:visible; -webkit-transition:200ms; transition:200ms;
-webkit-user-select:none; user-select:none; display:block; margin:0 auto;
backface-visibility:hidden; -webkit-transform-style:preserve-3d;
}
@-webkit-keyframes fadeIn { 0%{opacity:0;} 100%{opacity:1;} }
@keyframes fadeIn { 0%{opacity:0;} 100%{opacity:1;} }
/* loading */
.ui-loading {
position:absolute; left:50%; top:50%; display:none;
vertical-align:middle; font:0/0 arial; margin:-5px 0 0 -10px;
}
.ui-loading i {
display:inline-block; width:5px; height:12px; background:#fff;
vertical-align:top; -webkit-animation:loading-spin 1s infinite linear;
animation:loading-spin 1s infinite linear;
}
.ui-loading i.t2 { margin:0 3px; -webkit-animation-name:loading-spin-one; animation-name:loading-spin-one }
.ui-loading i.t3 { -webkit-animation-name:loading-spin-two; animation-name:loading-spin-two }
@-webkit-keyframes loading-spin {
0%{opacity:0} 30%{opacity:1; -webkit-transform:scale(1,1.2)}
60%{opacity:0; -webkit-transform:scale(1)} 100%{opacity:0}
}
@-webkit-keyframes loading-spin-one {
0%{opacity:0} 20%{opacity:0} 50%{opacity:1; -webkit-transform:scale(1,1.2)}
80%{opacity:0; -webkit-transform:scale(1)} 100%{opacity:0}
}
@-webkit-keyframes loading-spin-two {
0%{opacity:0} 40%{opacity:0} 70%{opacity:1; -webkit-transform:scale(1,1.2)}
100%{opacity:0; -webkit-transform:scale(1)}
}
@keyframes loading-spin {
0%{opacity:0} 30%{opacity:1; transform:scale(1,1.2)}
60%{opacity:0; transform:scale(1)} 100%{opacity:0}
}
@keyframes loading-spin-one {
0%{opacity:0} 20%{opacity:0} 50%{opacity:1; transform:scale(1,1.2)}
80%{opacity:0; transform:scale(1)} 100%{opacity:0}
}
@keyframes loading-spin-two {
0%{opacity:0} 40%{opacity:0} 70%{opacity:1; transform:scale(1,1.2)}
100%{opacity:0; transform:scale(1)}
}
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no">
<title>移動端大圖查看</title>
<script type="text/javascript" src="test_files/zepto.min.js"></script>
<script type="text/javascript" src="test_files/ImageView.js"></script>
</head>
<body>
<script>
;(function(){
// 取得 html 中的圖片元素
var aImg = document.querySelectorAll("img"),
aImgSrc = [];
for (var i = 0, l = aImg.length; i < l; i++){
aImg[i].index = i;
aImg[i].className += " conPic";
aImgSrc.push(aImg[i].src);
}
// 等圖片載入完成後才綁定 tap,避免點擊時拿到錯誤尺寸
for (var i = 0; i < $(".conPic").length; i++){
if ($(".conPic")[i].complete) {
addTap($(".conPic")[i]);
} else {
$(".conPic")[i].onload = function(){ addTap(this); };
}
}
function addTap(obj){
$(obj).on("tap", function(){
ImageView($(obj)[0].index, aImgSrc); // 呼叫元件
});
}
})();
</script>
</body>
</html>
縮放倍率的計算:getScale() 用「原圖面積 ÷ 顯示面積」開根號的概念估算可放大倍率(原圖的 naturalWidth/Height 對照 clientWidth/Height),並限制最大只能放大到兩倍,避免糊成一片。
慣性與阻尼:touchend 裡用 Date.now() - _orgTime 判斷手指停留多久——小於 300 毫秒視為快速滑動,套用 Math.pow(180/delta, 2) 這個衰減係數讓位移多跑一段(慣性);反之則用較短的 linear 過渡慢慢回位。超出邊界時 deltaX /= 3 則是橡皮筋阻尼的手感來源。
放大狀態下也能換圖:當拖曳位移超過 winW / 6 且已到邊界,就先把圖縮回再切換索引。這個細節讓放大檢視時不必先縮小才能翻下一張。
單擊與雙擊的判定:靠 _lastTapDate 記錄上次點擊時間,500 毫秒內的第二次視為雙擊。單擊的回呼裡也做了同樣的時間檢查,避免雙擊時誤觸發關閉。
圖片延遲載入:imgLoad() 只載入目前這張,切換時才抓下一張,並顯示三個跳動小方塊組成的 loading 動畫(loading-spin 那三組 keyframes 用延遲相位製造波浪感)。
作者自己也在結尾註明「程式碼功能比較簡單,可能會存在諸多問題」,的確有幾點值得注意。
其一,大量使用 -webkit- 前綴與 -webkit-box 這套舊版彈性盒模型,在當年是為了相容舊版 iOS/Android,如今應改用標準的 display: flex。
其二,touchstart/touchmove 裡呼叫 e.preventDefault() 是為了阻止頁面跟著滾動,但這也讓該元素上的原生滾動完全失效;現代做法是用 CSS 的 touch-action: none 達到相同效果,且不會影響效能(在部分瀏覽器上,事件監聽器若不宣告 passive: false,preventDefault 是會被忽略的)。
其三,img.size() 已在 jQuery 3.0 移除,應改用 .length。
其四,元件狀態全放在閉包的私有變數裡,代表同一頁只能有一個實例;若要支援多組,需改寫為建構函式並把狀態掛在 this 上。
最後,現今若要實作同樣的功能,直接用成熟的函式庫(如 PhotoSwipe、lightGallery)會省下大量時間,它們在無障礙、鍵盤操作與效能上都處理得更完整。這份原始碼的價值在於完整展示了手勢處理的每一個環節,讀懂它之後再使用函式庫,遇到客製需求時會更有底氣。