Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/we-plugin/wepy-com-swiper
:sparkles: 微信小程序触摸内容滑动解决方案，适用于wepy框架
https://github.com/we-plugin/wepy-com-swiper
Last synced: about 2 months ago
JSON representation
:sparkles: 微信小程序触摸内容滑动解决方案，适用于wepy框架
- Host: GitHub
- URL: https://github.com/we-plugin/wepy-com-swiper
- Owner: we-plugin
- License: mit
- Created: 2017-04-03T17:08:49.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-10-10T06:19:54.000Z (over 6 years ago)
- Last Synced: 2024-05-19T00:30:17.808Z (8 months ago)
- Language: JavaScript
- Homepage:
- Size: 202 KB
- Stars: 77
- Watchers: 3
- Forks: 16
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-wepy - wepy-com-swiper：微信小程序触摸内容滑动解决方案，适用于wepy框架
README
# wepy-com-swiper
微信小程序触摸内容滑动解决方案，适用于wepy框架
### 为什么要开发这款插件
#### 官方swiper组件：
* 支持的事件回调很单一
* 从文档上看只是能支持横向滑动
* 拓展性不强
#### wepy-com-swiper插件:
* 丰富的事件回调
* 丰富的属性
* 支持横、纵向滑动
* 强拓展（可在原插件基础上二次开发）
## ScreenShots
#### 横向滚动
#### 纵向滚动
## 安装组件
```bash
npm install wepy-com-swiper --save
```
## 示例
#### index.wpy
```
.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
}
slide 1
slide 2
slide 3
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)
}
}
```
## weSwiper初始化
weSwiper通过获取props动态参数进行初始化
在父组件中：
```javascript
data = {
swiper: {
slideLength: 3,
direction: 'vertical',
...
}
}
```
## 参数
### 必填项
#### slideLength
- Type: `Number`
- Default: `0`
表示slide的页数
### 可选项
#### width
- Type: `Number`
- Default: `device.windowWidth`
设定slide的宽度（横向滑动时slide滑动间隔距离会根据其值计算）
#### height
- Type: `Number`
- Default: `device.windowHeight`
设定slide的高度（纵向滑动时slide滑动间隔距离会根据其值计算）
#### direction
- Type: `String`
- Default: `horizontal`
- Option:
- `horizontal`: slide水平方向滑动
- `vertical`: slide垂直方向滑动
设定slide滑动方向
#### initialSlide
- Type: `Number`
- Default: `0`
设定初始化时slide的索引
#### speed
- Type: `Number`
- Default: `300`
设定slide过渡时长
#### timingFunction
- 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过渡动画速度曲线
#### autoplay
- Type: `Number`
- Default: `0`
设定slide自动播放间隔时长，设置为0时不自动播放
#### directionViewName
- Type: `String`
- Default: `directionClass`
对应视图中direction类名
#### animationViewName
- Type: `String`
- Default: `animationData`
对应视图中animation属性名
## 属性
#### weswiper.activeIndex
返回当前活动块(激活块)的索引
#### weswiper.previousIndex
返回上一个活动块的索引
#### weswiper.width
返回swiper容器的宽度
#### weswiper.height
返回swiper容器的高度
#### weswiper.isBeginning
如果swiper处于最初始位置，返回true
#### weswiper.isEnd
如果swiper处于最末尾位置，返回true
#### weswiper.speed
返回当前swiper的过渡时长
## 方法
#### slideNext(runCallbacks, speed)
滑动到后一个slide
- Params:
- `runCallbacks`: 可选，设为false不触发onSlideChange回调函数
- `speed`: 可选，切换速度
#### slidePrev(runCallbacks, speed)
滑动到前一个slide。
- Params:
- `runCallbacks`: 可选，设为false不触发onSlideChange回调函数
- `speed`: 可选，切换速度
#### slideTo(index, speed, runCallbacks)
切换到指定slide。
- Params:
- `index`: 必选，num，指定将要切换到的slide的索引
- `speed`: 可选，切换速度
- `runCallbacks`: 可选，设为false不触发onSlideChange回调函数
## 事件回调
#### onInit (weswiper)
回调函数，初始化后执行。
可选weswiper实例作为参数。
#### onTouchStart (weswiper, event)
回调函数，当碰触到slider时执行。可选weswiper和touchstart事件作为参数
#### onTouchMove (weswiper, event)
回调函数，手指触碰weswiper并滑动（手指）时执行。此时slide不一定会发生移动，比如你手指的移动方向和weswiper的切换方向垂直时
#### onTouchEnd (weswiper, event)
回调函数，当释放slider时执行。（释放即执行）
#### onSlideChangeStart (weswiper)
回调函数，weswiper从当前slide开始过渡到另一个slide时执行。触摸情况下，如果释放slide时没有达到过渡条件而回弹时不会触发这个函数，此时可用onTransitionStart。
可接受weswiper实例作为参数，输出的activeIndex是过渡后的slide索引
#### onSlideChangeEnd (weswiper)
回调函数，weswiper从一个slide过渡到另一个slide结束时执行。
可接受swiper实例作为参数。
#### onTransitionStart (weswiper)
回调函数，过渡开始时触发，接受weswiper实例作为参数。
#### onTransitionEnd (weswiper)
回调函数，过渡结束时触发，接收weswiper实例作为参数。
#### onSlideMove (weswiper)
回调函数，手指触碰weswiper并拖动slide时执行。
#### onSlideNextStart (weswiper)
回调函数，滑块释放时如果触发slider向前(右、下)切换则执行。类似于onSlideChangeStart，但规定了方向。
#### onSlideNextEnd (weswiper)
回调函数，slider向前(右、下)切换结束时执行。类似于onSlideChangeEnd，但规定了方向。
#### onSlidePrevStart (weswiper)
回调函数，滑块释放时如果触发slider向后(左、上)切换则执行。类似于onSlideChangeStart，但规定了方向。
#### onSlidePrevEnd (swiper)
回调函数，slider向后(左、上)切换结束时执行。类似于onSlideChangeEnd，但规定了方向。