點擊某個連結,頁面平滑地捲到指定位置——這個效果只需要一行 jQuery:
$('a.lead-link').bind('click', function (e) {
e.preventDefault();
$('html,body').animate({ scrollTop: $(this.hash).offset().top - 60 }, 1500);
});
e.preventDefault():攔下 a 標籤的預設跳轉。少了這行,瀏覽器會瞬間跳到目標,你的動畫根本沒機會播放。
this.hash:取出 href 中 # 後面的部分。若連結是 <a href="#section2">,那 this.hash 就是 "#section2"——剛好可以直接當選擇器用。
.offset().top:取得該元素相對於文件頂部的絕對位置。注意別與 .position().top 混淆:offset 是相對文件,position 是相對偏移父元素。做頁面捲動要用 offset。
- 60:往上多留 60px 的緩衝。如果你的頁面有固定定位的 header,這個值就必須等於 header 的高度,否則目標區塊會被 header 蓋住。
1500:動畫時長(毫秒)。1500 屬於偏慢的設定,適合長距離捲動;短距離可以縮到 400~600 會更俐落。
$('html,body')因為不同瀏覽器實際承擔頁面捲動的元素不一樣——有的是 html,有的是 body。同時選兩者可以確保至少有一個生效。
若要更嚴謹,可以改用 $.scrollbarWidth 或直接呼叫 window.scrollTo,但實務上 $('html,body') 已足夠相容。
1. 更新網址。若希望捲動後網址列也帶上錨點(方便分享連結),把 preventDefault 移除,改在動畫完成後寫入:
$('a.lead-link').click(function (e) {
e.preventDefault();
var target = $(this.hash);
if (target.length === 0) { return; }
$('html,body').animate({ scrollTop: target.offset().top - 60 }, 1000);
history.pushState(null, '', this.hash);
});
2. 目標不存在時要保護。若 href 指向的 id 在頁面上不存在,$(this.hash).offset() 會回傳 undefined,接著取 .top 就會報錯。加上長度判斷可以避免這個情況。
3. 尊重使用者的動態偏好。如果使用者系統設定了「減少動態效果」,應該直接跳轉而不播放動畫,這是現代前端該有的體貼。