長頁面一定會需要「回到頂端」的浮動按鈕,有時候也需要反向跳到頁尾。用 jQuery 的 animate() 操作 scrollTop,幾行就能做出平滑捲動,比直接 scrollTo(0) 友善得多。
關鍵在兩個 API:scrollTop 用來取得或設定捲動位置;offset() 回傳元素相對於文件的座標(含 top 與 left 兩個屬性),因此想知道某個元素距離頁首多遠,取它的 offset().top 即可。
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title>回到頂部與底部</title>
<script type="text/javascript" src="jquery-1.8.0.js"></script>
<script>
$(document).ready(function () {
// 點「頂部」:把 html 的 scrollTop 動畫到 0
$('#top').click(function () {
$('html').animate({ scrollTop: '0px' }, 1000);
});
// 點「底部」:先量出 span 的 offset().top,再捲到那裡
// animate 的第二個參數也可以寫 'slow' / 'normal' / 'fast'
$('#foot').click(function () {
$('html').animate({ scrollTop: $('span').offset().top }, 1000);
});
});
</script>
</head>
<body>
<br /><br /><br /><br /><br />
<a href="#" id="foot">底部</a>
<br /><br /><br /><br /><br /><br /><br /><br /><br /><br />
<a href="#" id="top">頂部</a>
<br /><br /><br /><br /><br />
<span></span>
</body>
</html>
選 $('html') 還是 $('body')?這是本範例最需要注意的一點。在標準模式(有宣告 DOCTYPE)下多數瀏覽器要操作 $('html') 或 $('body') 才行,兩者行為不完全一致;保險的做法是 $('html, body').animate(...),一次選兩個,避免在 Safari 或舊 IE 上失效。
跳到底部用 offset 而非固定值。頁尾位置會隨內容長度變化,寫死像素遲早出錯;把 <span> 放在頁面最末端當作標記,再抓它的 offset().top,就能永遠對準。
記得阻止預設跳轉。若用 <a href="#"> 當按鈕,點擊後網址會多一個 # 並引發瞬間跳動,破壞動畫觀感。加上 return false; 或 e.preventDefault() 即可。
動畫期間避免重複觸發。使用者連點時會堆疊多個動畫,可在 animate 前先 .stop() 清掉進行中的效果。
如果不想依賴 jQuery,現在也可以直接用原生寫法 window.scrollTo({ top: 0, behavior: 'smooth' }),一行取代整個插件,值得評估。