Swiper

167 阅读1分钟

Swiper组件列表

模块功能版本
Navigation按钮 
Pagination分页器 
Scrollbar滚动条 
Autoplay自动切换 
FreeMode自由模式7.0.0
Grid网格分布7.0.0
Manipulation动态操纵7.0.0
Parallax视差效果 
Lazy延迟加载图片 
EffectFade渐变过渡 
EffectCoverflow行进翻转过渡 
EffectFlip翻转过渡 
EffectCube方块过渡 
EffectCards卡片过渡7.0.0
EffectCreative创意性过渡7.0.0
Thumbs缩略图4.4.1
Zoom缩放 
Keyboard键盘 
Mousewheel鼠标 
Virtual虚拟块 
HashNavigation锚导航 
History历史导航 
Controller双向控制 
A11y障碍使用辅助

navigation按钮

使用前进后退按钮。

navigation参数

  • 类型:

    object

  • 启用版本:

    4.0.0

使用方法示例

var mySwiper = new Swiper('.swiper-container', {
  navigation: {
    nextEl: '.swiper-button-next',
    prevEl: '.swiper-button-prev',
  },
});

pagination分页器

使用分页导航。

pagination参数

  • 类型:

    object

  • 启用版本:

    4.0.0

使用方法示例

<div class="swiper-pagination"></div>
<script language="javascript"> 
var mySwiper = new Swiper('.swiper-container',{
pagination: {
    el: '.swiper-pagination',
  },
})
</script>

Autoplay自动切换

设置为true启动自动切换,并使用默认的切换设置。

要注意Swiper4.x与Swiper3.x的写法不同导致的超快速切换。
当页面文档不在当前视窗显示时(浏览器tab),Swiper会停止自动切换,显示时会恢复自动切换(Swiper5新增)。

autoplay信息

  • 类型:

    object/boolean

  • 默认:

    false

  • 举例:

    true/object

  • 启用版本:

    4.0.0

使用方法示例

从Swiper7开始,容器默认类名由'.swiper-container'变更为'.swiper'。

<script>
var mySwiper = new Swiper('.swiper', {
  autoplay:true,//等同于以下设置
  /*autoplay: {
    delay: 3000,
    stopOnLastSlide: false,
    disableOnInteraction: true,
    },*/
});
</script>

scrollbar滚动条

为Swiper增加滚动条。

scrollbar参数

  • 类型:

    object

  • 启用版本:

    4.0.0

使用方法示例

<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-scrollbar"></div>
</div>
<script type="text/javascript">
var mySwiper = new Swiper('.swiper-container',{
  scrollbar: {
    el: '.swiper-scrollbar',
  },
}); 
</script>