網上找得到的行動版圖片輪播,多半依賴各種套件,程式碼一多就難以維護;另一派則用 CSS3 的 transform: translate(x, y) 來位移元素,但在不支援 CSS3 的裝置上直接失效。於是決定自己寫一個只用原生 JavaScript 的版本。
過程中踩到的坑不少,最關鍵的三個問題如下。
根源在於無法區分「點擊」與「拖動」。手機的事件順序大致是 touchstart → mousedown → mousemove → touchmove → mouseup → touchend → click,不同機型可能略有差異。多數觸控裝置走的是 touchstart → touchmove → touchend → click,而 click 是最後才觸發的:如果前面三個處理完沒有 return 或取消預設,click 照樣會發生,頁面就跳走了。
解法是記錄 touchstart 與 touchmove 的座標,兩相比較就知道手指有沒有移動過。這裡要留意事件的觸點集合:event.touches、event.targetTouches、event.changedTouches(實測三者內容相同,但 touchend 通常取不到座標)。另外長按會跳出系統選單、在 PC 上拖圖會產生縮圖,這些都要在 touchstart(或 mousedown)時呼叫 event.preventDefault() 取消預設行為。
這通常是因為在 touchmove/mousemove 中無條件呼叫了 preventDefault()。正確做法是比較位移量:若垂直位移大於水平位移,代表使用者想捲動頁面,就不取消預設;反之若是水平滑動,才攔下來做切換。
問題出在綁定事件時沒有區分裝置。做法是把事件名稱抽成一個對應表,再依裝置環境替換:
this.eventName = {
touchstart: 'touchstart',
touchmove: 'touchmove',
touchend: 'touchend'
};
if(!device){
this.eventName.touchstart = 'mousedown';
this.eventName.touchmove = 'mousemove';
this.eventName.touchend = 'mouseup';
}
dom.addEventListener(this.eventName.touchstart, handleEvent, false);
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" name="viewport" />
<meta content="yes" name="apple-mobile-web-app-capable" />
<meta content="black" name="apple-mobile-web-app-status-bar-style" />
<meta content="telephone=no" name="format-detection" />
<title></title>
<style type="text/css">
html,body,*{ margin:0; padding:0; border:0;}
#wapListImage1, #wapListImage{
width:100%; overflow:hidden; height:auto; cursor:move; position:relative;
}
#wapListImage1 ul, #wapListImage1 ul li, #wapListImage ul li{ list-style:none;}
#wapListImage1 ul, #wapListImage ul{ width:99999px;}
#wapListImage1 ul li, #wapListImage ul li{ float:left;}
#wapListImage dl{ position:absolute; bottom:10px; right:0;}
#wapListImage dl span{ overflow:hidden; width:10px; height:10px; background-color:#900; display:inline-block;}
#wapListImage dl span.selected{ background-color:#000;}
</style>
</head>
<body>
<div id="wapListImage">
<ul>
<li><a href="javascript:void(0)" hrefto="ddd" target="_black"><img src="https://file25.mafengwo.net/M00/37/74/wKgB4lM9Hb-ARjpJAAOsX46Kq9w39.gonglve.w690.jpeg"></a></li>
<li><a href="javascript:void(0)" hrefto="ddd"><img src="https://file25.mafengwo.net/M00/F2/06/wKgB4lNaHHCASXmDAAFtZsUxuwQ66.gonglve.w690.jpeg"></a></li>
<li><a href="javascript:void(0)" hrefto="ddd"><img src="https://file25.mafengwo.net/M00/2B/EE/wKgB4lNwdpeAbvZiAAWcFRXe2Po83.gonglve.w690.jpeg"></a></li>
</ul>
<dl>
<span class="selected">1</span>
<span>2</span>
<span>3</span>
</dl>
</div>>
<div style="height:200px;"></div>
<div id="wapListImage1">
<ul>
<li><a href="javascript:void(0)" hrefto="ddd" target="_black"><img src="https://file25.mafengwo.net/M00/37/74/wKgB4lM9Hb-ARjpJAAOsX46Kq9w39.gonglve.w690.jpeg"></a></li>
<li><a href="javascript:void(0)" hrefto="ddd"><img src="https://file25.mafengwo.net/M00/F2/06/wKgB4lNaHHCASXmDAAFtZsUxuwQ66.gonglve.w690.jpeg"></a></li>
<li><a href="javascript:void(0)" hrefto="ddd"><img src="https://file25.mafengwo.net/M00/2B/EE/wKgB4lNwdpeAbvZiAAWcFRXe2Po83.gonglve.w690.jpeg"></a></li>
</ul>
</div>>
<script type="text/javascript">
;(function(w, d){
var device = (/android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i.test(navigator.userAgent.toLowerCase()));
function WapImage(){
this.options = {
dom: null,
speed: 200,
isupdate: true,
time: 3000,
leftOrright: 'left',
isfor: false,
callBack: function(){}
};
this.eventName = {
touchstart: 'touchstart',
touchmove: 'touchmove',
touchend: 'touchend'
};
this.point = { x:5, y:5, pageX1:0, pageX2:0, pageY1:0, pageY2:0 };
this.page = {
bodyWidth: 320,
domUL: null,
liList: null,
index: 0,
flag: false,
sTime: 0,
eTime: 0,
isDown: false,
mleft: 0,
back: 30,
moveId: [],
nextId: null,
prevId: null,
isdom: false
};
this.Event = {
handleEvent: function(event, lib){
event = event ? event : window.event;
switch(event.type){
case "touchstart":
var touch = event.touches[0];
case "mousedown":
if(lib.page.isDown) return;
lib.page.isDown = true;
lib.page.sTime = lib.page.eTime = new Date().getTime();
lib.Event.stop(lib, lib);
if(event.type == "mousedown"){
touch = event;
event.preventDefault();
}
lib.point.pageX1 = lib.point.pageX2 = touch.pageX;
lib.point.pageY1 = lib.point.pageY2 = touch.pageY;
lib.page.mleft = parseFloat(lib.page.domUL.style.marginLeft);
lib.page.mleft = lib.page.mleft ? lib.page.mleft : 0;
break;
case "touchmove":
var touch = event.touches[0];
case "mousemove":
if(!lib.page.isDown) return;
if(event.type == "mousemove"){ touch = event; }
lib.point.pageX2 = touch.pageX;
lib.point.pageY2 = touch.pageY;
if(lib.point.pageX1 == lib.point.pageX2){ event.preventDefault(); return false; }
var changeX = lib.point.pageX1 - lib.point.pageX2;
var changeY = lib.point.pageY1 - lib.point.pageY2;
if(Math.abs(changeX) > Math.abs(changeY)){
// 水平手勢:攔下預設行為,改由輪播處理
event.preventDefault();
lib.page.domUL.style.marginLeft = lib.page.mleft - changeX + 'px';
if(parseFloat(lib.page.domUL.style.marginLeft) <= -(lib.page.liList.length-1)*lib.page.bodyWidth){
lib.page.domUL.style.marginLeft = -(lib.page.liList.length-1)*lib.page.bodyWidth + 'px';
lib.page.mleft = -(lib.page.liList.length-1)*lib.page.bodyWidth;
}
if(parseFloat(lib.page.domUL.style.marginLeft) > 0){
lib.page.domUL.style.marginLeft = '0px';
lib.page.mleft = 0;
}
}else if(Math.abs(changeY) > Math.abs(changeX)){
// 垂直手勢:不攔截,讓頁面正常捲動
}else{
// 長按或點擊
}
break;
case "mouseup":
case "touchend":
if(!lib.page.isDown) return;
lib.page.eTime = new Date().getTime();
lib.page.mleft = parseFloat(lib.page.domUL.style.marginLeft);
lib.page.mleft = lib.page.mleft ? lib.page.mleft : 0;
var changeX = lib.point.pageX1 - lib.point.pageX2;
var changeY = lib.point.pageY1 - lib.point.pageY2;
if(Math.abs(changeX) > Math.abs(changeY)){
event.preventDefault();
lib.Event.move.call(this, lib);
}else if(Math.abs(changeY) > Math.abs(changeX)){
lib.Event.move.call(this, lib);
}else{
// 判斷長按或點擊
if((lib.page.eTime - lib.page.sTime) > 300){
// 長按
}else{
// 點擊:取出該張圖的連結並跳轉
if(event.button == 0 || event.type == 'touchend'){
var a = lib.page.liList[lib.page.index].getElementsByTagName('a')[0];
if(typeof a.getAttribute('target') == 'object'){
w.location = a.getAttribute('hrefto');
}else{
w.open(a.getAttribute('hrefto'));
}
}
}
}
lib.page.isDown = false;
break;
default: break;
}
},
position: function(lib, index){
if(!lib.options.isfor){
if(index == undefined){
lib.page.domUL.style.marginLeft = -(lib.page.index * lib.page.bodyWidth) + 'px';
}else{
lib.page.domUL.style.marginLeft = -((index-1) * lib.page.bodyWidth) + 'px';
lib.page.index = index - 1;
}
lib.options.callBack({"index": parseInt(lib.page.liList[lib.page.index].getAttribute('index')) + 1});
}else{
lib.page.domUL.style.marginLeft = -lib.page.bodyWidth + 'px';
while(true){
if(parseInt(index) == parseInt(lib.page.liList[1].getAttribute('index')) + 1){ break; }
lib.page.domUL.insertBefore(lib.page.liList[lib.page.liList.length-1], lib.page.liList[0]);
}
lib.options.callBack({"index": parseInt(lib.page.liList[1].getAttribute('index')) + 1});
}
},
stop: function(lib){
for(var i = 0; i < lib.page.moveId.length; i++){ clearInterval(lib.page.moveId[i]); }
lib.page.moveId = [];
},
start: function(lib){
if(lib.options.isupdate){
lib.page.moveId[lib.page.moveId.length] = setInterval(function(){
if(lib.options.leftOrright == 'left'){ lib.Event.next(lib, lib); }
else{ lib.Event.prev(lib, lib); }
}, lib.options.time);
}
},
next: function(lib){
clearInterval(lib.page.prevId);
lib.page.prevId = null;
var yu = Math.abs(parseInt(lib.page.domUL.style.marginLeft));
while(true){
if(yu == 0){ yu = lib.page.bodyWidth; break; }
else if(yu < 0){ yu = Math.abs(yu); break; }
yu = yu - lib.page.bodyWidth;
}
var left = yu / lib.options.speed;
var c = 0;
if(lib.page.index == lib.page.liList.length-1){ lib.page.flag = false; return; }
clearInterval(lib.page.nextId);
lib.page.nextId = window.setInterval(function(){
c = c + 5;
lib.page.domUL.style.marginLeft = (parseFloat(lib.page.domUL.style.marginLeft) - left*5) + 'px';
if(c >= lib.options.speed || parseFloat(lib.page.domUL.style.marginLeft) <= -(lib.page.liList.length-1)*lib.page.bodyWidth){
if(parseFloat(lib.page.domUL.style.marginLeft) <= -(lib.page.liList.length-1)*lib.page.bodyWidth){
lib.page.domUL.style.marginLeft = -(lib.page.liList.length-1)*lib.page.bodyWidth + 'px';
}
clearInterval(lib.page.nextId);
lib.page.index++;
lib.page.flag = false;
lib.Event.domUpdate.call(this, lib, 'r');
if(lib.page.moveId.length == 0){ lib.Event.start(lib, lib); }
}
}, 5);
},
prev: function(lib){
clearInterval(lib.page.nextId);
lib.page.nextId = null;
var yu = Math.abs(parseInt(lib.page.domUL.style.marginLeft));
while(true){
if(yu == 0){ yu = lib.page.bodyWidth; break; }
else if(yu < 0){ yu = lib.page.bodyWidth - Math.abs(yu); break; }
yu = yu - lib.page.bodyWidth;
}
var left = yu / lib.options.speed;
var c = 0;
if(lib.page.index == 0){ lib.page.flag = false; return; }
clearInterval(lib.page.prevId);
lib.page.prevId = window.setInterval(function(){
c = c + 5;
lib.page.domUL.style.marginLeft = (parseFloat(lib.page.domUL.style.marginLeft) + left*5) + 'px';
if(c >= lib.options.speed || parseFloat(lib.page.domUL.style.marginLeft) >= 0){
if(parseFloat(lib.page.domUL.style.marginLeft) >= 0){ lib.page.domUL.style.marginLeft = '0px'; }
clearInterval(lib.page.prevId);
lib.page.index--;
lib.page.flag = false;
lib.Event.domUpdate.call(this, lib, 'l');
if(lib.page.moveId.length == 0){ lib.Event.start(lib, lib); }
}
}, 5);
},
move: function(lib){
if(lib.page.flag) return;
lib.page.flag = true;
// 位移不足 back 值視為點擊,讓它彈回原位
if(Math.abs(lib.point.pageX1 - lib.point.pageX2) < lib.page.back){
var h = Math.abs(Math.abs(parseFloat(lib.page.domUL.style.marginLeft)) - Math.abs(lib.page.bodyWidth * lib.page.index));
h = h / 70;
var hi = 0;
var hid = window.setInterval(function(){
if(lib.point.pageX2 > lib.point.pageX1){
lib.page.domUL.style.marginLeft = (parseFloat(lib.page.domUL.style.marginLeft) - h*5) + 'px';
}else{
lib.page.domUL.style.marginLeft = (parseFloat(lib.page.domUL.style.marginLeft) + h*5) + 'px';
}
hi = hi + 5;
if(hi >= 70){
clearInterval(hid);
lib.page.domUL.style.marginLeft = -(lib.page.index * lib.page.bodyWidth) + 'px';
lib.page.flag = false;
}
}, 5);
return;
}
if(lib.point.pageX1 - lib.point.pageX2 > 0){ lib.Event.next.call(this, lib); }
else if(lib.point.pageX2 - lib.point.pageX1 > 0){ lib.Event.prev.call(this, lib); }
},
domUpdate: function(lib, type){
if(lib.page.isdom) return;
lib.page.isdom = true;
if(!lib.options.isfor){
var index = lib.page.liList[lib.page.index].getAttribute('index');
lib.options.callBack({"index": parseInt(index) + 1});
lib.page.isdom = false;
return;
}
// 循環模式:把頭尾元素搬到另一端,維持中間索引固定在 1
if(type == 'l'){
lib.page.domUL.insertBefore(lib.page.liList[lib.page.liList.length-1], lib.page.liList[0]);
lib.page.domUL.style.marginLeft = -lib.page.bodyWidth + 'px';
}else if(type == 'r'){
lib.page.domUL.appendChild(lib.page.liList[0]);
lib.page.domUL.style.marginLeft = -lib.page.bodyWidth + 'px';
}
lib.page.index = 1;
var index = lib.page.liList[lib.page.index].getAttribute('index');
lib.options.callBack({"index": parseInt(index) + 1});
lib.page.isdom = false;
}
};
}
WapImage.prototype = {
setoption: function(arg){
for(var i in this.options){
this.options[i] = arg[i] !== undefined ? arg[i] : this.options[i];
}
if(!device){
this.eventName.touchstart = 'mousedown';
this.eventName.touchmove = 'mousemove';
this.eventName.touchend = 'mouseup';
}
},
bindEvent: function(){
var lib = this;
this.page.domUL.addEventListener(this.eventName.touchstart, function(event){
lib.Event.handleEvent.call(lib, event, lib);
}, false);
w.addEventListener(this.eventName.touchmove, function(event){
lib.Event.handleEvent.call(lib, event, lib);
}, false);
w.addEventListener(this.eventName.touchend, function(event){
lib.Event.handleEvent.call(lib, event, lib);
}, false);
w.addEventListener('resize', function(){ lib.init(); }, false);
},
init: function(){
this.page.bodyWidth = document.body.clientWidth;
this.page.liList = this.options.dom.getElementsByTagName('li');
this.page.domUL = this.options.dom.getElementsByTagName('ul')[0];
this.options.dom.style.width = this.page.bodyWidth + 'px';
for(var i = 0; i < this.page.liList.length; i++){
var item = this.page.liList[i];
var img = item.getElementsByTagName('img')[0];
item.setAttribute('index', i);
item.style.width = this.page.bodyWidth + 'px';
img.style.width = this.page.bodyWidth + 'px';
}
// 少於 3 張時複製節點,確保循環播放時首尾都有緩衝
if(this.page.liList.length < 3){
var length = this.page.liList.length;
if(length == 1){
this.page.domUL.appendChild(this.page.liList[0].cloneNode(true));
this.page.domUL.appendChild(this.page.liList[0].cloneNode(true));
}else{
for(var i = 0; i < length; i++){
this.page.domUL.appendChild(this.page.liList[i].cloneNode(true));
}
}
this.page.liList = this.options.dom.getElementsByTagName('li');
}
},
position: function(index){ this.Event.position.call(this, this, index); },
next: function(){ this.Event.next.call(this, this); },
prev: function(){ this.Event.prev.call(this, this); },
start: function(arg){
this.setoption(arg);
this.init();
this.position();
this.bindEvent();
this.Event.domUpdate(this, 'l');
this.Event.start(this);
}
};
var loaded = function(){
w.WapImage = new WapImage();
w.WapImages = new WapImage();
};
(function(){
if(d.body){ loaded(); }
else {
if(d.addEventListener){
d.addEventListener('DOMContentLoaded', function(){
d.removeEventListener('DOMContentLoaded', arguments.callee, false);
loaded();
}, false);
}else if(d.attachEvent){
d.attachEvent('onreadystatechange', function(){
if(d.readyState === 'complete'){
d.detachEvent('onreadystatechange', arguments.callee);
loaded();
}
});
}
}
})();
})(window, document, undefined);
window.onload = function(){
var obj = {
dom: document.getElementById('wapListImage'),
isupdate: true, // 是否自動切換
time: 3000, // 自動切換間隔(毫秒)
isfor: true, // 是否循環播放
leftOrright: 'left',// 自動切換方向
callBack: function(obj){
// obj.index 為目前第幾張
var span = document.getElementById('wapListImage')
.getElementsByTagName('dl')[0].getElementsByTagName('span');
for(var k = 0; k < span.length; k++){ span[k].className = ''; }
span[obj.index-1].className = 'selected';
}
};
WapImage.start(obj);
WapImage.position(2); // 初始顯示第 2 張
var obj2 = {
dom: document.getElementById('wapListImage1'),
callBack: function(obj){ /* 自訂處理 */ }
};
WapImages.start(obj2);
};
</script>
</body>
</html>
· dom:輪播容器的 DOM 元素(必填)。
· isupdate:是否啟用自動播放。
· time:自動切換的間隔毫秒數。
· isfor:是否循環。設為 true 時會把首尾元素互相搬移,做到無限 Loop;設為 false 則到頭就停。
· leftOrright:自動播放方向,'left' 或 'right'。
· callBack:切換完成後的回呼函數,參數 index 為目前顯示第幾張,可用來同步下方的指示點。
頁面中若需要多組輪播,在 var loaded=function(){...} 裡多宣告幾個實例(如範例中的 WapImage 與 WapImages),頁面載入後各自呼叫 .start() 即可。
· 整個元件用 marginLeft 位移 <ul>,並以「5 毫秒一階」的方式做逐格動畫,這在現代瀏覽器上會有明顯掉幀,改用 requestAnimationFrame 會順很多。
· 循環播放的做法是「把 DOM 節點搬到另一端 + 重設 marginLeft」,這比複製節點省記憶體,但每次搬移都會觸發 reflow,元素數量多時要留意。
· 手勢判斷(比較 |changeX| 與 |changeY|)是這支程式最值得學的部分,也是行動版輪播與頁面捲動能否和平共存的關鍵。
· 以 2013 年前後的技術背景來看,用 addEventListener + attachEvent 雙寫是為了相容舊 IE;現今只需 addEventListener,並可用 Pointer Events 統一處理滑鼠與觸控,程式碼能少掉一大半。