swiper中文文档-swiper小程序开发示例

swiper中文文档

基础库 1.0.0 开始支持，低版本需做兼容处理。

滑块视图容器。其中只可放置swiper-item组件，否则会导致未定义的行为。

属性类型默认值必填说明最低版本

indicator-dotsbooleanfalse否是否显示面板指示点1.0.0

indicator-colorcolorrgba(0, 0, 0, .3)否指示点颜色1.1.0

indicator-active-colorcolor#000000否当前选中的指示点颜色1.1.0

autoplaybooleanfalse否是否自动切换1.0.0

currentnumber0否当前所在滑块的 index1.0.0

intervalnumber5000否自动切换时间间隔1.0.0

durationnumber500否滑动动画时长1.0.0

circularbooleanfalse否是否采用衔接滑动1.0.0

verticalbooleanfalse否滑动方向是否为纵向1.0.0

previous-marginstring"0px"否前边距，可用于露出前一项的一小部分，接受 px 和 rpx 值1.9.0

next-marginstring"0px"否后边距，可用于露出后一项的一小部分，接受 px 和 rpx 值1.9.0

snap-to-edgeboolean"false"否当 swiper-item 的个数大于等于 2，关闭 circular 并且开启 previous-margin 或 next-margin 的时候，可以指定这个边距是否应用到第一个、最后一个元素2.12.1

display-multiple-itemsnumber1否同时显示的滑块数量1.9.0

easing-functionstring"default"否指定 swiper 切换缓动动画类型2.6.5

bindchangeeventhandle否current 改变时会触发 change 事件，event.detail = {current, source}1.0.0

bindtransitioneventhandle否swiper-item 的位置发生改变时会触发 transition 事件，event.detail = {dx: dx, dy: dy}2.4.3

bindanimationfinisheventhandle否动画结束时会触发 animationfinish 事件，event.detail 同上1.9.0

easing-function 的合法值

值说明最低版本

default默认缓动函数

linear线性动画

easeInCubic缓入动画

easeOutCubic缓出动画

easeInOutCubic缓入缓出动画

change事件 source 返回值

从 1.4.0 开始，change事件增加 source字段，表示导致变更的原因，可能值如下：

autoplay 自动播放导致swiper变化;

touch 用户划动引起swiper变化;

其它原因将用空字符串表示。

Bug & Tip

tip: 如果在 bindchange 的事件回调函数中使用 setData 改变 current 值，则有可能导致 setData 被不停地调用，因而通常情况下请在改变 current 值前检测 source 字段来判断是否是由于用户触摸引起。

Page({

onShareAppMessage() {

return {

title: 'swiper',

path: 'page/component/pages/swiper/swiper'

}

},

data: {

background: ['demo-text-1', 'demo-text-2', 'demo-text-3'],

indicatorDots: true,

vertical: false,

autoplay: false,

interval: 2000,

duration: 500

},

changeIndicatorDots() {

this.setData({

indicatorDots: !this.data.indicatorDots

})

},

changeAutoplay() {

this.setData({

autoplay: !this.data.autoplay

})

},

intervalChange(e) {

this.setData({

interval: e.detail.value

})

},

durationChange(e) {

this.setData({

duration: e.detail.value

})

}

})