photoSlider 是一款以原生 JavaScript 撰寫的移動端輪播外掛,支援無縫循環、自動播放與頁碼指示,適合用來做首頁橫幅或相簿瀏覽。
<link rel="stylesheet" type="text/css" href="css/photoSlider.min.css" /> <script src="js/photoSlider.min.js" type="text/javascript" charset="utf-8"></script>
<li><a href="/"><img src="img/1.jpg" /></a></li> <li><a href="/"><img src="img/2.jpg" /></a></li> <li><a href="/"><img src="img/3.jpg" /></a></li>
window.onload = function () {
photoSlide({
wrap: document.getElementById('photo'), // 最外層容器
loop: true, // 無縫循環
autoPlay: true, // 自動輪播
autoTime: 4000, // 輪播間隔(毫秒)
pagination: true // 顯示頁碼指示
});
};
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
<title>photoSlider - 純 js 移動端輪播圖外掛</title>
<meta name="keywords" content="javascript 移動端 相簿 輪播圖 手指滑動外掛" />
<meta name="description" content="以原生 JavaScript 實作的移動端相簿輪播圖,支援自訂滑動屬性" />
<meta name="apple-mobile-web-app-title" content="photoSlider">
<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">
<link rel="stylesheet" type="text/css" href="css/photoSlider.min.css" />
</head>
<body>
<div id="photo">
<div id="loading" class="spinner">
<div class="bounce1"></div>
<div class="bounce2"></div>
<div class="bounce3"></div>
</div>
<ul id="pic-view" class="pic-view">
<li><a href="/"><img src="img/1.jpg" /></a></li>
<li><a href="/"><img src="img/2.jpg" /></a></li>
<li><a href="/"><img src="img/3.jpg" /></a></li>
</ul>
</div>
<script src="js/photoSlider.min.js" type="text/javascript" charset="utf-8"></script>
<script type="text/javascript">
// 等頁面完全載入後再淡出 loading 動畫
document.onreadystatechange = subSomething;
function subSomething() {
if (document.readyState == 'complete') {
setTimeout(function () {
var load = document.getElementById('loading');
load.style.opacity = 0;
document.getElementById('pic-view')
.setAttribute('class', 'pic-view show');
load.remove();
}, 500);
}
}
window.onload = function () {
photoSlide({
wrap: document.getElementById('photo'),
loop: true,
autoPlay: true,
autoTime: 4000,
pagination: true
});
};
</script>
</body>
</html>
loading 動畫的淡出。這裡用 setTimeout 延遲 500ms 再淡出,是為了掩護圖片解碼。更準確的做法是監聽第一張圖的 load 事件,而不是用固定延遲——網路慢的時候固定時間會不夠,網路快時又顯得拖沓。
用 remove() 清理節點。load.remove() 比 parentNode.removeChild(load) 簡潔,這是較新的 DOM API,舊瀏覽器不支援。
viewport 的 user-scalable=no 有爭議。禁止縮放對輪播體驗有幫助,但會影響低視能使用者。無障礙取向的做法是允許縮放,改在 touch 事件裡用 preventDefault() 處理手勢衝突。
輪播的無障礙要點。自動播放的輪播應提供暫停控制;圖片要有描述性的 alt 文字;頁碼指示應該是真實的按鈕而非純裝飾的 span,讓鍵盤使用者也能操作。這些在原生外掛裡經常被忽略。