長頁面我一定會加「回到頂部」按鈕。實作分兩部分:用 CSS 讓按鈕固定,用 JS 讓頁面平滑捲上去。
CSS 的 position 有五種值,先釐清差異:
我們要的是 fixed:
#myTopBtn{
bottom: 5px;
right: 5px;
position: fixed;
}
這樣不論怎麼拉捲軸或縮放視窗,按鈕都牢牢釘在右下角。
JavaScript 提供了兩個控制捲動的方法:
window.scrollBy(0, -30); // 相對移動:向上 30px window.scroll(0, 0); // 絕對移動:回到左上角
要「平滑」地上升,就把 scrollBy 交給 setInterval 反覆執行:
<body>
<div id="myDiv"></div>
<button id="myTopBtn" onclick="TopFunc()">To Top</button>
</body>
<script>
var myVar;
function TopFunc() {
myVar = setInterval(EachScrollBy, 10); // 每 10ms 執行一次
}
function EachScrollBy() {
if (document.documentElement.scrollTop <= 0) {
clearInterval(myVar); // 到頂就停
} else {
window.scrollBy(0, -30); // 每次上移 30px
}
}
</script>
每 10 毫秒上移 30 像素,換算成每秒 3000px,對一般長度頁面來說大約半秒到一秒就能到頂,速度感剛好。
要做「置底」按鈕或捲動進度條,會需要這些數值:
document.body.clientWidth // 可見區域寬 document.body.clientHeight // 可見區域高 document.body.offsetWidth // 可見區域寬(含邊框) document.body.offsetHeight // 可見區域高(含邊框) document.body.scrollWidth // 正文總寬 document.body.scrollHeight // 正文總高 document.body.scrollTop // 被捲走的垂直距離 document.body.scrollLeft // 被捲走的水平距離 window.screenTop // 正文部分距螢幕上方 window.screenLeft // 正文部分距螢幕左方 window.screen.height // 螢幕解析度高 window.screen.width // 螢幕解析度寬 window.screen.availHeight // 可用工作區高(扣掉工作列) window.screen.availWidth // 可用工作區寬
有了 scrollHeight 與 scrollTop,就能算出捲動百分比 scrollTop / (scrollHeight - clientHeight),進而做閱讀進度條。
今天的瀏覽器有原生的平滑捲動,不需要自己跑計時器:
// 最簡單
window.scrollTo({ top: 0, behavior: 'smooth' });
// 或直接在 CSS 全域開啟(頁內所有 #anchor 跳轉都會變平滑)
html { scroll-behavior: smooth; }
另外兩個實務建議:
1. 捲動超過一定距離才顯示按鈕。頁面頂端顯示「回頂部」是沒有意義的:
var btn = document.getElementById('myTopBtn');
window.addEventListener('scroll', function () {
btn.hidden = window.scrollY < 300;
}, { passive: true }); // passive 可提升捲動效能
2. 尊重 prefers-reduced-motion。部分使用者會因平滑捲動而暈眩,請在該設定下改用瞬間跳轉。同時為按鈕加上 aria-label="回到頁面頂部",並確保它能用鍵盤聚焦操作(<button> 本身就具備這個能力,這也是建議用 button 而非 div 的原因)。