0

0

Swiper.js教程:实现每次点击滑动多张幻灯片

心靈之曲

心靈之曲

发布时间:2025-11-15 11:26:02

|

317人浏览过

|

来源于php中文网

原创

Swiper.js教程:实现每次点击滑动多张幻灯片

本教程详细指导如何在swiper.js中配置每次点击导航按钮时滑动多张幻灯片,而非单张。通过结合使用`slidesperview`和关键参数`slidespergroup`,你将学会如何创建更具效率和视觉流畅度的轮播效果,特别适用于产品展示或图片画廊等场景,提升用户体验。

引言:Swiper.js多张幻灯片滑动需求

Swiper.js作为一款功能强大且高度可定制的触摸滑动器,广泛应用于现代Web开发中,用于创建图片轮播、产品展示、内容滚动等交互式组件。在许多场景下,我们可能希望轮播组件一次性展示多张幻灯片(例如,同时显示3张产品图),并且在用户点击导航按钮时,不是一张一张地滑动,而是按组(例如,一次滑动3张)进行切换,以提供更高效和直观的浏览体验。

默认情况下,Swiper配置slidesPerView大于1时,虽然会同时显示多张幻灯片,但点击导航按钮时,通常只会滑动一张。要实现按组滑动,我们需要利用Swiper提供的一个特定参数。

核心配置:slidesPerGroup 参数详解

要实现每次点击导航按钮时滑动多张幻灯片,Swiper.js提供了slidesPerGroup参数。

  • slidesPerView: 这个参数用于定义在Swiper容器中同时可见的幻灯片数量。例如,slidesPerView: 3表示同时显示3张幻灯片。
  • slidesPerGroup: 这是本教程的核心。它定义了每次点击导航按钮(或通过编程方式调用slideNext()/slidePrev())时,Swiper应该滑动的幻灯片数量。当slidesPerView > 1时,slidesPerGroup参数的作用尤为明显。

工作原理: 当slidesPerGroup设置为一个大于1的值时,Swiper不再逐个滑动幻灯片,而是将幻灯片分组,并以组为单位进行滑动。例如,如果slidesPerView: 3且slidesPerGroup: 3,Swiper会同时显示3张幻灯片,并且每次点击“下一页”按钮时,会直接跳过3张幻灯片,显示下一组幻灯片。

实现步骤与示例代码

下面将通过一个具体的例子,演示如何配置Swiper以实现每次点击滑动多张幻灯片。

1. HTML结构准备

首先,确保你的页面中包含了Swiper的基本HTML结构,并引入了Swiper的CSS和JavaScript库。

OmniAudio
OmniAudio

OmniAudio 是一款通过 AI 支持将网页、Word 文档、Gmail 内容、文本片段、视频音频文件都转换为音频播客,并生成可在常见 Podcast ap

下载
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Swiper.js 多张幻灯片分组滑动</title>
  <!-- 引入 Swiper CSS -->
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swiper@8/swiper-bundle.min.css">
  <style>
    /* 你的自定义CSS样式将放在这里 */
  </style>
</head>
<body>

  <div class="swiper">
    <div class="home-wrapper-categories swiper-wrapper">
      <article class="product-block swiper-slide">
        <header class="product-img">
          <img src="https://images.unsplash.com/photo-1578985545062-69928b1d9587?ixlib=rb-1.2.1&w=1080&fit=max&q=80&fm=jpg&crop=entropy&cs=tinysrgb" alt="产品图片1">
        </header>
      </article>
      <article class="product-block swiper-slide">
        <header class="product-img">
          <img src="https://images.unsplash.com/photo-1578985545062-69928b1d9587?ixlib=rb-1.2.1&w=1080&fit=max&q=80&fm=jpg&crop=entropy&cs=tinysrgb" alt="产品图片2">
        </header>
      </article>
      <article class="product-block swiper-slide drop-shadow">
        <header class="product-img">
          <img src="https://images.unsplash.com/photo-1578985545062-69928b1d9587?ixlib=rb-1.2.1&w=1080&fit=max&q=80&fm=jpg&crop=entropy&cs=tinysrgb" alt="产品图片3">
        </header>
      </article>
      <article class="product-block swiper-slide drop-shadow">
        <header class="product-img">
          <img src="https://images.unsplash.com/photo-1578985545062-69928b1d9587?ixlib=rb-1.2.1&w=1080&fit=max&q=80&fm=jpg&crop=entropy&cs=tinysrgb" alt="产品图片4">
        </header>
      </article>
      <article class="product-block swiper-slide drop-shadow">
        <header class="product-img">
          <img src="https://images.unsplash.com/photo-1578985545062-69928b1d9587?ixlib=rb-1.2.1&w=1080&fit=max&q=80&fm=jpg&crop=entropy&cs=tinysrgb" alt="产品图片5">
        </header>
      </article>
      <article class="product-block swiper-slide drop-shadow">
        <header class="product-img">
          <img src="https://images.unsplash.com/photo-1578985545062-69928b1d9587?ixlib=rb-1.2.1&w=1080&fit=max&q=80&fm=jpg&crop=entropy&cs=tinysrgb" alt="产品图片6">
        </header>
      </article>
    </div>

    <!-- 导航按钮 -->
    <div class="swiper-button-prev"></div>
    <div class="swiper-button-next"></div>

  </div>

  <!-- 引入 Swiper JS -->
  <script src="https://cdn.jsdelivr.net/npm/swiper@8/swiper-bundle.min.js"></script>
  <script>
    // 你的JavaScript初始化代码将放在这里
  </script>
</body>
</html>

2. CSS样式定义

为确保幻灯片和容器的正确显示,添加一些基本的CSS样式。

.swiper {
  width: 80%; /* 示例宽度 */
  margin: 20px auto;
  position: relative; /* 确保导航按钮定位正确 */
}

.product-block {
  background: #ffffff;
  border-radius: 4px;
  box-shadow: 0 2px 8px rgba(0,0,0,0.1);
  display: flex; /* 使内容居中或弹性布局 */
  justify-content: center;
  align-items: center;
  height: 200px; /* 示例高度 */
}

.product-img img {
  max-width: 100%;
  height: auto;
  aspect-ratio: 4 / 3.5; /* 保持图片比例 */
  object-fit: cover; /* 填充容器 */
  border-radius: 4px;
}

/* Swiper 导航按钮基础样式 */
.swiper-button-prev,
.swiper-button-next {
  color: #007aff; /* 按钮颜色 */
  width: 40px;
  height: 40px;
  background-color: rgba(255, 255, 255, 0.8);
  border-radius: 50%;
  box-shadow: 0 2px 5px rgba(0,0,0,0.2);
  top: 50%;
  transform: translateY(-50%);
}

.swiper-button-prev::after,
.swiper-button-next::after {
  font-size: 20px;
}

3. JavaScript初始化与关键配置

这是实现分组滑动的核心部分。我们需要在Swiper的初始化配置中添加slidesPerGroup参数。

const swiper = new Swiper('.swiper', {
  // 可选参数
  direction: 'horizontal', // 水平滑动
  loop: false, // 不循环

  // 导航箭头
  navigation: {
    nextEl: '.swiper-button-next',
    prevEl: '.swiper-button-prev',
  },

  // 响应式断点配置
  breakpoints: {
    // 当屏幕宽度大于等于600px时应用以下配置
    600: {
      slidesPerView: 3, // 同时显示3张幻灯片
      slidesPerGroup: 3, // 每次点击滑动3张幻灯片
      spaceBetween: 15 // 幻灯片之间的间距
    },
    // 可以添加更多断点,例如:
    // 1024: {
    //   slidesPerView: 4,
    //   slidesPerGroup: 4,
    //   spaceBetween: 20
    // },
    // 0: { // 默认配置,当屏幕宽度小于600px时
    //   slidesPerView: 1,
    //   slidesPerGroup: 1,
    //   spaceBetween: 10
    // }
  }
});

在上述JavaScript代码中,关键在于breakpoints对象内部的配置:

  • slidesPerView: 3: 定义了在屏幕宽度大于等于600px时,Swiper容器内同时显示3张幻灯片。
  • slidesPerGroup: 3: 这是实现每次点击滑动3张幻灯片的核心参数。 它确保了当用户点击“下一页”或“上一页”按钮时,Swiper会以3张幻灯片为一组进行整体滑动。
  • spaceBetween: 15: 设置幻灯片之间的间距为15像素。

注意事项与最佳实践

  1. slidesPerGroup与slidesPerView的关系: 为了获得最佳的用户体验和视觉效果,建议slidesPerGroup的值与slidesPerView的值保持一致。例如,如果显示3张,就滑动3张。 如果slidesPerGroup的值小于slidesPerView(例如slidesPerView: 3, slidesPerGroup: 1),则会显示3张,但每次只滑动1张,这可能不是你想要的分组滑动效果。 如果slidesPerGroup的值大于slidesPerView,或者不是slidesPerView的整数倍,可能会导致滑动时出现不完整的组,或者滑动行为不直观。

  2. 响应式设计 利用breakpoints参数是实现良好用户体验的关键。你可以为不同的屏幕尺寸定义不同的slidesPerView和slidesPerGroup值,确保在桌面、平板和移动设备上都能呈现最佳的幻灯片分组滑动效果。例如,在小屏幕上可能只显示1张并滑动1张,而在大屏幕上显示3张并滑动3张。

  3. 循环模式(loop: true)下的考虑: 当启用loop: true时,Swiper会复制幻灯片以创建无缝循环效果。在这种情况下,slidesPerGroup的行为可能会稍微复杂一些。通常,它仍然会按组滑动,但建议在启用循环时进行充分测试,以确保滑动逻辑符合预期。

  4. 幻灯片总数与分组: 如果幻灯片的总数不是slidesPerGroup的倍数,那么最后一组幻灯片可能不会填满整个视图,或者在滑动到末尾时行为会略有不同。这是正常现象,但需要考虑是否符合设计要求。

总结

通过在Swiper初始化配置中合理使用slidesPerGroup参数,你可以轻松实现每次点击导航按钮时滑动多张幻灯片的功能。结合slidesPerView和breakpoints进行响应式配置,能够极大地提升用户在不同设备上的浏览体验。务必根据你的具体项目需求和设计目标,灵活调整这些参数,以创建出最符合预期的轮播效果。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

531

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

576

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

761

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

6284

2023.08.17

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

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

494

2023.09.01

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

240

2023.09.14

js截取字符串的方法介绍
js截取字符串的方法介绍

JavaScript字符串截取方法,包括substring、slice、substr、charAt和split方法。这些方法可以根据具体需求,灵活地截取字符串的不同部分。在实际开发中,根据具体情况选择合适的方法进行字符串截取,能够提高代码的效率和可读性 。

303

2023.09.21

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

49

2026.03.13

热门下载

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

精品课程

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

共14课时 | 0.9万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

CSS教程
CSS教程

共754课时 | 43.3万人学习

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

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