API
The API documentation.
SwipeableViews
Name | Type | Default | Platform | Description |
---|---|---|---|---|
action | function(hooks) | browser | This is callback property. It's called by the component on mount. This is useful when you want to trigger an action programmatically. It currently only supports updateHeight() action. | |
animateHeight | bool | false |
browser | If true , the height of the container will be animated to match the current slide height. Animating another style property has a negative impact regarding performance. |
animateTransitions | bool | true |
all | If false , changes to the index prop will not cause an animated transition. |
axis | enum ['x' , 'x-reverse' , 'y' , 'y-reverse' ] |
'x' |
browser | The axis on which the slides will slide. |
children | node | all | Use this property to provide your slides. | |
containerStyle | object | {} |
all | This is the inlined style that will be applied to each slide container. |
disabled | bool | false |
all | If true , it will disable touch events. This is useful when you want to prohibit the user from changing slides. |
disableLazyLoading | bool | false | browser | This is the config used to disable lazy loading, if true it will render all the views in first rendering. |
enableMouseEvents | bool | false |
browser | If true , it will enable mouse events. This will allow the user to perform the relevant swipe actions with a mouse. |
hysteresis | float | 0.6 |
all | Configure hysteresis between slides. This value determines how far should user swipe to switch slide. |
ignoreNativeScroll | bool | false | browser | If true , it will ignore native scroll container. It can be used to filter out false positive that blocks the swipe. |
index | integer | 0 |
all | This is the index of the slide to show. This is useful when you want to change the default slide shown. Or when you have tabs linked to each slide. |
onChangeIndex | function(index, indexLatest, meta) | all | This is callback prop. It's call by the component when the shown slide change after a swipe made by the user. This is useful when you have tabs linked to each slide. | |
onSwitching | function(index, type) | all | This is callback prop. It's called by the component when the slide switching. This is useful when you want to implement something corresponding to the current slide position. | |
onTransitionEnd | function | all | The callback that fires when the animation comes to a rest. This is useful to defer CPU intensive task. | |
resistance | bool | false |
all | If true, it will add bounds effect on the edges. |
style | object | {} |
all | This is the inlined style that will be applied on the root component. |
slideClassName | string | browser | This is the className that will be applied on the slide component. | |
slideStyle | object | {} |
all | This is the inlined style that will be applied on the slide component. |
springConfig | object | {duration: '0.3s', easeFunction: '...', delay: '0s'} |
browser | This is the config used to create CSS transitions. This is useful to change the dynamic of the transition. |
springConfig | object | {tension: 300, friction: 30} |
native.animated | This is the config given to Animated for the spring . This is useful to change the dynamic of the transition. |
threshold | integer | 5 |
all | This is the threshold used for detecting a quick swipe. If the computed speed is above this value, the index change. |
Any other properties like className
will be applied to the root component.
virtualize
This HOC extends the properties of SwipeableViews
and adds the following ones:
Name | Type | Default | Platform | Description |
---|---|---|---|---|
overscanSlideAfter | integer | 2 |
all | Number of slide to render after the visible slide. |
overscanSlideBefore | integer | 3 |
all | Number of slide to render before the visible slide. Separate from overscanSlideAfter as it's more difficult to keep the window up to date. |
slideCount | integer | all | When set, it's adding a limit to the number of slide: [0, slideCount]. | |
slideRenderer | func | all | Responsible for rendering a slide given an index. ({ index: integer }): node |
autoPlay
This HOC extends the properties of SwipeableViews
and adds the following ones:
Name | Type | Default | Platform | Description |
---|---|---|---|---|
autoplay | bool | true |
all | If false , the auto play behavior is disabled. |
direction | enum: 'incremental' 'decremental' |
'incremental' |
all | This is the auto play direction. |
interval | integer | 3000 |
all | Delay between auto play transitions (in ms). |
bindKeyboard
This HOC exposes the same properties as SwipeableViews
.