DIV CSS 佈局教程網

用 jQuery 實作錨點平滑捲動效果
編輯:JavaScript綜合知識     

點一下頁內連結,頁面瞬間跳到目標位置,讓人一時搞不清楚發生了什麼。改成平滑捲動,使用者就能看見自己移動的路徑。實作只需攔截錨點連結的點擊,改用 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 雙路徑

先找 id 相符的元素,找不到再找 name 相符的。這是為了相容 HTML4 時代用 <a name="top"> 做錨點的舊頁面。

offset().top 才是目標位置

用 offset() 取得元素相對於文件的絕對位置,而非 position()(相對於最近的定位祖先)。捲動的是整個頁面,所以必須用前者。

return false 阻止瞬跳

不阻止預設行為的話,瀏覽器會先瞬移到目標、再播放動畫,效果就完全錯了。

這段程式今天不能照抄

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 給目標元素留出空間,否則標題會被頁首遮住。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved