Swiper

2016-11-20

Swiper 官方文档

一. 概述

Swiper是纯javascript打造的滑动特效插件，面向手机、平板电脑等移动终端。
Swiper能实现触屏焦点图、触屏Tab切换、触屏多图切换等常用效果。
Swiper开源、免费、稳定、使用简单、功能强大，是架构移动终端网站的重要选择！

二. 下载 Swiper

  1. 打开cdn链接

  2. 搜索 swiper

  3. 复制 <link> <script> 标签

    <link href="https://cdn.bootcdn.net/ajax/libs/Swiper/5.3.8/css/swiper.min.css" rel="stylesheet">

    <script src="https://cdn.bootcdn.net/ajax/libs/Swiper/5.3.8/js/swiper.min.js"></script>

三. Swiper 优点

  1. 开源、免费、强大的触摸滑动插件
  2. 简单配置即可实现手机、电脑网页大部分滑动功能，焦点图、tab、触摸导航等
  3. 轻量，极大的减轻了整个app的负载。

四. Swiper 使用方法：

  1. 首先加载插件，需要用到的文件有swiper.min.js和swiper.min.css文件。可下载Swiper文件或使用CDN。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    <!DOCTYPE html>
    <html>
    <head>
        ...
        <link rel="stylesheet" href="dist/css/swiper.min.css">
    </head>
    <body>
        ...
        <script src="dist/js/swiper.min.js"></script>
        ...
    </body>
    </html>

  2. HTML内容。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    <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>

  3. 你可能想要给Swiper定义一个大小，当然不要也行。

    1
    2
    3
    4
    .swiper-container {
        width: 600px;
        height: 300px;
    }

  4. 初始化Swiper：最好是挨着</body>标签

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    ...
    <script>        
      var mySwiper = new Swiper ('.swiper-container', {
        direction: 'vertical', // 垂直切换选项
        loop: true, // 循环模式选项
        
        // 如果需要分页器
        pagination: {
          el: '.swiper-pagination',
        },
        
        // 如果需要前进后退按钮
        navigation: {
          nextEl: '.swiper-button-next',
          prevEl: '.swiper-button-prev',
        },
        
        // 如果需要滚动条
        scrollbar: {
          el: '.swiper-scrollbar',
        },
      })        
      </script>
    </body>

    如果不能写在HTML内容的后面，则需要在页面加载完成后再初始化。

    1
    2
    3
    4
    5
    <script>
    window.onload = function() {
      ...
    }
    </script>

    或者这样（Jquery和Zepto）(推荐)

    1
    2
    3
    4
    5
    <script>
    $(document).ready(function () {
    ...
    })
    </script>
CATALOG