jQuery 的跨瀏覽器相容性極佳,許多原生 JS 需要大量代碼處理的兼容問題,在 jQuery 中往往只需幾行代碼即可解決。本文介紹如何用 jQuery 實現頁面內錨點連結的平滑滾動效果。
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
$(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; // 阻止預設跳轉行為
}
}
});
});
a[href*="#"]:選取所有 href 含 # 的連結pathname 與 hostname,避免處理跨頁錨點id(this.hash),其次查找 name 屬性錨點html, body 同時動畫,兼容不同瀏覽器的滾動容器差異return false 取消瀏覽器原生跳轉行為var targetOffset = $target.offset().top - 80; // 扣除固定導航列高度
$('html, body').animate({
scrollTop: targetOffset
}, 1000, function() {
window.location.hash = this.hash; // 動畫完成後更新 URL
});
scroll-behavior 現代替代方案/* 現代瀏覽器無需 JS 即可實現平滑滾動 */
html {
scroll-behavior: smooth;
}
註:CSS 方案不支援動畫速度控制、回調函式,且 Safari 早期版本不支援。
jQuery 平滑滾動方案代碼簡潔、相容性好、易於擴充,適合快速專案落地。現代專案建議優先考慮 CSS scroll-behavior,複雜互動需求再引入 JS 方案。