轻量级滑块Swiper插件发布（仅3kb）

最新推荐文章于 2024-08-09 08:10:38 发布

weixin_34055910

最新推荐文章于 2024-08-09 08:10:38 发布

阅读量318

点赞数

文章标签： git 人工智能

原文链接：https://juejin.im/post/5c6e8c5c6fb9a049c644716b

版权

Light-Swiper

专注于移动端、轻量级Swiper原生插件（3kb gziped）。触摸事件基于element，不影响页面的触摸事件（如右滑返回上一页）

重构于Swipe，实现自定义swipe宽度、偏移量、无限轮播、事件复制等功能，体验更加流畅

Git仓库

如果觉得有用的话，欢迎star~

预览

安装

npm install light-swiper
// or
yarn add light-swiper
复制代码

或者通过script标签的形式引入

<script src="./swiper.min.js"></script>
复制代码

现在，你可以使用全局变量lightSwiper

用法

light-swiper只需要遵循简单的布局模式，如：

<div class="light-swiper">
  <div class="swiper-wrap">
    <div class="swipe-item"></div>
    <div class="swipe-item"></div>
    <div class="swipe-item"></div>
    <div class="swipe-item"></div>
  </div>
</div>
复制代码

以上是最初需要的结构：一系列元素包裹在两个容器中。在每个swipe-item可以自定义你想要的内容。初始化Swiper只需简单一行代码，传入swiper的最外层DOM即可，如下所示：

import Swiper from 'light-swiper'

const mySwiper = new Swiper(document.querySelector('.light-swiper'));
复制代码

除此之外，还需要一些简单的CSS样式：

.light-swiper {
  overflow: hidden;
  position: relative;
}

.swiper-wrap {
  overflow: hidden;
  position: relative;
}

.swipe-item {
  float: left;
  width: 100%;
  position: relative;
}
复制代码

自定义配置选项

滑动可以选择第二个参数: [options]

参数	说明	类型	默认值
startSlide	默认的索引位置	int	0
speed	动画执行时间	int	300
auto	是否自动播放, 传入切换时间	int	-
continuous	是否循环播放	boolean	false
width	单个swipe的宽度，一般在需要预览多个swipe时使用	int	-
offset	距离左边的偏移量，一般在需要预览多个swipe时使用	int	-
disableScroll	禁用Swiper的所有触摸事件	boolean	false
stopPropagation	阻止事件冒泡	boolean	false
callback	事件回调	Function	(index, currentEl)
transitionEnd	动画完成事件	Function	(index, currentEl)
swiping	使用已刷过的全宽度的百分比（0-1）进行滑动时调用	Function	(percent)

例子

const mySwiper = new Swiper(document.querySelector('.light-swiper'), {
  width: 310,
  offset: 30,
  startSlide: 2,
  speed: 400,
  auto: 3000,
  continuous: true,
  disableScroll: false,
  stopPropagation: false,
  callback: function(index, elem) {},
  transitionEnd: function(index, elem) {}
});
复制代码