點一下頁內連結,頁面瞬間跳到目標位置,讓人一時搞不清楚發生了什麼。改成平滑捲動,使用者就能看見自己移動的路徑。實作只需攔截錨點連結的點擊,改用 animate 動畫 scrollTop。
$('a[href*=#]').click(function () {
// 只處理指向同一頁、同一網域的錨點
if (location.pathname.replace(/^\//, '') == this.pathname.replace(/^\//, '') &&
location.hostname == this.hostname) {
var $target = $(this.hash);
// 找不到 id 相符的元素時,改找 name 相符的(舊式錨點)
$target = $target.length && $target ||
$('[name=' + this.hash.slice(1) + ']');
if ($target.length) {
var targetOffset = $target.offset().top;
// Safari 與 IE 需要操作不同的捲動容器
var obj = document.documentElement;
if (jQuery.browser.safari) obj = document.body;
if (jQuery.browser.msie) obj = 'html';
$(obj).animate({ scrollTop: targetOffset }, 1000);
return false; // 阻止預設的瞬跳行為
}
}
});
location.pathname == this.pathname && location.hostname == this.hostname 確保只攔截本站內部的頁內錨點,不會誤傷外部連結或跨頁連結。少了這道判斷,點任何含 # 的連結都會被攔截。
先找 id 相符的元素,找不到再找 name 相符的。這是為了相容 HTML4 時代用 <a name="top"> 做錨點的舊頁面。
用 offset() 取得元素相對於文件的絕對位置,而非 position()(相對於最近的定位祖先)。捲動的是整個頁面,所以必須用前者。
不阻止預設行為的話,瀏覽器會先瞬移到目標、再播放動畫,效果就完全錯了。
jQuery.browser 已在 jQuery 1.9 中移除,用它判斷 Safari 與 IE 會直接拋出錯誤。同一段邏輯現在的正確寫法是判斷特性而非判斷瀏覽器:
$('a[href^="#"]').on('click', function (e) {
var target = document.getElementById(this.hash.slice(1));
if (!target) return;
e.preventDefault();
var scroller = document.scrollingElement || document.documentElement;
$(scroller).stop().animate({ scrollTop: target.offsetTop }, 600);
});
document.scrollingElement 由瀏覽器回報真正負責捲動的元素,跨瀏覽器一致,不必再分情況處理。
如果不需要自訂速度或緩動,CSS 一行就足夠,還能尊重使用者偏好:
html {
scroll-behavior: smooth;
}
@media (prefers-reduced-motion: reduce) {
html { scroll-behavior: auto; } /* 尊重系統的減少動態設定 */
}
要注意的是 CSS 方案無法覆寫成 return false,因此 URL 上的 hash 會照常更新——這其實是好事,讓連結可被分享、瀏覽器的前後頁也能正常運作。若頁面有固定高度的 header,記得用 scroll-margin-top 給目標元素留出空間,否則標題會被頁首遮住。