百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

七爪源码:纯 CSS 和 JS 的原生平滑滚动

myzbx 2025-02-27 15:57 42 浏览

纯 CSS 和 JS 的原生平滑滚动

你想要一个平滑的滚动吗? 忘记 JQuery,我们已经过去了。 让我向您介绍我们的原生平滑滚动工具。


CSS 滚动行为

CSS scroll-behavior 属性接受三个值之一 - 实际上是两个值,因为其中一个已被弃用。

  1. scroll-behavior: auto 是我们已经习惯的默认即时滚动行为。
  2. scroll-behavior:instant 与 auto 相同,这就是它被弃用的原因。 如果你想要它,只需使用自动。
  3. scroll-behavior: smooth 在以编程方式触发滚动事件时应用平滑过渡。

我说“以编程方式触发”是因为它不会平滑滚动鼠标滚轮。

以编程方式触发滚动事件的一些方法是:

-    Window.scrollTo()
-    Window.scrollBy()
-    Element.scrollTo()
-    Element.scrollBy()
-    Element.scrollIntoView()
-    Element.scrollLeft = x
-    Element.scrollTop = y

我们将分别探索这些方法。


(注)Window.scroll() 和 Element.scroll()

也许你已经注意到我没有提到 scroll() 方法。

这是因为 Window.scroll() 和 Element.scroll() 实际上是与 Window.scrollTo() 和 Element.scrollTo() 相同的方法。为避免重复内容,我将仅参考 scrollTo()。在实践中,您可以使用任何一种,只需选择一个并保持一致。


Window.scrollTo() 和 Element.scrollTo()

此方法非常适合滚动到绝对坐标。如果您有要将用户滚动到的位置的 x 和 y 坐标,您可以简单地调用 window.scrollTo(x, y) ,它会尊重页面的 CSS 滚动行为。

这同样适用于可滚动元素。您只需调用 element.scrollTo(x, y) ,它就会尊重元素的 CSS 滚动行为。

这个方法还有一个新的签名,它使用一个对象而不是两个数字参数,通过这个新的签名,我们可以显式地设置我们的滚动行为。

// For window
window.scrollTo({
  left: x,
  top: y,
  behavior: 'smooth'
});
// For element
const el = document.querySelector(...);
el.scrollTo({
  left: x,
  top: y,
  behavior: 'smooth'
});


Element.scrollLeft 和 Element.scrollTop

设置元素 .scrollLeft 和 .scrollTop 属性与使用坐标调用 Element.scrollTo() 相同。 它将尊重元素的 CSS 滚动行为。

const el = document.querySelector(...);
const x = 100;
const y = 500;
// Setting .scrollLeft and .scrollTop with smooth scroll
el.style.scrollBehavior = 'smooth';
el.scrollLeft = x;
el.scrollTop = y;
// Is the same as calling Element.scrollTo()
el.scrollTo({ left: x, top: y, behavior: 'smooth' });


(注)负元素.scrollLeft

如果你的元素文本的方向是 rtl,scrollLeft = 0 表示水平滚动的最右边位置,并且随着你向左移动,值会减小。

对于宽度为 100px,可滚动宽度为 500px,方向为 rtl 的可滚动元素,最左边的位置是 scrollLeft = -400。

const scrollable = document.querySelector('#scrollable');
const output = document.querySelector('#output');
const updateOutput = () => {
  output.textContent = `scrollLeft: ${scrollable.scrollLeft}`;
};
updateOutput();
scrollable.addEventListener('scroll', updateOutput);


Window.scrollBy() 和 Element.scrollBy()

此方法与 Window.scrollTo() 或 Element.scrollTo() 具有完全相同的签名。 它接受 x 和 y 作为两个数字参数或作为具有可选 left、top 和 behavior 属性的对象的单个参数。

这里的区别是我们不是传递绝对坐标,而是相对值。 如果我们 scrollBy({ top: 10 }),我们从当前位置向下滚动 10 个像素,而不是从页面开头向下滚动 10 个像素。

// For window
window.scrollBy({ top: 10 }); // Scroll 10px down
window.scrollBy({ left: 20 }); // Then 20px to the right
window.scrollBy({ top: 50 }); // And then 50px down
// For element
const el = document.querySelector(...);
el.scrollBy({ top: 10 }); // Scroll 10px down
el.scrollBy({ left: 20 }); // Then 20px to the right
el.scrollBy({ top: 50 }); // And then 50px down


(注) Window.scrollByLines() 和 Window.scrollByPages()

Firefox 更进一步,实现了滚动多行或多页的方法。 这是一个仅适用于 Firefox 的非标准功能,因此您可能不想在生产中使用它。

通过将 100vh(用于页面)和 1rem(用于行)转换为像素并将该值传递给 Window.scrollBy(),您可以在所有主要浏览器中实现类似的效果。

const toPixels = require('to-px'); // From NPM
const page = toPixels('100vh');
window.scrollBy(0, page); // window.scrolByPages(1)
const line = toPixels('1rem');
window.scrollBy(0, line); // window.scrolByLines(1)


Element.scrollIntoView()

但大多数时候,我们并不关心任何硬编码的坐标,我们只想将用户滚动到屏幕上的特定元素。 这可以通过 Element.scrollIntoView() 轻松(更明确地)完成。

可以不带参数调用此方法,它将滚动页面(尊重 CSS 滚动行为)直到元素在顶部对齐(除非元素在页面底部,在这种情况下,它会 尽可能滚动)。

Some space
Our element
More space
const target = document.querySelector('#target');
target.scrollIntoView();

您可以通过传递布尔值或对象来进一步自定义元素在视图中的位置。

const el = document.querySelector(...);
// Default, aligns at the top
el.scrollIntoView(true);
// Aligns at the bottom
el.scrollIntoView(false);
// Aligns vertically at the center
el.scrollIntoView({ block: 'center' });
// Vertical top and horizontal center
el.scrollIntoView({ block: 'start', inline: 'center' });
// Vertical bottom and horizontal right
el.scrollIntoView({ block: 'end', inline: 'end' });
// Vertical center and smooth
el.scrollIntoView({ block: 'center', behavior: 'smooth' });
// Vertical nearest
el.scrollIntoView({ block: 'nearest' });

当使用一个对象来定义元素的位置时,注意 block 是指垂直放置,而 inline 是指水平放置。此外,“最近”的位置可以是顶部/左侧或底部/右侧,以最近的为准,如果元素已经在视图中,它也可以是空的。


浏览器支持

{关于浏览器支持} 在撰写本文时,所有主流浏览器(Safari 除外)都支持平滑滚动和本文中描述的滚动方法。

如果你需要更多的保证,我在我的项目中使用了一个非常好的平滑滚动 polyfill。它填充了 scroll()、scrollTo()、scrollBy()、scrollIntoView() 和 CSS 滚动行为。它不支持通过设置 scrollLeft/scrollTop 来平滑滚动,也不支持 scrollIntoView() 选项(它总是在顶部对齐元素)。

如果你有更多的好奇心,我强烈建议你研究一下 polyfill 的源代码,总共不到 500 行。我做了一个 PR 来稍微改进文档,你可能会发现代码更容易理解。


祝你有美好的一天,很快见到你。

相关推荐

如何设计一个优秀的电子商务产品详情页

加入人人都是产品经理【起点学院】产品经理实战训练营,BAT产品总监手把手带你学产品电子商务网站的产品详情页面无疑是设计师和开发人员关注的最重要的网页之一。产品详情页面是客户作出“加入购物车”决定的页面...

怎么在JS中使用Ajax进行异步请求?

大家好,今天我来分享一项JavaScript的实战技巧,即如何在JS中使用Ajax进行异步请求,让你的网页速度瞬间提升。Ajax是一种在不刷新整个网页的情况下与服务器进行数据交互的技术,可以实现异步加...

中小企业如何组建,管理团队_中小企业应当如何开展组织结构设计变革

前言写了太多关于产品的东西觉得应该换换口味.从码农到架构师,从前端到平面再到UI、UE,最后走向了产品这条不归路,其实以前一直再给你们讲.产品经理跟项目经理区别没有特别大,两个岗位之间有很...

前端监控 SDK 开发分享_前端监控系统 开源

一、前言随着前端的发展和被重视,慢慢的行业内对于前端监控系统的重视程度也在增加。这里不对为什么需要监控再做解释。那我们先直接说说需求。对于中小型公司来说,可以直接使用三方的监控,比如自己搭建一套免费的...

Ajax 会被 fetch 取代吗?Axios 怎么办?

大家好,很高兴又见面了,我是"高级前端进阶",由我带着大家一起关注前端前沿、深入前端底层技术,大家一起进步,也欢迎大家关注、点赞、收藏、转发!今天给大家带来的主题是ajax、fetch...

前端面试题《AJAX》_前端面试ajax考点汇总

1.什么是ajax?ajax作用是什么?AJAX=异步JavaScript和XML。AJAX是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,AJAX可以使网页实...

Ajax 详细介绍_ajax

1、ajax是什么?asynchronousjavascriptandxml:异步的javascript和xml。ajax是用来改善用户体验的一种技术,其本质是利用浏览器内置的一个特殊的...

6款可替代dreamweaver的工具_替代powerdesigner的工具

dreamweaver对一个web前端工作者来说,再熟悉不过了,像我07年接触web前端开发就是用的dreamweaver,一直用到现在,身边的朋友有跟我推荐过各种更好用的可替代dreamweaver...

我敢保证,全网没有再比这更详细的Java知识点总结了,送你啊

接下来你看到的将是全网最详细的Java知识点总结,全文分为三大部分:Java基础、Java框架、Java+云数据小编将为大家仔细讲解每大部分里面的详细知识点,别眨眼,从小白到大佬、零基础到精通,你绝...

福斯《死侍》发布新剧照 "小贱贱"韦德被改造前造型曝光

时光网讯福斯出品的科幻片《死侍》今天发布新剧照,其中一张是较为罕见的死侍在被改造之前的剧照,其余两张剧照都是死侍在执行任务中的状态。据外媒推测,片方此时发布剧照,预计是为了给不久之后影片发布首款正式预...

2021年超详细的java学习路线总结—纯干货分享

本文整理了java开发的学习路线和相关的学习资源,非常适合零基础入门java的同学,希望大家在学习的时候,能够节省时间。纯干货,良心推荐!第一阶段:Java基础重点知识点:数据类型、核心语法、面向对象...

不用海淘,真黑五来到你身边:亚马逊15件热卖爆款推荐!

Fujifilm富士instaxMini8小黄人拍立得相机(黄色/蓝色)扫二维码进入购物页面黑五是入手一个轻巧可爱的拍立得相机的好时机,此款是mini8的小黄人特别版,除了颜色涂装成小黄人...

2025 年 Python 爬虫四大前沿技术:从异步到 AI

作为互联网大厂的后端Python爬虫开发,你是否也曾遇到过这些痛点:面对海量目标URL,单线程爬虫爬取一周还没完成任务;动态渲染的SPA页面,requests库返回的全是空白代码;好不容易...

最贱超级英雄《死侍》来了!_死侍超燃

死侍Deadpool(2016)导演:蒂姆·米勒编剧:略特·里斯/保罗·沃尼克主演:瑞恩·雷诺兹/莫蕾娜·巴卡林/吉娜·卡拉诺/艾德·斯克林/T·J·米勒类型:动作/...

停止javascript的ajax请求,取消axios请求,取消reactfetch请求

一、Ajax原生里可以通过XMLHttpRequest对象上的abort方法来中断ajax。注意abort方法不能阻止向服务器发送请求,只能停止当前ajax请求。停止javascript的ajax请求...