萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 實作單頁錨點平滑滾動:輕量級替代原生 JS 方案

前言

jQuery 的跨瀏覽器相容性極佳,許多原生 JS 需要大量代碼處理的兼容問題,在 jQuery 中往往只需幾行代碼即可解決。本文介紹如何用 jQuery 實現頁面內錨點連結的平滑滾動效果。

實作步驟

1. 載入 jQuery 庫

<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>

2. 核心代碼

$(document).ready(function() {
    $('a[href*="#"]').click(function() {
        // 確保是同頁錨點(排除跨頁連結)
        if (location.pathname.replace(/^\//, '') == this.pathname.replace(/^\//, '') 
            && location.hostname == this.hostname) {
            
            var $target = $(this.hash);
            // 兼容 name 屬性錨點(如 )
            $target = $target.length && $target || $('[name=' + this.hash.slice(1) + ']');
            
            if ($target.length) {
                var targetOffset = $target.offset().top;
                $('html, body').animate({
                    scrollTop: targetOffset
                }, 1000); // 1000ms = 1秒滾動動畫
                return false; // 阻止預設跳轉行為
            }
        }
    });
});

代碼邏輯解析

  1. 選擇器 a[href*="#"]:選取所有 href 含 # 的連結
  2. 同頁判斷:比對 pathname 與 hostname,避免處理跨頁錨點
  3. 目標元素查找:優先用 id(this.hash),其次查找 name 屬性錨點
  4. 動畫執行:對 html, body 同時動畫,兼容不同瀏覽器的滾動容器差異
  5. 阻止預設:return false 取消瀏覽器原生跳轉行為

瀏覽器相容性測試

  • ✅ Chrome、Firefox、Safari、Edge 完美支援
  • ⚠️ Opera(舊版 Presto 核心)表現異常,現代 Chromium 版 Opera 已正常
  • ✅ IE9+ 正常運作

進階優化建議

加入 offset 調整(固定導航列場景)

var targetOffset = $target.offset().top - 80; // 扣除固定導航列高度

支援 URL hash 更新

$('html, body').animate({
    scrollTop: targetOffset
}, 1000, function() {
    window.location.hash = this.hash; // 動畫完成後更新 URL
});

使用 CSS scroll-behavior 現代替代方案

/* 現代瀏覽器無需 JS 即可實現平滑滾動 */
html {
    scroll-behavior: smooth;
}

註:CSS 方案不支援動畫速度控制、回調函式,且 Safari 早期版本不支援。

總結

jQuery 平滑滾動方案代碼簡潔、相容性好、易於擴充,適合快速專案落地。現代專案建議優先考慮 CSS scroll-behavior,複雜互動需求再引入 JS 方案。

copyright © 萬盛學電腦網 all rights reserved