微信小程序触摸内容滑动解决方案,适用于wepy框架
- 支持的事件回调很单一
- 从文档上看只是能支持横向滑动
- 拓展性不强
- 丰富的事件回调
- 丰富的属性
- 支持横、纵向滑动
- 强拓展(可在原插件基础上二次开发)
npm install wepy-com-swiper --save
<style lang="less">
.we-slide{
display: flex;
align-items: center;
justify-content: center;
color: #fff;
font-size: 2rem;
}
.we-slide:nth-child(1){
background-color: #4390EE
}
.we-slide:nth-child(2){
background-color: #CA4040
}
.we-slide:nth-child(3){
background-color: #FF8604
}
</style>
<template>
<view class="container">
<weSwiper :option="swiper">
<view class="we-slide">slide 1</view>
<view class="we-slide">slide 2</view>
<view class="we-slide">slide 3</view>
</weSwiper>
</view>
</template>
<script>
import wepy from 'wepy'
import weSwiper from 'wepy-com-swiper'
export default class Index extends wepy.page {
config = {
navigationBarTitleText: 'test'
}
components = {
weSwiper: weSwiper
}
data = {
swiper: {
direction: 'vertical',
slideLength: 3,
/**
* swiper初始化后执行
* @param swiper
*/
onInit (weswiper) {
},
/**
* 手指碰触slide时执行
* @param swiper
* @param event
*/
onTouchStart (weswiper, event) {
},
/**
* 手指碰触slide并且滑动时执行
* @param swiper
* @param event
*/
onTouchMove (weswiper, event) {
},
/**
* 手指离开slide时执行
* @param swiper
* @param event
*/
onTouchEnd (weswiper, event) {
},
/**
* slide达到过渡条件时执行
*/
onSlideChangeStart (weswiper) {
},
/**
* swiper从一个slide过渡到另一个slide结束时执行
*/
onSlideChangeEnd (weswiper) {
},
/**
* 过渡时触发
*/
onTransitionStart (weswiper) {
},
/**
* 过渡结束时执行
*/
onTransitionEnd (weswiper) {
},
/**
* 手指触碰swiper并且拖动slide时执行
*/
onSlideMove (weswiper) {
},
/**
* slide达到过渡条件 且规定了方向 向前(右、下)切换时执行
*/
onSlideNextStart (weswiper) {
},
/**
* slide达到过渡条件 且规定了方向 向前(右、下)切换结束时执行
*/
onSlideNextEnd (weswiper) {
},
/**
* slide达到过渡条件 且规定了方向 向前(左、上)切换时执行
*/
onSlidePrevStart (swiper) {
},
/**
* slide达到过渡条件 且规定了方向 向前(左、上)切换结束时执行
*/
onSlidePrevEnd (weswiper) {
}
}
}
onLoad() {
setTimeout(() =>this.$invoke('weSwiper', 'slideTo', 2), 3000)
}
}
</script>
weSwiper通过获取props动态参数进行初始化
在父组件中:
data = {
swiper: {
slideLength: 3,
direction: 'vertical',
...
}
}
- Type:
Number
- Default:
0
表示slide的页数
- Type:
Number
- Default:
device.windowWidth
设定slide的宽度(横向滑动时slide滑动间隔距离会根据其值计算)
- Type:
Number
- Default:
device.windowHeight
设定slide的高度(纵向滑动时slide滑动间隔距离会根据其值计算)
- Type:
String
- Default:
horizontal
- Option:
horizontal
: slide水平方向滑动vertical
: slide垂直方向滑动
设定slide滑动方向
- Type:
Number
- Default:
0
设定初始化时slide的索引
- Type:
Number
- Default:
300
设定slide过渡时长
- Type:
String
- Default:
ease
- Option:
linear
: slide水平方向滑动ease
: slide垂直方向滑动ease-in
: slide垂直方向滑动ease-in-out
: slide垂直方向滑动ease-out
: slide垂直方向滑动step-start
: slide垂直方向滑动step-end
: slide垂直方向滑动
设定slide过渡动画速度曲线
- Type:
Number
- Default:
0
设定slide自动播放间隔时长,设置为0时不自动播放
- Type:
String
- Default:
directionClass
对应视图中direction类名
- Type:
String
- Default:
animationData
对应视图中animation属性名
返回当前活动块(激活块)的索引
返回上一个活动块的索引
返回swiper容器的宽度
返回swiper容器的高度
如果swiper处于最初始位置,返回true
如果swiper处于最末尾位置,返回true
返回当前swiper的过渡时长
滑动到后一个slide
- Params:
runCallbacks
: 可选,设为false不触发onSlideChange回调函数speed
: 可选,切换速度
滑动到前一个slide。
- Params:
runCallbacks
: 可选,设为false不触发onSlideChange回调函数speed
: 可选,切换速度
切换到指定slide。
- Params:
index
: 必选,num,指定将要切换到的slide的索引speed
: 可选,切换速度runCallbacks
: 可选,设为false不触发onSlideChange回调函数
回调函数,初始化后执行。 可选weswiper实例作为参数。
回调函数,当碰触到slider时执行。可选weswiper和touchstart事件作为参数
回调函数,手指触碰weswiper并滑动(手指)时执行。此时slide不一定会发生移动,比如你手指的移动方向和weswiper的切换方向垂直时
回调函数,当释放slider时执行。(释放即执行)
回调函数,weswiper从当前slide开始过渡到另一个slide时执行。触摸情况下,如果释放slide时没有达到过渡条件而回弹时不会触发这个函数,此时可用onTransitionStart。
可接受weswiper实例作为参数,输出的activeIndex是过渡后的slide索引
回调函数,weswiper从一个slide过渡到另一个slide结束时执行。
可接受swiper实例作为参数。
回调函数,过渡开始时触发,接受weswiper实例作为参数。
回调函数,过渡结束时触发,接收weswiper实例作为参数。
回调函数,手指触碰weswiper并拖动slide时执行。
回调函数,滑块释放时如果触发slider向前(右、下)切换则执行。类似于onSlideChangeStart,但规定了方向。
回调函数,slider向前(右、下)切换结束时执行。类似于onSlideChangeEnd,但规定了方向。
回调函数,滑块释放时如果触发slider向后(左、上)切换则执行。类似于onSlideChangeStart,但规定了方向。
回调函数,slider向后(左、上)切换结束时执行。类似于onSlideChangeEnd,但规定了方向。