網路上手機圖片滑動切換的範例很多,但大致離不開兩條路:一是引入整套外掛,結果標籤與樣式被搞得一團亂;二是使用 CSS3 的 transform: translate(x, y) 移動元素,問題是碰上不支援 CSS3 的舊裝置就直接躺平。
於是決定自己寫一個。過程遠比預期曲折,其中最关键的三個問題整理如下。
根源在於無法分辨使用者是「點擊」還是「拖動」。手機上的事件順序大致是 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,把上下捲動一起封死了。正確做法是比較當前座標與起始座標:若無位移就直接返回;若有位移,則比較 x 軸與 y 軸哪個變化更大——只有判定為左右滑動時才取消預設,判定為上下滑動時則放行,讓頁面正常捲動。
這其實是事件名稱的問題。綁定時不能預設只有 touch 系列事件,於是先定義一組名稱對照表,再依裝置環境替換:
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; zoom:1; position:relative; }
#wapListImage1 ul, #wapListImage1 ul li, #wapListImage ul, #wapListImage ul li{ list-style:none; }
#wapListImage1 ul, #wapListImage ul{ width:99999px; }
#wapListImage1 ul li, #wapListImage ul li{ float:left; }
#wapListImage ul li a img:focus, #wapListImage ul li a img:checked, #wapListImage ul li a img,
#wapListImage ul li a img:active, #wapListImage ul li a, #wapListImage ul li a:active{ cursor:move; }
#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="k">
<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>
<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 {
if (index == undefined) {
lib.page.domUL.style.marginLeft = -lib.page.bodyWidth + 'px';
} 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;
// 位移很小,視為沒有真正拖動,回弹歸位
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;
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;
}
// 循環播放:把頭尾元素搬到另一端,造成無限延伸的錯覺
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';
}
// 少於三張時複製節點,湊出可循環的數量
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);
</script>
</body>
</html>
在頁面載入完成後建立設定物件並啟動即可:
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 loaded = function() 這一段,在其中宣告所需的實例並各自命名,例如:
w.WapImage = new WapImage(); w.WapImages = new WapImage();
之後頁面載入完成,就能分別呼叫 WapImage.start() 與 WapImages.start() 各自初始化。仔細想想,這套寫法在今日以 CSS transform 搭配 requestAnimationFrame 已是標準做法,但把底層事件處理拆解清楚的過程,仍然值得一看。