需求很簡單:頁面一打開就自動往右捲一些距離。看起來只要設個 scrollLeft 就好,實際上卻會失敗。
window.onload = function () {
window.scroll(0, 300);
$(".btn").on("click", function () {
document.documentElement.scrollLeft = "500";
var oTop = document.body.scrollTop || document.documentElement.scrollTop;
var oLeft = document.body.scrollLeft || document.documentElement.scrollLeft;
alert(oLeft);
});
};
以為給 document.documentElement.scrollLeft 一個數值就會生效,結果毫無反應。
直接指派 scrollLeft 這種做法,需要在「人為事件」的觸發流程中才會被瀏覽器套用;在 onload 或 ready 的時機直接設值,很可能被後續的版面配置(layout)重算覆蓋掉,尤其是頁面裡還有圖片尚未載入、高度仍在變動的時候。使用者手動點擊之所以有效,是因為那時版面已經穩定,且是在事件處理的脈絡下執行。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<title>自動滾動</title>
<script type="text/javascript" src="jquery.js"></script>
</head>
<body>
<div class="container" style="height:3000px; width:3000px;">
<a class="btn" href="javascript:;">點擊</a>
</div>
<script type="text/javascript">
$(function () {
$("html,body").animate({ "scrollLeft": "300px" }, 1000);
});
</script>
</body>
</html>
垂直方向同理:$("html,body").animate({ scrollTop: "300px" }, 1000);。用 animate 之所以有效,是因為它透過 timer 逐步改寫捲動屬性,整個過程橫跨數個 frame,避開了「設定當下就被版面重算蓋掉」的時機問題,而且附帶動畫效果,體驗更好。
選擇器寫 "html,body" 是為了相容不同瀏覽器:有的捲動發生在 html 上,有的是 body,兩個一起選就不必偵測。若要精準一點,可用 $(document.scrollingElement || document.documentElement)。
若捲動目標是「某個元素的位置」而非固定像素,用 offset() 算差值再 animate 會更可靠:var top = $("#target").offset().top; $("html,body").animate({scrollTop: top}, 500);。另外記得在 ready 而非 window.onload 裡執行,並確認目標頁面真的有超出視窗的內容,否則捲不動是正常現象而非 bug。
最後,自動捲動對使用螢幕閱讀器或容易暈動的使用者不友善,請尊重 prefers-reduced-motion 並提供跳過連結(skip link)作為替代路徑。