0

0

jQuery与CSS实现平滑横向滚动:鼠标滚轮控制内容位移

霞舞

霞舞

发布时间:2025-10-24 10:56:13

|

899人浏览过

|

来源于php中文网

原创

jquery与css实现平滑横向滚动:鼠标滚轮控制内容位移

本文详细介绍了如何利用jQuery和CSS实现一个响应鼠标滚轮事件的平滑横向滚动效果。通过巧妙结合CSS的`display: inline-block`和`white-space: nowrap`布局,以及jQuery监听`wheel`事件并动态调整元素的`transform: translateX`属性,我们能够创建出既流畅又具备边界限制的水平滚动页面,提升用户交互体验。

实现平滑横向滚动:jQuery与CSS的协同应用

在现代网页设计中,为了提供更丰富的视觉体验和内容呈现方式,横向滚动布局越来越受欢迎。传统的垂直滚动是默认行为,但通过结合CSS布局和JavaScript(尤其是jQuery)事件处理,我们可以轻松实现响应鼠标滚轮的平滑横向滚动效果。本教程将指导您构建一个具备起始和结束边界限制的水平滚动组件。

1. HTML结构搭建

首先,我们需要一个包含多个内容区块的容器。每个区块代表一个独立的页面或内容部分,它们将水平排列。


Section 1

Section 2

Section 3

Section 4

Section 5

在上述结构中:

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

  • 是所有横向滚动内容的父容器。
  • 元素是实际的滚动内容区块,每个区块都会占据一定的水平空间。
  • 我们引入了jQuery库,这是实现交互逻辑的基础。
  • 2. CSS样式定义

    CSS是实现横向布局和动画平滑度的关键。我们将使用display: inline-block使内容区块水平排列,并利用white-space: nowrap防止它们换行。同时,为了实现平滑的滚动动画,我们将为容器添加transition-duration属性。

    html, body{
        margin: 0px;
        overflow: hidden; /* 隐藏默认的滚动条 */
    }
    section {
        height: 99vh; /* 每个区块占据视口高度的99% */
        display: inline-block; /* 使区块水平排列 */
        width: 33.3%; /* 每个区块占据父容器宽度的1/3,意味着一次显示约3个区块 */
        border: 1px solid red; /* 方便调试的边框 */
        overflow: visible; /* 确保区块内容超出其自身边界时可见 */
    }
    
    .scroll-sections {
        white-space: nowrap; /* 防止内部的inline-block元素换行 */
        height: 100%; /* 占据父容器(body)的全部高度 */
        overflow: visible; /* 允许内容超出容器边界 */
        transition-duration: 0.5s; /* 设置CSS过渡动画时长,使滚动更平滑 */
    }

    关键CSS属性解释:

    MCP Market
    MCP Market

    MCP Servers集合平台,帮你找到最好的MCP服务器

    下载
    • html, body { margin: 0px; overflow: hidden; }: 移除浏览器默认边距,并隐藏页面的默认滚动条,确保我们完全控制滚动行为。
    • section { display: inline-block; width: 33.3%; }: 使得多个section元素能够并排显示,且每个section占据容器宽度的三分之一,从而在视口中同时显示大约三个区块。
    • .scroll-sections { white-space: nowrap; transition-duration: 0.5s; }: white-space: nowrap是实现水平布局的关键,它强制所有子元素保持在同一行。transition-duration: 0.5s则为transform属性的变化提供了平滑的动画效果。

    3. jQuery交互逻辑实现

    jQuery将负责监听鼠标滚轮事件,计算滚动位置,并应用CSS transform属性来实现横向位移,同时处理滚动边界。

    $(document).ready(function(){
        var pos = 0; // 当前滚动位置,表示translateX的像素值
        var lastElement = $(".scroll-sections").children().last(); // 获取最后一个section元素
        // 计算最大滚动距离 (即最右侧的滚动边界)
        // 滚动容器的宽度 - (最后一个元素的左偏移量 + 最后一个元素的宽度)
        // 结果将是一个负值,表示scroll-sections需要向左移动的最大距离
        var maxScroll = $(".scroll-sections").width() - (lastElement.offset().left + lastElement.outerWidth());
    
        // 监听鼠标滚轮事件 (现代浏览器推荐使用'wheel'事件)
        $(".scroll-sections").on('wheel', function(event) {
            // 根据滚轮方向调整滚动位置
            // event.originalEvent.wheelDelta 通常在Chrome/Safari中是120或-120,Firefox使用event.originalEvent.detail
            // 此处使用wheelDelta/3来调整滚动速度
            pos = pos + (event.originalEvent.wheelDelta / 3);
    
            // 边界检查:防止内容滚动超出左侧边界 (pos不能大于0)
            if(pos > 0 ){
                pos = 0;
            } 
            // 边界检查:防止内容滚动超出右侧边界 (pos不能小于maxScroll)
            if(pos < maxScroll){
                pos = maxScroll;
            }
    
            // 应用CSS transform属性实现平滑位移
            $(".scroll-sections").css({'transform': 'translateX(' + pos + 'px)'});
    
            // 阻止默认的垂直滚动行为
            return false;
        });
    });

    核心JavaScript逻辑分析:

    • pos 变量: 存储当前scroll-sections容器的水平偏移量(translateX的值)。初始值为0,表示内容在最左侧。
    • maxScroll 计算: 这是实现滚动边界的关键。
      • $(".scroll-sections").width(): 获取scroll-sections容器的当前可见宽度,即视口宽度。
      • lastElement.offset().left + lastElement.outerWidth(): 计算最后一个section元素的右侧边缘相对于文档左侧的绝对位置。
      • maxScroll 的计算结果是一个负值,它代表了当最后一个section的右边缘刚好与scroll-sections容器的右边缘对齐时,scroll-sections容器需要向左移动的距离。
    • wheel 事件监听: 这是一个现代且标准化的鼠标滚轮事件。event.originalEvent.wheelDelta提供了滚轮滚动的方向和幅度(正值向上滚,负值向下滚)。我们将其除以3以减缓滚动速度。
    • 边界检查:
      • if(pos > 0) { pos = 0; }: 当用户尝试向右滚动超过起始位置时,将pos重置为0,确保内容不会向右超出左侧边界。
      • if(pos
    • transform: translateX(): 使用CSS transform属性来移动元素。相较于直接修改left属性,transform通常能获得更好的性能和更平滑的动画效果,因为它利用了GPU加速。
    • return false;: 阻止浏览器执行默认的垂直滚动行为,确保只有我们的横向滚动逻辑生效。

    4. 完整示例与注意事项

    将上述HTML、CSS和jQuery代码整合到您的项目中,即可实现一个功能完善的横向滚动页面。

    注意事项:

    1. 响应式设计: 示例中section的width: 33.3%使其在不同视口宽度下自动调整大小。如果您的内容区块数量或布局需求不同,请相应调整此值。
    2. 动态内容: 如果scroll-sections内的内容是动态加载的,或者其宽度会发生变化,您可能需要在内容加载或窗口大小调整后重新计算maxScroll值。
    3. 滚动速度: event.originalEvent.wheelDelta / 3中的除数可以根据需要调整,以控制滚动的灵敏度。
    4. 平滑度: transition-duration值越大,滚动动画越慢越平滑;值越小,动画越快。
    5. 兼容性: wheel事件在现代浏览器中具有良好支持。对于老旧浏览器,可能需要同时监听mousewheel和DOMMouseScroll事件,并处理它们各自的事件对象属性(如wheelDelta和detail)。不过,jQuery的on('wheel')通常会提供一定程度的抽象。

    总结

    通过本教程,您已经学会了如何结合HTML、CSS和jQuery来创建一个平滑且带有边界限制的鼠标滚轮控制横向滚动页面。这种技术在构建产品展示、时间轴或任何需要水平内容流的网站时都非常有用,能够显著提升用户体验和页面的视觉吸引力。记住,关键在于利用CSS的布局特性和transform动画,并通过JavaScript精确控制滚动逻辑和边界条件。

相关专题

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

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

557

2023.06.20

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

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

395

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属性,用于删除节点的内容。

478

2023.09.01

JavaScript转义字符
JavaScript转义字符

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

474

2023.09.04

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

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

1051

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

菜鸟裹裹入口以及教程汇总
菜鸟裹裹入口以及教程汇总

本专题整合了菜鸟裹裹入口地址及教程分享,阅读专题下面的文章了解更多详细内容。

0

2026.01.22

热门下载

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

精品课程

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

共14课时 | 0.8万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3万人学习

CSS教程
CSS教程

共754课时 | 22.4万人学习

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

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