Parameter（参数）　　　　　　　　　　　　　　　

Type(类型)　　

Default Value（默认值

Example（例子）

Description（说明）

speed

number

300

600

slides滑块动画之间的持续时间（单位ms）

eventTarget

string

'wrapper'

'container'

swipers事件对象，默认状态下所有的触控事件只能用于wrapper。如若需要其他元素包含在container内以及使用swipers,那么可以使用'container'. 2.4.2版本新增

autoplay

number

5000

-

过渡延迟时间（单位ms），参数没有指定的情况下，不生效，（补充：当用户操作后autoplay失效）

autoplayDisableOnInteraction

boolean

true

false

当设置为false时，用户操作之后（swipes,arrow以及pagination 点击）autoplay不会被禁掉，用户操作之后每次都会重新启动autoplay。

autoplayStopOnLast

boolean

false

true

设置为false后autoplay在最后一个块下失效（在没有设置loop的情况下）

mode

string

'horizontal'

'vertical'

slides滑动方式，水平或垂直

loop

boolean

false

true

true 为loop模式生效

loopAdditionalSlides

number　　

0

2

loop模式下slides数量增加个数

loopedSlides

number

1

2

在loop模式下使用slidesPerview:'auto',还需使用该参数设置所要用到的loop个数

slidesPerView

number

or 'auto'

1

4

旋转模式下，设置slider's容器能够同时显示的slides数量。另外，支持'auto'值，会根据容器container的宽度调整slides数目。‘auto’不兼容loop模式

slidesPerViewFit

boolean

true

false

仅当已设置了slidesPerView:'auto'，以及当slides的宽度大于容器，该参数生效。默认为true然后宽度大的slide 过渡时会划分为边缘的两部分。为false时，slide transition 会划分为比容器container大的多个slides

slidesPerGroup

number

1

2

定义slides的数量多少为一组，在旋转模式下有效。（carousel mode）

calculateHeight

boolean

false

true

当值为true时，Swiper根据slides内容计算容器高度。响应式布局中或不知道slides高度时十分有用（就像响应式的图片）

roundLengths

boolean

false

true

值为true时，Swiper会四舍五入宽度和高度，在响应式的滑块中包含误差时十分有用。

cssWidthAndHeight

boolean

false

true

值为true以及Swiper中的container，wrapper和slides没有高度

updateFormElements

boolean

true

false

当所有的内嵌图像（img标签）加载完成后Swiper会重新初始化。

watchActiveIndex

boolean

false

true

如果启用触屏事件期间会重新动态计算活动块的索引。

visiblilityFullfit

boolean

false

true

如果启用，仅有“可视”的slides会最后适应容器的大小

autoResize

boolean

true

false

值为false时，窗口尺寸改变时，禁掉slides自适应

DOManimation

boolean

true

false

在不支持css transitions(IE7-9)的浏览器上是否使用自定义的DOM动画

resistance

boolean or "100%"

true

false

值为false时禁用resistant bounds（抵抗反弹）,设置为‘100%'时启用resistant（抵抗）模式

noSwiping

boolean

false

true

值为true时，当swiper新增类”noSwipingClass“的滑动块时，禁掉该元素的滑动。

preventLinks

boolean

true

false

启用时当碰触滑块（slides）时禁止<a>标签链接

preventLinksPropagation

boolean

false

true

如滑动过程中需要跟preventLinks一起禁用stopPropagation，设置值为true

initialSlide

number

2

0

初始块（页面）的索引

useCSS3Transforms

boolean

true

false

值为false时禁用css3 transforms（减少内存，提高性能，同时也降低了美观）,同时使用wrapper的left/top属性代替。

Parameter（参数）

Type(类型)

Default Value（默认值

Example（例子）

Description（说明

freeMode

boolean

false

true

若为真slide坐标不固定

freeModeFluid

boolean　　

false

true

若为真，释放滑块之后仍会滑动一小会

scrollContainer

boolean

false

true

设置为真时，让Swiper看上去像滑动区（scrollable area）

momentumRatio

number

1

2

设置的值越大，当释放滑块时的动量距离越大

momentumBounce

boolean

true

false

false时禁用*模式下的（free mode）动量弹性

momentumBounceRatio

number

1

2

值越大产生的动量弹性（momentum bounce）效果越明显

Parameter（参数）

Type(类型)

Default Value（默认值

Example（例子）

Description（说明

centeredSlides

boolean

false

true

若为真，那么活动块会居中，而非默认状态下的居左

offsetPxBefore

number

0

100

指定slides与wrapper左边框的偏移量

offsetPxAfter

number

0

100

指定slides与wrapper右边框的偏移量

offsetSlidesBefore

number

0

2

滑块slides与wrapper左边框的偏移量等于等于指定滑块slides个数的宽度。这在响应式布局中而你又不知道slides宽度时，将十分有用。

offsetSlidesAfter

number

0

2

滑块slides与wrapper右边框的偏移量等于等于指定滑块slides个数的宽度。这在响应式布局中而你又不知道slides宽度时，将十分有用。

Parameter（参数）

Type(类型)

Default Value（默认值

Example（例子）

Description（说明

touchRatio

number

1

0.8

触屏比率

simulateTouch

boolean

true

false

true,Swiper接受鼠标事件时与触屏事件相似。（单击以及拖曳滑块）

onlyExternal

boolean

false

true

值为true时，只能使用扩展API函数内的swipeRight 或swiperLeft改变slides滑动，其他失效。正如例子里的tabs切换十分有用

followFinger

boolean

true

false

值为false时，仅当你释放slide时才会滑动，当你用手指按住滑块它不会动。

grabCursor

boolean

false

true

该选项给Swiper用户提供小小的贴心应用，值为true时，光标在Swiper上时成手掌状。

shortSwipes

boolean

true

false

值为false时，禁用short swipes

longSwipesRatid

number

0.5

0.3

Swiper 中到上/下滑块的触发率

moveStartThreshold

number

false

100

滑动的临界值，临界值单位为px，如果触屏距离小于该值滑块不会运动。

Parameter（参数）

Type(类型)

Default Value（默认值

Example（例子）

Description（说明

keyboardControl

boolean

false

true

值为true时，水平模式下，能使用键盘左右方向键滑动，垂直模式下能使用上下方向键滑动

mousewheelControl

boolean

false

true

值为true时，能够使用鼠标滑轮滑动swiper

mousewheelControlForceToAxis

boolean

false

true

值为真时，鼠标轮滑会改变轴向，所以水平模式下的鼠标滑轮只作用于水平鼠标滑块，垂直的作用于垂直模式。

Parameter（参数）

Type(类型)

Default Value（默认值

Example（例子）

Description（说明

pagination

string or HTML Element

-

'.my-pagination'

css选择器中的分页。或者HTML元素内的分页元素

paginaClickable

boolean

false

true

值为真时，当单击指示器时会执行过渡动画到目标slide

paginationAsRange

boolean

true

为真时，跟可见块相关的指示器按钮会新增css类。当使用slidesPerview超过1时会十分有用。

createPagination

boolean

true

false

值为真时，Swiper会在slider内生成与slides数量相同的SPAN标签。所有这些生成的span标签都在pagination容器内。每一个span标签都有一个”swiper-pagination-switch“类名，活动的span（及当前slide下的）有一个为”swiper-active-switch’的类名，对于这些使用样式十分有用。

Parameter（参数）

Type(类型)

Default Value（默认值

Example（例子）

Description（说明

wrapperClass

string

'swiper-wrapper'

'my-wrapper'

Swiper内wrapper的css类。具体查看上面的例子

slideClass

string

'swiper-slide'

'my-slide'

Swiper内slide的css类名。具体查看上面的例子

slideActiveClass

string

'swiper-slide-active'

'my-active-slide'

Swiper内活动块的css类名。。。

slideActiveClass

string

'swiper-slide-visible'

'my-visible-slide'

Swiper内可视块的css类名。。。

slideElement

string

'div'

'li'

使用单一滑块的标签

noSwipingClass

string

'swiper-no-swiping'

'stop-swiping'

html元素使用的类名，当noSwiping参数设置为true时，用于禁止滑动

paginationElement

string

'span'

'div'

使用唯一指示按钮的标签

paginatinElementClass

string

'swiper-pagination-switch'

'my-switch'

使用多个指示按钮的类名

paginationActiveClass

string

'swiper-active-switch'

'my-active-switch'

当前活动指示按钮的类名

paginationVisibleClass

string

'swiper-visible-switch'

'my-visible-switch'

可见指示按钮的类名

Parameter（参数）

Type(类型)

Default Value（默认值

Example（例子）

Description（说明

queueStatCallbacks

boolean

false

true

设置为true时，‘slideChangeStart’回调函数入队，所以在快速滑动过程中回调函数只被调用一次。

queueEndCallbacks

boolean

false

true

设置为true时，‘slideChangeEnd’回调函数入队，所以在快速滑动结束后回调函数只被调用一次。

onFirstInit

funciton

-

function(swiper)
{
//执行代码
}

回调函数，首次初始化后马上执行

onInit

function

-

function(swiper){
//执行代码

}

回调函数，在其他所有的初始化/再初始化后马上执行

onSwiperCreated

function

-

function(swiper){
//执行代码

}

回调函数，当Swiper初始化完成，loop，pagination，等其他参数或方法生成之后执行

onTouchStart

function

-

function(swiper){
//执行代码

}

回调函数，当碰触到slider时马上执行

onTouchMove

function

-

function(swiper){
//执行代码

}

回调函数，当碰触slider到释放期间执行。

onTouchEnd

function

-

function(swiper){
//执行代码

}

回调函数，当释放slider时执行

onSlideReset

function

-

function(swiper){
//执行代码

}

回调函数，释放滑块之后，滑块将要滑到当前活动的slide时执行。freeMode模式下不生效。

onSlideChangeStart

funciton

-

function(swiper){
//执行代码

}

回调函数，当动画开始过渡到另一slide时执行，即动画开始时执行。freeMode模式下不生效。

onSlideChangeEnd

function

-

function(swiper){
//执行代码

}

回调函数，过渡动画结束后执行，即滑块活动停止后执行。freeMode模式下不生效。

onSlideNext

function

-

function(swiper){
//执行代码

}

回调函数，与onSlideChangeStart相似，但该函数只能在滑向下一slide开始时生效

onSlidePrev

funciton

-

function(swiper){
//执行代码

}

回调函数，与onSlideChangeStart相似，但该函数只能在滑向上一slide开始时生效

onSlideTouch

function

-

function(swiper){
//执行代码

}

回调函数，当触碰事件发生后生效。与onToucStart相似，不过该函数会返回.clickedSlide和.clickedSlideIndex的值

onImageReady

function

-

function(swiper){
//执行代码

}

回调函数，所有内置图像加载完成后执行，同时“updateOmImagesReady”需设置为“true’

onMomentumBounce

function

-

function(swiper){
//执行代码

}

回调函数，执行于动量反弹（momentum bounce）过程中

onResistanceBefore

funciton

-

function(swiper,p){
//执行代码

}

回调函数，执行于negative resistance过程中。p-返回抵抗距离。

onResistanceAfter

funciton

-

function(swiper,p){
//执行代码

}

回调函数，执行于positive resistance过程中。p-返回抵抗距离。

onSetWrapperTransition

function

-

function(swiper,duration){

//执行代码

}

回调函数，每次当Swiper开始动画时执行

onSetWrapperTransform

funciton

-

function(swiper,transform){

//执行代码

}

回调函数，swiper的容器wrapper改变其坐标时执行。返回带当前transform 的偏移量的对象。