Swiper JS 图片轮播插件快速上手指南

作者:半夏

时间:2026-10-21

浏览:260

本文介绍如何使用优秀的 JS 图片轮播插件 Swiper。内容涵盖从下载插件文件、引入 CSS 和 JS 资源,到构建 HTML 结构、定义容器样式,以及通过 JavaScript 初始化 Swiper 实例的完整步骤。特别说明了初始化时机对页面加载完成的影响,帮助开发者快速实现响应式轮播效果。

文章目录

近期在微信公众号项目中使用了 Swiper 图片轮播插件,下面将详细介绍该插件的具体使用方法。

获取与引入插件

第一步是获取 Swiper 插件文件。

1:加载插件,需要用到的文件有swiper.min.js和swiper.min.css文件。


<!DOCTYPE html>
<html>
<head>
  ...
  <link rel="stylesheet" href="path/to/swiper.min.css">
</head>
<body>
  ...
  <script src="path/to/swiper.min.js"></script>
</body>
</html>

HTML 结构构建

接下来编写 HTML 结构内容。


<div class="swiper-container">
  <div class="swiper-wrapper">
    <div class="swiper-slide">Slide 1</div>
    <div class="swiper-slide">Slide 2</div>
    <div class="swiper-slide">Slide 3</div>
  </div>
  <!-- 如果需要分页器 -->
  <div class="swiper-pagination"></div>
  <!-- 如果需要导航按钮 -->
  <div class="swiper-button-prev"></div>
  <div class="swiper-button-next"></div>
  <!-- 如果需要滚动条 -->
  <div class="swiper-scrollbar"></div>
</div>

导航组件等元素可以放置在 container 容器之外。

第三,建议为 Swiper 容器定义宽高尺寸,当然不设置也可由内容自适应。


.swiper-container {
  width: 600px;
  height: 300px;
}

样式定义与初始化

第四,初始化 Swiper 实例,最佳位置是紧邻 </body> 标签之前。


<script>    
 var mySwiper = new Swiper ('.swiper-container', {
  direction: 'vertical',
  loop: true,
  // 如果需要分页器
  pagination: '.swiper-pagination',
  // 如果需要前进后退按钮
  nextButton: '.swiper-button-next',
  prevButton: '.swiper-button-prev',
  // 如果需要滚动条
  scrollbar: '.swiper-scrollbar',
 })    
 </script>
</body>

若无法将初始化代码放在 HTML 内容末尾,则需确保在页面加载完成后执行初始化逻辑。


<script type="text/javascript">
window.onload = function() {
 ...
}
</script>
或者这样(jQuery和Zepto)
<script type="text/javascript">
$(document).ready(function () {
 ...
})
</script>

以上介绍了 Swiper 这款优秀 JS 图片轮播插件的使用方法,希望能对大家有所帮助。如有疑问欢迎留言,小编会及时回复。感谢对本站的支持!

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章