纯JavaScript实现平滑滚动到指定位置_技术教程

本文详细介绍了如何使用纯JavaScript实现平滑滚动到页面指定位置的功能，以替代jQuery的`animate({ scrollTop: y }, duration)`方法。核心解决方案是利用现代浏览器原生支持的`window.scrollTo({ top: Y_COORDINATE, behavior: 'smooth' })` API，该方法简洁高效，并提供优秀的浏览器兼容性，是实现平滑滚动效果的首选方案。

纯JavaScript实现平滑滚动到指定位置

在现代Web开发中，实现页面平滑滚动到特定位置是一项常见需求。过去，开发者常依赖jQuery的animate()方法来实现这一效果，例如$('html, body').animate({ scrollTop: y }, 400);。然而，随着纯JavaScript能力的增强以及对性能优化的追求，许多项目开始寻求摆脱jQuery依赖的解决方案。本教程将介绍如何使用原生JavaScript实现与jQuery animate功能相同的平滑滚动效果。

核心解决方案：window.scrollTo()

现代浏览器提供了一个简单而强大的原生API来控制页面的滚动行为：window.scrollTo()。这个方法允许我们以编程方式将文档滚动到窗口中的特定坐标。更重要的是，它支持一个behavior选项，可以轻松实现平滑滚动。

语法

window.scrollTo({
  top: Y_COORDINATE, // 垂直方向的滚动位置（像素值）
  left: X_COORDINATE, // 水平方向的滚动位置（像素值，可选）
  behavior: 'smooth' // 滚动行为，可以是 'auto'（默认，瞬间滚动）或 'smooth'（平滑滚动）
});

top: 指定页面应滚动到的垂直像素位置。这是相对于文档顶部的距离。
left: 指定页面应滚动到的水平像素位置。如果不需要水平滚动，可以省略或设置为0。
behavior: 这是实现平滑滚动的关键选项。当设置为'smooth'时，浏览器将以动画形式平滑地滚动到目标位置；当设置为'auto'时，滚动将立即完成，没有任何动画效果。

示例代码

假设我们有一个页面，其中包含多个部分和一个导航菜单。当用户点击导航项时，我们希望页面平滑滚动到对应的部分。

HTML 结构:




    
    
    纯JS平滑滚动示例
    


    
        
            部分一
            部分二
            部分三
            部分四
        
    

    部分一
    部分二
    部分三
    部分四

JavaScript (scroll.js):

document.addEventListener('DOMContentLoaded', () => {
    const navLinks = document.querySelectorAll('nav a');
    const fixedNavHeight = document.querySelector('nav').offsetHeight; // 获取固定导航的高度

    navLinks.forEach(link => {
        link.addEventListener('click', (event) => {
            event.preventDefault(); // 阻止默认的锚点跳转行为

            const targetId = link.getAttribute('data-target-id');
            const targetElement = document.getElementById(targetId);

            if (targetElement) {
                // 计算目标元素的offsetTop，并减去固定导航的高度
                // 这样可以确保目标元素完全显示在固定导航下方
                const targetPosition = targetElement.offsetTop - fixedNavHeight;

                window.scrollTo({
                    top: targetPosition,
                    behavior: 'smooth'
                });
            }
        });
    });
});

在这个示例中：

我们监听了所有导航链接的点击事件。
event.preventDefault()阻止了浏览器默认的锚点跳转（它会导致瞬间滚动）。
我们获取了目标元素的offsetTop，这是元素相对于其offsetParent（通常是）顶部的距离。
重要提示: 由于导航栏是position: fixed，它会覆盖页面顶部的内容。为了让目标部分完全显示在导航栏下方，我们需要从targetElement.offsetTop中减去固定导航栏的高度(fixedNavHeight)。
最后，调用window.scrollTo()并设置behavior: 'smooth'来实现平滑滚动。

浏览器兼容性

window.scrollTo()方法本身在所有主流浏览器中都得到了广泛支持。而behavior: 'smooth'选项在现代浏览器中也具有非常好的兼容性：

Chrome (所有版本)
Firefox (所有版本)
Safari (所有版本)
Edge (所有版本)
Opera (所有版本)

对于一些非常老旧的浏览器（如IE，但现代Web开发通常不再考虑），behavior: 'smooth'可能不被支持，此时它会优雅降级为'auto'行为（即瞬间滚动），不会导致脚本错误。因此，在大多数情况下，可以放心地使用此API。

替代方案与高级用法

尽管window.scrollTo({ behavior: 'smooth' })是实现平滑滚动的最佳原生方案，但在某些特定场景下，你可能需要考虑其他方法：

element.scrollIntoView(): 如果你想将某个特定的DOM元素滚动到视口中，而不是滚动到精确的像素坐标，element.scrollIntoView()是一个更好的选择。它也支持behavior: 'smooth'选项。
```
document.getElementById('myElement').scrollIntoView({
    behavior: 'smooth',
    block: 'start' // 或 'center', 'end', 'nearest'
});
```
block选项定义了元素在垂直方向上如何与视口对齐。

手动实现动画 (requestAnimationFrame): 如果需要更精细地控制滚动动画的持续时间、缓动函数（easing function）或在滚动过程中执行其他操作，你可以使用window.requestAnimationFrame()手动实现一个滚动动画循环。这会涉及更多的数学计算来插值滚动位置，但提供了最大的灵活性。

function smoothScrollTo(targetY, duration) {
    const startY = window.scrollY;
    const distance = targetY - startY;
    let startTime = null;

    function animation(currentTime) {
        if (startTime === null) startTime = currentTime;
        const timeElapsed = currentTime - startTime;
        const progress = Math.min(timeElapsed / duration, 1);
        // 可以使用不同的缓动函数，这里是简单的线性插值
        const easeProgress = progress; // 线性
        // 例如，使用ease-out-quad: const easeProgress = progress * (2 - progress);

        window.scrollTo(0, startY + distance * easeProgress);

        if (timeElapsed < duration) {
            requestAnimationFrame(animation);
        }
    }
    requestAnimationFrame(animation);
}

// 调用示例: 滚动到Y轴1000px位置，持续800毫秒
// smoothScrollTo(1000, 800);

这种方法虽然更复杂，但允许你完全自定义动画的每一个细节。

总结

对于大多数平滑滚动到指定位置的需求，window.scrollTo({ top: Y_COORDINATE, behavior: 'smooth' })是纯JavaScript中最简洁、性能最优且兼容性良好的解决方案。它直接利用了浏览器原生的滚动优化，避免了手动计算动画帧的复杂性。当需要将特定元素滚动到视口时，element.scrollIntoView({ behavior: 'smooth' })是其优秀的补充。只有在需要高度定制的滚动动画（如自定义缓动曲线、滚动中途暂停等）时，才需要考虑使用requestAnimationFrame手动实现。通过采用这些原生API，可以有效地移除jQuery等库的依赖，使项目更加轻量和高效。