为之漫笔

5行JavaScript代码实现页面平滑滚动

原文链接: thenewcode.com

HTML本身具有跳到页面任意位置的能力,只需给目标元素一个id 属性即可。这个技术叫做“锚链接”。

不过,这种跳转是瞬间完成的。为了让人看起来舒服,很多网站都会给页内跳转加上平滑或慢慢滚动到页面某处的设计。

过去人们大都用jQuery来实现此设计,但为这就加载一个框架有点小题大做。现代JavaScript为此提供了原生的window.scrollTo方法,效率更高。

首先,还是要有一个标准的锚链接,以防新技术不可用,还可以照老样子跳到目标。

<a href="#destination">Click me: I’m <em>smoooooth</em>.</a>
…
 <p id="destination">This is the target, further down the page.

显然,只有页面长度超过窗口高度才可能真的跳转。为此,请自行在前面代码中省略号位置补充足够多的内容(或者试试我们推荐的填充文本生成器)。

两种滚动

页面滚动的API有两种实现方式:CSS和JavaScript。两种方式本身就容易让人困惑,再加上有些浏览器支持有些浏览器不支持,或者只以实验方式支持,问题就显得复杂了。(参见下文。)

CSS实现方式下,需要给“平滑滚动”的元素(通常是body)应用scroll-behavior: smoothCSS参考):

body {
    scroll-behavior: smooth;
}

注意,别用英式写法,是scroll-behavior,没有“u”。

JavaScript方式

JavaScript代码要添加到页面最后,以免阻塞。没错,我们说了只用5行代码。这里为方便解释,我稍微增加几行:

var anchorLink = document.querySelector("a[href='#destination']"),
target = document.getElementById("destination");
anchorLink.addEventListener("click", function(e) {
    if (window.scrollTo) {
        e.preventDefault();
        window.scrollTo({"behavior": "smooth", "top": target.offsetTop});
    }
})

先用querySelector通过CSS属性选择符找到href目标为#destination的链接。在链接的点击事件中,测试浏览器是否支持scrollTo方法。如果支持,先用e.preventDefault阻止浏览器立即跳转,然后调用scrollTo方法,由前面的CSS声明实现平滑效果。有3个选项:behaviortop必需,left可选。后两个指的是跳转目标在页面中的位置坐标值。

可以用window.scroll代替window.scrollTo,它们功能一样。

相对于加载框架,这几行代码简单得多。唯一的缺点是不允许修改计时函数或缓动函数,据说是防止被滥用。

脚本抽象

前面的脚本可以用,但要求你必须提前知道跳转目标的名字,而且只能应用到一个链接。要是页面中有多个链接,需要平滑跳转到多个目标呢?这时就需要对脚本做一点抽象。

因为我们要引用nodeList,所以先写一个帮助函数,在forEach循环里关联链接:

var forEach = function (array, callback, scope) {
  for (var i = 0; i < array.length; i++) {
    callback.call(scope, i, array[i]);
  }
}; 

然后,找到所有锚链接和它们的地址,给它们的点击事件注册scrollTo

 var anchorLinks = document.querySelectorAll("a[href^='#']");
if (window.scrollTo) {
    forEach(anchorLinks, function(index, element) {
        var target = document.getElementById(element.getAttribute("href").substring(1));
        element.addEventListener("click", function(el) {
            el.preventDefault();
            window.scrollTo(0, target.offsetTop); 
        })
    });
}

注意,同样需要在body标签的CSS样式中添加scroll-behavior声明。

浏览器支持

以上技术当前面临的问题是浏览器兼容性,现在只有Firefox和Chrome支持window.scrollTo,而且后者还把实现隐藏在chrome://flags中一个“实验性网络平台功能”的选项里(需要手工启用)。

Chrome浏览器“实验性网络平台功能”选项

正像一开始咱们说的,前面的脚本是基于“渐进增强”原则写的,所以不支持的浏览器照样能正确跳转,只是不能平滑地滚过去而已。为此,我推荐Dustan Kasten写的“腻子脚本”smoothscroll

结论

这个技术经常与“粘贴便签”(sticky)联用,后者会随着页面滚动一直出现在窗口中。更多内容,欢迎参考我的另一篇文章