下拉刷新在行動版網頁裡幾乎是標配。市面上多半用套件解決,但其實單靠原生 JavaScript 的觸控事件就能做出來,程式碼量還很少。以下是一個可直接運行的最小實作。
<meta charset="utf-8" />
<title>Pull to Refresh</title>
<meta name="viewport" content="width=device-width,height=device-height,
inital-scale=1.0,maximum-scale=1.0,user-scalable=no;" />
<style>
div{
position: absolute;
top:0px;
bottom:0px;
width:100%;
left:0px;
overflow: hidden;
}
li{
list-style-type: none;
height:35px;
background: #ccc;
border-bottom: solid 1px #fff;
text-align: left;
line-height: 35px;
padding-left:15px;
}
ul{
width:100%;
margin-top:0px;
position: absolute;
left:0px;
padding:0px;
top:0px;
}
</style>
<div class="outerScroller">
<ul class="scroll">
<li>1</li>
<li>2</li>
<li>3</li>
<li>4</li>
<li>5</li>
<!-- 其餘列表項省略 -->
</ul>
</div>
<script>
var scroll = document.querySelector('.scroll');
var outerScroller = document.querySelector('.outerScroller');
var touchStart = 0;
var touchDis = 0;
outerScroller.addEventListener('touchstart', function(event) {
var touch = event.targetTouches[0];
// 記錄手指起始位置
touchStart = touch.pageY;
}, false);
outerScroller.addEventListener('touchmove', function(event) {
var touch = event.targetTouches[0];
// 依手指位移量拖動列表
scroll.style.top = scroll.offsetTop + touch.pageY - touchStart + 'px';
touchStart = touch.pageY;
touchDis = touch.pageY - touchStart;
}, false);
outerScroller.addEventListener('touchend', function(event) {
touchStart = 0;
var top = scroll.offsetTop;
// 下拉超過門檻就觸發刷新
if(top > 70) refresh();
// 若停在頂端以下,逐格回彈到 0
if(top > 0){
var time = setInterval(function(){
scroll.style.top = scroll.offsetTop - 2 + 'px';
if(scroll.offsetTop <= 0) clearInterval(time);
}, 1)
}
}, false);
function refresh(){
for(var i = 10; i > 0; i--){
var node = document.createElement("li");
node.innerHTML = "I'm new";
scroll.insertBefore(node, scroll.firstChild);
}
}
</script>
核心概念其實只有三個事件與一個門檻值。touchstart 記下手指起始的 Y 座標;touchmove 用「當前座標減去起始座標」的差值去改寫列表的 top,讓內容跟手;touchend 則檢查停留位置,超過 70 像素就呼叫 refresh() 插入新資料,接著用一個短間隔的計時器把列表平滑推回 0。
實作時有幾個地方值得留意。第一,這裡用 inline style 直接操作 top,是為了避開重排成本較高的寫法;正式專案中建議加上 CSS transition 取代手寫的回彈計時器,畫面會更順。第二,範例中的 refresh() 只是插入假資料,實際使用時應該替換成 Ajax 請求,並在資料回來後再收尾。第三,完整功能還需要「上拉載入更多」,做法是在列表底部放一個哨兵元素,偵測它進入視窗時觸發載入。