0

0

jQuery与CSS实现平滑的鼠标滚轮控制水平滚动

DDD

DDD

发布时间:2025-10-24 11:15:28

|

583人浏览过

|

来源于php中文网

原创

jquery与css实现平滑的鼠标滚轮控制水平滚动

本教程详细讲解如何利用jQuery和CSS实现一个响应鼠标滚轮的平滑水平滚动效果。通过监听`wheel`事件并动态调整元素的`transform: translateX`属性,同时精确计算滚动边界,我们能创建出用户体验极佳的水平布局,有效解决传统垂直滚动在水平展示场景中的不适和边界溢出问题。

核心概念与实现原理

网页设计中,有时我们需要呈现一种非传统的水平滚动体验,即用户通过鼠标滚轮向上或向下滚动时,页面内容向左或向右移动。这种效果通常用于展示画廊、产品特性或时间轴等内容,能够提供更具沉浸感的交互。实现这一效果的关键在于以下几点:

  1. HTML结构: 构建一个包含多个子元素的容器,这些子元素将水平排列。
  2. CSS布局: 利用CSS将子元素强制水平排列,并隐藏浏览器默认的滚动条。同时,通过transition属性为元素的位移添加平滑过渡效果。
  3. JavaScript交互: 监听鼠标滚轮事件,根据滚轮方向和强度计算容器的水平位移量,并通过CSS transform: translateX()属性来更新容器的位置。
  4. 边界控制: 确保滚动不会超出内容的起始和结束位置,避免出现空白区域或无法回滚的问题。

HTML 结构

首先,我们需要一个包含多个section元素的容器。每个section代表一个独立的水平滚动“页面”或内容块。为了引入jQuery库,我们通常会在

标签结束前或标签内引入CDN链接。



    
    
    水平滚动教程
    
    
     


    

Section 1

Section 2

Section 3

Section 4

Section 5

CSS 样式

CSS是实现水平布局和视觉平滑度的关键。我们将隐藏页面的默认滚动条,使section元素水平排列,并为容器的移动添加过渡效果。

立即学习前端免费学习笔记(深入)”;

Originality AI
Originality AI

专门为网络出版商设计的抄袭和AI检测工具

下载
/* style.css */
html, body {
    margin: 0;
    overflow: hidden; /* 隐藏浏览器默认的垂直滚动条 */
}

.scroll-sections {
    white-space: nowrap; /* 阻止子元素换行,使它们水平排列 */
    height: 100%; /* 容器高度占满视口 */
    overflow: visible; /* 内容超出容器时可见,滚动由JS控制 */
    transition-duration: 0.5s; /* 为transform属性添加0.5秒的过渡动画,实现平滑滚动 */
    /* transform: translateX(0); /* 初始位置,可省略 */
}

section {
    height: 99vh; /* 每个section占据视口高度的99% */
    display: inline-block; /* 使section元素水平排列 */
    width: 33.3%; /* 示例:每屏显示约3个section的内容 */
    border: 1px solid red; /* 调试用边框,可移除 */
    vertical-align: top; /* 确保inline-block元素顶部对齐 */
    box-sizing: border-box; /* 边框和内边距包含在宽度内 */
}

CSS样式说明:

  • html, body { overflow: hidden; }: 禁用浏览器自身的垂直滚动条,将滚动控制权完全交给JavaScript。
  • .scroll-sections { white-space: nowrap; }: 这是实现水平布局的关键,它会强制所有子元素在同一行显示,即使它们超出了父容器的宽度。
  • .scroll-sections { transition-duration: 0.5s; }: 当JavaScript改变.scroll-sections的transform属性时,这个属性会使变化在0.5秒内平滑完成,而不是瞬间跳变。
  • section { display: inline-block; width: 33.3%; }: 将section元素设置为行内块级元素,使其可以水平排列,并设定宽度为父容器的1/3,以实现一次显示多个section的效果。vertical-align: top确保它们在基线上对齐。

jQuery 逻辑

jQuery代码负责监听鼠标滚轮事件,计算新的滚动位置,并更新容器的transform属性。同时,它还包含了重要的边界检测逻辑,以防止无限滚动。

// script.js
$(document).ready(function(){
    var pos = 0; // 初始化当前滚动位置,表示translateX的像素值

    // 获取最后一个子元素,用于计算最大可滚动距离
    var lastElement = $(".scroll-sections").children().last();

    // 计算最大滚动距离 (maxScroll)。
    // maxScroll是一个负值,表示当最后一个section的右边缘刚好对齐视口右边缘时,
    // .scroll-sections容器需要向左移动的距离。
    // 计算方式:视口宽度 - (最后一个元素的左偏移 + 最后一个元素的宽度)
    var maxScroll = $(".scroll-sections").width() - (lastElement.offset().left + lastElement.outerWidth());

    // 监听.scroll-sections容器的'wheel'事件
    // 'wheel'事件是现代浏览器推荐的滚轮事件,比'mousewheel'和'DOMMouseScroll'更通用。
    $(".scroll-sections").on('wheel', function(event) {
        // 根据滚轮方向和强度调整位置
        // event.originalEvent.wheelDelta:滚轮滚动量,通常为 ±120。
        // 除以一个值(例如3)可以调整滚动速度。
        pos = pos + (event.originalEvent.wheelDelta / 3);

        // 边界检查:
        // 1. 限制向右滚动:如果当前位置 (pos) 大于0,说明已经滚到最左边了,强制设置为0。
        //    即不能再向右滚动。
        if (pos > 0) {
            pos = 0;
        } 
        // 2. 限制向左滚动:如果当前位置 (pos) 小于maxScroll,说明已经滚到最右边了,
        //    强制设置为maxScroll。即不能再向左滚动。
        if (pos < maxScroll) {
            pos = maxScroll;
        }

        // 使用CSS transform属性实现平滑位移
        // transform: translateX() 性能优于直接修改left/margin-left
        $(".scroll-sections").css({'transform': 'translateX(' + pos + 'px)'});

        // 阻止浏览器默认的垂直滚动行为
        return false;
    });
});

jQuery逻辑说明:

  • var pos = 0;: pos变量存储当前.scroll-sections容器的水平偏移量。初始值为0,表示内容在最左端。
  • var lastElement = $(".scroll-sections").children().last();: 获取scroll-sections容器中的最后一个section元素。
  • var maxScroll = $(".scroll-sections").width() - (lastElement.offset().left + lastElement.outerWidth());: 这是计算最大滚动距离的关键。
    • $(".scroll-sections").width():获取.scroll-sections容器的当前可视宽度(通常等于视口宽度)。
    • lastElement.offset().left + lastElement.outerWidth():计算最后一个section元素的右边缘相对于文档左边缘的绝对位置。
    • 两者相减,得到的值是一个负数,表示当最后一个section的右边缘刚好与视口右边缘对齐时,.scroll-sections容器需要向左移动的距离。
  • $(".scroll-sections").on('wheel', function(event) { ... });: 监听wheel事件。wheel事件是处理鼠标滚轮的推荐方式,它提供了滚轮方向和滚动量的详细信息。
  • pos = pos + (event.originalEvent.wheelDelta / 3);: event.originalEvent.wheelDelta是一个表示滚轮滚动方向和强度的值(通常为±120)。通过除以3,可以调整每次滚动的速度,使其更平滑。正值表示向上滚动(内容向右移),负值表示向下滚动(内容向左移)。
  • 边界限制:
    • if (pos > 0) { pos = 0; }: 当用户尝试向右滚动超过最左端时,将pos重置为0,防止内容滚出左侧边界。
    • if (pos
  • $(".scroll-sections").css({'transform': 'translateX(' + pos + 'px)'});: 使用transform: translateX()属性来移动容器。相比于left或margin-left,transform通常能获得更好的性能和更平滑的动画效果,因为它由GPU加速。
  • return false;: 阻止浏览器执行默认的滚轮行为(例如垂直滚动页面),确保只有我们的水平滚动逻辑生效。

注意事项与优化

  1. 滚轮速度调整: 在jQuery代码中,event.originalEvent.wheelDelta / 3中的除数可以根据需求调整。除数越大,滚动速度越慢;除数越小,滚动速度越快。
  2. 平滑度调整: CSS中的transition-duration属性直接影响滚动动画的平滑程度。值越大,过渡时间越长,滚动越“慢”越平滑;值越小,过渡越快。
  3. 兼容性: wheel事件在现代浏览器中支持良好。如果需要支持非常老的浏览器,可能需要同时监听mousewheel和DOMMouseScroll事件,并进行兼容性处理。不过,对于大多数现代Web项目,wheel事件已足够。
  4. 响应式设计: 示例中的section { width: 33.3%; }是为了在视口中同时显示约3个section。在实际项目中,你可能需要根据屏幕尺寸使用媒体查询来调整section的宽度,以适应不同的设备。
  5. 内容动态加载: 如果section内容是动态加载

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

558

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

416

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

756

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

479

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

534

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

1091

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

659

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

554

2023.09.20

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

41

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 0.8万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3万人学习

CSS教程
CSS教程

共754课时 | 23.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号