Не работает loop swiper

Содержание
  1. In loop mode, duplicate slides are not being updated when the contents of the original slides change #2629
  2. Comments
  3. brandonce commented May 17, 2018
  4. What you did
  5. Expected Behavior
  6. Actual Behavior
  7. jhowsick commented Jun 12, 2018
  8. brandonce commented Jun 13, 2018
  9. clevergod commented Aug 7, 2018
  10. cgh20xx commented Aug 20, 2018
  11. nolimits4web commented Aug 20, 2018 •
  12. golee commented Aug 21, 2018
  13. golee commented Aug 21, 2018 •
  14. prod3v3loper commented Feb 18, 2019 •
  15. victorcamargos commented Mar 28, 2019
  16. peter-wang-wsl commented Apr 18, 2019
  17. thowfeeq178 commented Apr 25, 2019
  18. JoseCigarro commented Jul 19, 2019
  19. andykulakov commented Sep 3, 2019
  20. vc-rakesh commented Nov 27, 2019
  21. andig89 commented Dec 15, 2019
  22. bevndas commented Apr 8, 2020
  23. Swiper API
  24. Swiper Full HTML Layout
  25. Styles
  26. CSS Styles
  27. Less Styles
  28. SCSS Styles
  29. Initialize Swiper
  30. Parameters
  31. Methods & Properties
  32. Events
  33. Modules
  34. Navigation
  35. Navigation Parameters
  36. Navigation Methods
  37. Navigation Events
  38. Pagination
  39. Pagination Parameters
  40. Pagination Methods
  41. Pagination Events
  42. Scrollbar
  43. Scrollbar Parameters
  44. Scrollbar Methods
  45. Scrollbar Events
  46. Autoplay
  47. Autoplay Parameters
  48. Autoplay Methods
  49. Autoplay Events
  50. Free Mode
  51. Free Mode Parameters
  52. Grid Parameters
  53. Manipulation
  54. Manipulation Methods
  55. Parallax
  56. Parallax Parameters
  57. Lazy Loading
  58. Lazy Loading Parameters
  59. Lazy Loading Methods
  60. Lazy Loading Events
  61. Fade Effect
  62. Fade Effect Parameters
  63. Coverflow Effect
  64. Coverflow Effect Parameters
  65. Flip Effect
  66. Flip Effect Parameters
  67. Cube Effect
  68. Cube Effect Parameters
  69. Cards Effect
  70. Cards Effect Parameters
  71. Creative Effect
  72. Creative Effect Parameters
  73. Thumbs
  74. Thumbs Parameters
  75. Thumbs Methods
  76. Zoom Parameters
  77. Zoom Methods
  78. Zoom Events
  79. Keyboard Control
  80. Keyboard Control Parameters
  81. Keyboard Control Methods
  82. Keyboard Events
  83. Mousewheel Control
  84. Mousewheel Control Parameters
  85. Mousewheel Control Methods
  86. Mousewheel Events
  87. Virtual Slides
  88. Virtual Slides Parameters
  89. Virtual Slides Methods
  90. Hash Navigation
  91. Hash Navigation Parameters
  92. Hash Navigation Events
  93. History Navigation
  94. History Navigation Parameters
  95. Controller
  96. Controller Parameters
  97. Controller Methods
  98. Accessibility (a11y)
  99. Accessibility Parameters
  100. Custom Build
  101. Using JS Modules
  102. Using Build Script
  103. TypeScript Definitions

In loop mode, duplicate slides are not being updated when the contents of the original slides change #2629

Comments

brandonce commented May 17, 2018

This is a (multiple allowed):

Swiper Version: 4.2.6

Platform/Target and Browser Versions: All browsers, but tested on macOS, CHROME

Live Link or JSFiddle/Codepen or website with issue: https://jsfiddle.net/knankv59/2/

What you did

Swiper config is at the bottom of the Javascript window in the jsfiddle (loop mode, loopedSlides set to 3, slidesPerView set to 1)

Click the right navigation arrow twice to swipe forward to slide 2.
Click the button above the slideshow to change the content of slide 2, which now reads «New content!»
Click the right navigation arrow six more times, going to the end of the slides and looping back around to slide 2.

Expected Behavior

Slide 2’s text should still say «New content!»

Actual Behavior

Slide 2’s text is still just the original «2».

_
Is there any way to refresh specific duplicate slides automatically when their original slide’s content changes?

The text was updated successfully, but these errors were encountered:

jhowsick commented Jun 12, 2018

Same issue here. Swiper does not update duplicate slides when the original has changed. Any workarounds would be highly appreciated.

brandonce commented Jun 13, 2018

@jhowsick One way is manually redoing the loop by calling methods on the swiper instance itself.

This is hacky though. Hopefully an official fix will happen.

clevergod commented Aug 7, 2018

I had the same problem

cgh20xx commented Aug 20, 2018

nolimits4web commented Aug 20, 2018 •

It is not supported and won’t be, it should be done manually, for example like @brandonce described

golee commented Aug 21, 2018

How about something similar with renderExternal() . Sync React or Vue with loop mode is so painful.

golee commented Aug 21, 2018 •

I currently use the method that just update html of dupslides

prod3v3loper commented Feb 18, 2019 •

Our swiper, here to note the onTransitionStart function of passing our function to trade the duplicates.

Your slides with events we set:

We handle the duplicates on transition start with this function handleDuplicates()

victorcamargos commented Mar 28, 2019

I was struggling with this behavior as well and since I could not find any solution out of the box for my problem I ended up with a mix of hacks that worked perfectly to me. In my case some slides have a counter and also some buttons, both were not working on duplicated slides. So I used the solution proposed by @golee to copy the dom at the moment of slide transition start (slideChangeTransitionStart) and then on (slideChangeTransitionEnd) I slide it to the realIndex but with speed 0 so it’s not noticed by the user.

peter-wang-wsl commented Apr 18, 2019

@nolimits4web I follow @brandonce described, then found if I have 2 slides in swiper, I only can change the first slide value and can’t change the second one. swiper.loopDestroy() will rollback the value of second slide.

thowfeeq178 commented Apr 25, 2019

//this will update the duplicates only once if you slides update

this.mySwiper.once(‘transitionStart’,function updateDuplicates() <
this.loopDestroy()
this.loopCreate()
>)

JoseCigarro commented Jul 19, 2019

//this will update the duplicates only once if you slides update

this.mySwiper.once(‘transitionStart’,function updateDuplicates() <
this.loopDestroy()
this.loopCreate()
>)

Hello, I’m having the same problem and can’t fix it. Is possible for you to give me a real example, probably i’m pasting your code in a wrong place.

andykulakov commented Sep 3, 2019

@JoseCigarro you should run these methods whenever the original slides change.
this.swiper points at your Swiper instance. Here is an example of how you can access it through Swiper events or swiper’s HTMLElement — http://idangero.us/swiper/api/#initialize

vc-rakesh commented Nov 27, 2019

I was struggling with this behavior as well and since I could not find any solution out of the box for my problem I ended up with a mix of hacks that worked perfectly to me. In my case some slides have a counter and also some buttons, both were not working on duplicated slides. So I used the solution proposed by @golee to copy the dom at the moment of slide transition start (slideChangeTransitionStart) and then on (slideChangeTransitionEnd) I slide it to the realIndex but with speed 0 so it’s not noticed by the user.

This one is super and awesome fix. You saved my day. Thank you very much.

andig89 commented Dec 15, 2019

I use Swiper in Vue with a loop and need change slides data. Of course, the loop doesn’t change duplicates data so I need to use this.loopDestroy () and this.loopCreate () but . when to run them? I came to the point that I have to run them after creating DOM Swiper but how to detect this? Because I use Vue I can fire it on «update», but without it, I don’t have any good idea. Of course, I can use interval and check something in DOM but it sucks in my opinion.

bevndas commented Apr 8, 2020

hmm this fix worked for me
before adding a slider destroy the loop
swiper.loopDestroy();
Add the slider setTimeout for a sec and update the swiper and create the loop again
setTimeout( <
directiveRef.update or swiper.update()
swiper.loopCreate();>, 1000);

the loop doesnt work properly on slide update so manually updating it! hope it works for you as well!

Источник

Swiper API

Swiper Full HTML Layout

Styles

Swiper package contains different sets of CSS, Less and SCSS styles:

CSS Styles

CSS styles for bundle version:

  • swiper-bundle.css — all Swiper styles including all modules styles (like Navigation, Pagination, etc.)
  • swiper-bundle.min.css — same as previous but minified

CSS styles for bundle version (package imports):

  • swiper/css — all Swiper styles including all modules styles (like Navigation, Pagination, etc.)
  • swiper/css/bundle — same as previous but minified

CSS styles for core version and modules (package imports):

  • swiper/css — only core Swiper styles
  • swiper/css/a11y — styles required for A11y module
  • swiper/css/autoplay — styles required for Autoplay module
  • swiper/css/controller — styles required for Controller module
  • swiper/css/effect-cards — styles required for Cards Effect module
  • swiper/css/effect-coverflow — styles required for Coverflow Effect module
  • swiper/css/effect-creative — styles required for Creative Effect module
  • swiper/css/effect-cube — styles required for Cube Effect module
  • swiper/css/effect-fade — styles required for Fade Effect module
  • swiper/css/effect-flip — styles required for Flip Effect module
  • swiper/css/free-mode — styles required for Free Mode module
  • swiper/css/grid — styles required for Grid module
  • swiper/css/hash-navigation — styles required for Hash Navigation module
  • swiper/css/history — styles required for History module
  • swiper/css/keyboard — styles required for Keyboard module
  • swiper/css/lazy — styles required for Lazy module
  • swiper/css/manipulation — styles required for Manipulation module
  • swiper/css/mousewheel — styles required for Mousewheel module
  • swiper/css/navigation — styles required for Navigation module
  • swiper/css/pagination — styles required for Pagination module
  • swiper/css/parallax — styles required for Parallax module
  • swiper/css/scrollbar — styles required for Scrollbar module
  • swiper/css/thumbs — styles required for Thumbs module
  • swiper/css/virtual — styles required for Virtual module
  • swiper/css/zoom — styles required for Zoom module

Less Styles

Less styles are separate styles for core version and modules (package imports):

  • swiper/less — only core Swiper styles
  • swiper/less/bundle — all Swiper styles including all modules styles (like Navigation, Pagination, etc.)
  • swiper/less/a11y — styles required for A11y module
  • swiper/less/autoplay — styles required for Autoplay module
  • swiper/less/controller — styles required for Controller module
  • swiper/less/effect-cards — styles required for Cards Effect module
  • swiper/less/effect-coverflow — styles required for Coverflow Effect module
  • swiper/less/effect-creative — styles required for Creative Effect module
  • swiper/less/effect-cube — styles required for Cube Effect module
  • swiper/less/effect-fade — styles required for Fade Effect module
  • swiper/less/effect-flip — styles required for Flip Effect module
  • swiper/less/free-mode — styles required for Free Mode module
  • swiper/less/grid — styles required for Grid module
  • swiper/less/hash-navigation — styles required for Hash Navigation module
  • swiper/less/history — styles required for History module
  • swiper/less/keyboard — styles required for Keyboard module
  • swiper/less/lazy — styles required for Lazy module
  • swiper/less/manipulation — styles required for Manipulation module
  • swiper/less/mousewheel — styles required for Mousewheel module
  • swiper/less/navigation — styles required for Navigation module
  • swiper/less/pagination — styles required for Pagination module
  • swiper/less/parallax — styles required for Parallax module
  • swiper/less/scrollbar — styles required for Scrollbar module
  • swiper/less/thumbs — styles required for Thumbs module
  • swiper/less/virtual — styles required for Virtual module
  • swiper/less/zoom — styles required for Zoom module

SCSS Styles

SCSS styles are also separate styles for core version and modules (package imports):

  • swiper/scss — only core Swiper styles
  • swiper/scss/bundle — all Swiper styles including all modules styles (like Navigation, Pagination, etc.)
  • swiper/scss/a11y — styles required for A11y module
  • swiper/scss/autoplay — styles required for Autoplay module
  • swiper/scss/controller — styles required for Controller module
  • swiper/scss/effect-cards — styles required for Cards Effect module
  • swiper/scss/effect-coverflow — styles required for Coverflow Effect module
  • swiper/scss/effect-creative — styles required for Creative Effect module
  • swiper/scss/effect-cube — styles required for Cube Effect module
  • swiper/scss/effect-fade — styles required for Fade Effect module
  • swiper/scss/effect-flip — styles required for Flip Effect module
  • swiper/scss/free-mode — styles required for Free Mode module
  • swiper/scss/grid — styles required for Grid module
  • swiper/scss/hash-navigation — styles required for Hash Navigation module
  • swiper/scss/history — styles required for History module
  • swiper/scss/keyboard — styles required for Keyboard module
  • swiper/scss/lazy — styles required for Lazy module
  • swiper/scss/manipulation — styles required for Manipulation module
  • swiper/scss/mousewheel — styles required for Mousewheel module
  • swiper/scss/navigation — styles required for Navigation module
  • swiper/scss/pagination — styles required for Pagination module
  • swiper/scss/parallax — styles required for Parallax module
  • swiper/scss/scrollbar — styles required for Scrollbar module
  • swiper/scss/thumbs — styles required for Thumbs module
  • swiper/scss/virtual — styles required for Virtual module
  • swiper/scss/zoom — styles required for Zoom module

Initialize Swiper

Now, when we have Swiper’s HTML, we need to initialize it using the following function:

new Swiper(swiperContainer, parameters) — initialize swiper with options

  • swiperContainer — HTMLElement or string (with CSS Selector) of swiper container HTML element. Required.
  • parameters — object — object with Swiper parameters. Optional.
  • Method returns initialized Swiper instance

After you initialize Swiper it is possible to access to Swiper’s instance on its HTMLElement. It is swiper property of Swiper’s HTML container element:

Parameters

Let’s look on list of all available parameters:

Set to false to disable swiping to next slide direction (to right or bottom)

Set to false to disable swiping to previous slide direction (to left or top)

If false , then the only way to switch the slide is use of external API functions like slidePrev or slideNext

Set to true and slider wrapper will adapt its height to the height of the currently active slide

Allows to set different parameter for different responsive breakpoints (screen sizes). Not all parameters can be changed in breakpoints, only those which are not required different layout and logic, like slidesPerView , slidesPerGroup , spaceBetween , grid.rows . Such parameters like loop and effect won’t work

Base for breakpoints (beta). Can be window or container . If set to window (by default) then breakpoint keys mean window width. If set to container then breakpoint keys treated as swiper container width

Currently in beta and not supported by Swiper Angular, React, Svelte and Vue components

When enabled it center slides if the amount of slides less than slidesPerView . Not intended to be used loop mode and grid.rows

If true , then active slide will be centered, not always on the left side.

If true , then active slide will be centered without adding gaps at the beginning and end of slider. Required centeredSlides: true . Not intended to be used with loop or pagination

The beginning of the modifier CSS class that can be added to swiper container depending on different parameters

When enabled Swiper will automatically wrap slides with swiper-wrapper element, and will create required elements for navigation, pagination and scrollbar they are enabled (with their respective params object or with boolean true ))

When enabled it will use modern CSS Scroll Snap API. It doesn’t support all of Swiper’s features, but potentially should bring a much better performance in simple configurations.

This is what is not supported when it is enabled:

  • Cube and Cards effects
  • speed parameter may not have no effect
  • All transition start/end related events (use slideChange instead)
  • slidesPerGroup has limited support
  • simulateTouch doesn’t have effect and «dragging» with mouse doesn’t work
  • resistance doesn’t have any effect
  • allowSlidePrev/Next
  • swipeHandler
  • freeMode and all relevant features

Can be ‘horizontal’ or ‘vertical’ (for vertical slider).

Enable to release Swiper events for swipe-back work in app. If set to ‘prevent’ then it will prevent system swipe-back navigation instead

Area (in px) from left edge of the screen to release touch events for swipe-back in app

Transition effect. Can be ‘slide’ , ‘fade’ , ‘cube’ , ‘coverflow’ , ‘flip’ or ‘creative’

Whether Swiper initially enabled. When Swiper is disabled, it will hide all navigation elements and won’t respond to any events and interactions

CSS selector for focusable elements. Swiping will be disabled on such elements if they are «focused»

If disabled, then slider will be animated only when you release it, it will not move while you hold your finger on it

This option may a little improve desktop usability. If true , user will see the «grab» cursor when hover on Swiper

Swiper height (in px). Parameter allows to force Swiper height. Useful only if you initialize Swiper when it is hidden and in SSR and Test environments for correct Swiper initialization

Setting this parameter will make Swiper not responsive

Whether Swiper should be initialised automatically when you create an instance. If disabled, then you need to init it manually by calling swiper.init()

Index number of initial slide.

Set to false if you want to disable long swipes

Minimal duration (in ms) to trigger swipe to next/previous slide during long swipes

Ratio to trigger swipe to next/previous slide during long swipes

Set to true to enable continuous loop mode

Because of nature of how the loop mode works, it will add duplicated slides. Such duplicated slides will have additional classes:

  • swiper-slide-duplicate — represents duplicated slide
  • swiper-slide-duplicate-active — represents slide duplicated to the currently active slide
  • swiper-slide-duplicate-next — represents slide duplicated to the slide next to active
  • swiper-slide-duplicate-prev — represents slide duplicated to the slide previous to active

If you use it along with slidesPerView: ‘auto’ then you need to specify loopedSlides parameter with amount of slides to loop (duplicate)

Addition number of slides that will be cloned after creating of loop

Enable and loop mode will fill groups with insufficient number of slides with blank slides. Good to be used with slidesPerGroup parameter

When enabled it prevents Swiper slide prev/next transitions when transitions is already in progress (has effect when loop enabled)

If you use slidesPerView:’auto’ with loop mode you should tell to Swiper how many slides it should loop (duplicate) using this parameter

Array with Swiper modules

Set to true on Swiper for correct touch events interception. Use only on swipers that use same direction as the parent one

Enable/disable swiping on elements matched to class specified in noSwipingClass

Specify noSwiping ‘s element css class

Can be used instead of noSwipingClass to specify elements to disable swiping on. For example ‘input’ will disable swiping on all inputs

Normalize slide index.

Set to true if you also need to watch Mutations for Swiper parent elements

Set to true if you also need to watch Mutations for Swiper slide children elements

Set to true to enable Mutation Observer on Swiper and its elements. In this case Swiper will be updated (reinitialized) each time if you change its style (like hide/show) or modify its child elements (like adding/removing slides)

Register event handlers

Passive event listeners will be used by default where possible to improve scrolling performance on mobile devices. But if you need to use e.preventDefault and you have conflict with it, then you should disable this parameter

When enabled Swiper will force to load all images

Set to true to prevent accidental unwanted clicks on links during swiping

Set to true to stop clicks event propagation on links during swiping

When enabled it won’t allow to change slides by swiping or navigation/pagination buttons during transition

Set to false if you want to disable resistant bounds

This option allows you to control resistance ratio

When enabled it will use ResizeObserver (if supported by browser) on swiper container to detect container resize (instead of watching for window resize)

Set to true to round values of slides width and height to prevent blurry texts on usual resolution screens (if you have such)

Fire Transition/SlideChange/Start/End events on swiper initialization. Such events will be fired on initialization in case of your initialSlide is not 0, or you use loop mode

Enabled this option and plugin will set width/height on swiper wrapper equal to total size of all slides. Mostly should be used as compatibility fallback option for browser that don’t support flexbox layout well

Set to false if you want to disable short swipes

If true , Swiper will accept mouse events like touch events (click and drag to change slides)

CSS class name of currently active slide

By changing classes you will also need to change Swiper’s CSS to reflect changed classes

Not supported in Swiper Angular/React/Svelte/Vue components

Name Type Default Description
allowSlideNext boolean true
direction ‘horizontal’ | ‘vertical’ ‘horizontal’
effect ‘slide’ | ‘fade’ | ‘cube’ | ‘coverflow’ | ‘flip’ | ‘creative’ | ‘cards’ ‘slide’
focusableElements string ‘input, select, option, textarea, button, video, label’
slideBlankClass string ‘swiper-slide-invisible-blank’

CSS class name of blank slide append to fill groups in loop mode when loopFillGroupWithBlank is also enabled

By changing classes you will also need to change Swiper’s CSS to reflect changed classes

Not supported in Swiper Angular/React/Svelte/Vue

CSS class name of slide

By changing classes you will also need to change Swiper’s CSS to reflect changed classes

Not supported in Swiper Angular/React/Svelte/Vue components

slideDuplicateActiveClass string ‘swiper-slide-duplicate-active’

CSS class name of duplicated slide which represents the currently active slide

By changing classes you will also need to change Swiper’s CSS to reflect changed classes

Not supported in Swiper Angular/React/Svelte/Vue components

CSS class name of slide duplicated by loop mode

By changing classes you will also need to change Swiper’s CSS to reflect changed classes

Not supported in Swiper Angular/React/Svelte/Vue

slideDuplicateNextClass string ‘swiper-slide-duplicate-next’

CSS class name of duplicated slide which represents the slide next to active slide

By changing classes you will also need to change Swiper’s CSS to reflect changed classes

Not supported in Swiper Angular/React/Svelte/Vue

slideDuplicatePrevClass string ‘swiper-slide-duplicate-prev’

CSS class name of duplicated slide which represents the slide previous to active slide

By changing classes you will also need to change Swiper’s CSS to reflect changed classes

Not supported in Swiper Angular/React/Svelte/Vue

CSS class name of slide which is right after currently active slide

By changing classes you will also need to change Swiper’s CSS to reflect changed classes

Not supported in Swiper Angular/React/Svelte/Vue

CSS class name of slide which is right before currently active slide

By changing classes you will also need to change Swiper’s CSS to reflect changed classes

Not supported in Swiper Angular/React/Svelte/Vue

Set to true and click on any slide will produce transition to this slide

CSS class name of currently visible slide

By changing classes you will also need to change Swiper’s CSS to reflect changed classes

Not supported in Swiper Angular/React/Svelte/Vue

Add (in px) additional slide offset in the end of the container (after all slides)

Add (in px) additional slide offset in the beginning of the container (before all slides)

Set numbers of slides to define and enable group sliding. Useful to use with slidesPerView > 1

This param intended to be used only with slidesPerView: ‘auto’ and slidesPerGroup: 1 . When enabled, it will skip all slides in view on .slideNext() & .slidePrev() methods calls, on Navigation «buttons» clicks and in autoplay.

The parameter works in the following way: If slidesPerGroupSkip equals 0 (default), no slides are excluded from grouping, and the resulting behaviour is the same as without this change.

If slidesPerGroupSkip is equal or greater than 1 the first X slides are treated as single groups, whereas all following slides are grouped by the slidesPerGroup value.

Number of slides per view (slides visible at the same time on slider’s container).

If you use it with «auto» value and along with loop: true then you need to specify loopedSlides parameter with amount of slides to loop (duplicate)

slidesPerView: ‘auto’ is currently not compatible with multirow mode, when grid.rows > 1

Distance between slides in px.

If you use «margin» css property to the elements which go into Swiper in which you pass «spaceBetween» into, navigation might not work property.

Duration of transition between slides (in ms)

String with CSS selector or HTML element of the container with pagination that will work as only available handler for swiping

Threshold value in px. If «touch distance» will be lower than this value then swiper will not move

Allowable angle (in degrees) to trigger touch move

Target element to listen touch events on. Can be ‘container’ (to listen for touch events on swiper) or ‘wrapper’ (to listen for touch events on swiper-wrapper)

If enabled, then propagation of «touchmove» will be stopped

Enable to release touch events on slider edge position (beginning, end) to allow for further page scrolling

Force to always prevent default for touchstart ( pointerdown ) event

If disabled, touchstart ( pointerdown ) event won’t be prevented

If enabled (by default) and navigation elements’ parameters passed as a string (like «.pagination» ) then Swiper will look for such elements through child elements first. Applies for pagination, prev/next buttons and scrollbar elements

When enabled Swiper will be reinitialized after all inner images ( tags) are loaded. Required preloadImages: true

Swiper will recalculate slides position on window resize (orientationchange)

Required for active slide detection when rendered on server-side and enabled history

userAgent string. Required for browser/device detection when rendered on server-side

Enabled this option and swiper will be operated as usual except it will not move, real translate values on wrapper will not be set. Useful when you may need to create custom slide transition

When enabled Swiper will be disabled and hide navigation buttons on case there are not enough slides for sliding.

Enable this feature to calculate each slides progress and visibility (slides in viewport will have additional visible class)

Swiper width (in px). Parameter allows to force Swiper width. Useful only if you initialize Swiper when it is hidden and in SSR and Test environments for correct Swiper initialization

Setting this parameter will make Swiper not responsive

CSS class name of slides’ wrapper

By changing classes you will also need to change Swiper’s CSS to reflect changed classes

Not supported in Swiper Angular/React/Svelte/Vue

Add event listener that will be fired on all events

Methods & Properties

After we initialize Slider we have its initialized instance in variable (like swiper variable in example above) with helpful methods and properties:

Dom7 element with slider container HTML element. To get vanilla HTMLElement use swiper.el

Dom7 element with slider wrapper HTML element. To get vanilla HTMLElement use swiper.wrapperEl

Index number of currently active slide

Note, that in loop mode active index value will be always shifted on a number of looped/duplicated slides

Disable / enable ability to slide to the next slides by assigning false / true to this property

Disable / enable ability to slide to the previous slides by assigning false / true to this property

Disable / enable ability move slider by grabbing it with mouse or by touching it with finger (on touch screens) by assigning false / true to this property

true if swiper is in transition

Index number of last clicked slide

Link to last clicked slide (HTMLElement)

Slider container HTML element

Height of container

true if slider on most «left»/»top» position

true if slider on most «right»/»bottom» position

Object with original initialization parameters

Object with passed initialization parameters

Index number of previously active slide

Current progress of wrapper translate (from 0 to 1)

Index number of currently active slide considering duplicated slides in loop mode

Dom7 array-like collection of slides HTML elements. To get specific slide HTMLElement use swiper.slides[1]

Object with the following touch event properties:

  • swiper.touches.startX
  • swiper.touches.startY
  • swiper.touches.currentX
  • swiper.touches.currentY
  • swiper.touches.diff

Current value of wrapper translate

Width of container

Wrapper HTML element

Swiper default options

Object with global Swiper extended options

Attach all events listeners again

Changes slider direction from horizontal to vertical and back.

  • direction — ‘horizontal’ | ‘vertical’ — New direction. If not specified, then will automatically changed to opposite direction
  • needUpdate — boolean — Will call swiper.update(). Default true

Destroy slider instance and detach all events listeners

  • deleteInstance — boolean — Set it to false (by default it is true) to not to delete Swiper instance
  • cleanStyles — boolean — Set it to true (by default it is true) and all custom styles will be removed from slides, wrapper and container. Useful if you need to destroy Swiper and to init again with new options or in different direction

Detach all events listeners

Disable Swiper (if it was enabled). When Swiper is disabled, it will hide all navigation elements and won’t respond to any events and interactions

Fire event on instance

Enable Swiper (if it was disabled)

Get current value of swiper wrapper css3 transform translate

Remove event handler

Remove event listener that will be fired on all events

Add event handler

Add event listener that will be fired on all events

Add event handler that will be removed after it was fired

Set grab cursor

Set Swiper translate progress (from 0 to 1). Where 0 — its initial position (offset) on first slide, and 1 — its maximum position (offset) on last slide

  • progress — number — Swiper translate progress (from 0 to 1).
  • speed — number — Transition duration (in ms).

Set custom css3 transform’s translate value for swiper wrapper

Run transition to next slide.

  • speed — number — Transition duration (in ms).
  • runCallbacks — boolean — Set it to false (by default it is true) and transition will not produce transition events.

Run transition to previous slide.

  • speed — number — Transition duration (in ms).
  • runCallbacks — boolean — Set it to false (by default it is true) and transition will not produce transition events.

Reset swiper position to currently active slide for the duration equal to ‘speed’ parameter.

  • speed — number — Transition duration (in ms).
  • runCallbacks — boolean — Set it to false (by default it is true) and transition will not produce transition events.

Run transition to the slide with index number equal to ‘index’ parameter for the duration equal to ‘speed’ parameter.

  • index — number — Index number of slide.
  • speed — number — Transition duration (in ms).
  • runCallbacks — boolean — Set it to false (by default it is true) and transition will not produce transition events.

Reset swiper position to closest slide/snap point for the duration equal to ‘speed’ parameter.

  • speed — number — Transition duration (in ms).
  • runCallbacks — boolean — Set it to false (by default it is true) and transition will not produce transition events.

Does the same as .slideTo but for the case when used with enabled loop. So this method will slide to slides with realIndex matching to passed index

  • index — number — Index number of slide.
  • speed — number — Transition duration (in ms).
  • runCallbacks — boolean — Set it to false (by default it is true) and transition will not produce transition events.

Animate custom css3 transform’s translate value for swiper wrapper

  • translate — number — Translate value (in px)
  • speed — number — Transition duration (in ms)
  • runCallbacks — boolean — Set it to false (by default it is true) and transition will not produce transition events
  • translateBounds — boolean — Set it to false (by default it is true) and transition value can extend beyond min and max translate

Unset grab cursor

You should call it after you add/remove slides manually, or after you hide/show it, or do any custom DOM modifications with Swiper This method also includes subcall of the following methods which you can use separately:

Force swiper to update its height (when autoHeight enabled) for the duration equal to ‘speed’ parameter

  • speed — number — Transition duration (in ms).

recalculate swiper progress

recalculate size of swiper container

recalculate number of slides and their offsets. Useful after you add/remove slides with JavaScript

update active/prev/next classes on slides and bullets

Extend global Swiper defaults

Installs modules on Swiper in runtime.

Events

Swiper comes with a bunch of useful events you can listen. Events can be assigned in two ways:

Using on parameter on swiper initialization:

Using on method after swiper initialization.

Properties
swiper.$el Dom7Array
swiper.translate number
swiper.destroy( deleteInstance , cleanStyles )
swiper.detachEvents()
swiper.setTranslate( translate )
swiper.slidePrev( speed , runCallbacks )
swiper.slideReset( speed , runCallbacks )
swiper.slideTo( index , speed , runCallbacks )
swiper.slideToClosest( speed , runCallbacks )
swiper.slideToLoop( index , speed , runCallbacks )
swiper.translateTo( translate , speed , runCallbacks , translateBounds )
swiper.unsetGrabCursor()
swiper.updateProgress()

Event will fired on active index change

Event will fired right after initialization

Event will be fired right before Swiper destroyed

Event will fired right before initialization

Event will be fired right before «loop fix»

Event will fired before resize handler

Event will fired before slide change transition start

Event will fired before transition start

Event will be fired on breakpoint change

Event will fired on direction change

Event will be fired when user click/tap on Swiper. Receives touchend event as an arguments.

Event will be fired on swiper destroy

Event will be fired when user double click/tap on Swiper

Event will be fired when user double tap on Swiper’s container. Receives touchend event as an arguments

Event will be fired when Swiper goes from beginning or end position

Event will be fired right after all inner images are loaded. updateOnImagesReady should be also enabled

Fired right after Swiper initialization.

Event will be fired when swiper is locked (when watchOverflow enabled)

Event will be fired after «loop fix»

Event will be fired on momentum bounce

Event will be fired if observer is enabled and it detects DOM mutations

Event will be fired on orientation change (e.g. landscape -> portrait)

Event will be fired when Swiper progress is changed, as an arguments it receives progress that is always from 0 to 1

Event will be fired when Swiper reach its beginning (initial position)

Event will be fired when Swiper reach last slide

Event will fired on real index change

Event will be fired on window resize right before swiper’s onresize manipulation

Event will be fired everytime when swiper starts animation. Receives current transition duration (in ms) as an arguments

Event will be fired when swiper’s wrapper change its position. Receives current translate value as an arguments

Event will be fired when currently active slide is changed

Event will be fired after animation to other slide (next or previous).

Event will be fired in the beginning of animation to other slide (next or previous).

Same as «slideChangeTransitionEnd» but for «forward» direction only

Same as «slideChangeTransitionStart» but for «forward» direction only

Same as «slideChangeTransitionEnd» but for «backward» direction only

Same as «slideChangeTransitionStart» but for «backward» direction only

Event will be fired in the end of animation of resetting slide to current one

Event will be fired in the beginning of animation of resetting slide to current one

Event will be fired with first touch/drag move

Event will be fired when user touch and move finger over Swiper and move it. Receives touchmove event as an arguments.

Event will be fired when slides grid has changed

Event will be fired when number of slides has changed

Event will be fired when snap grid has changed

Event will fired on snap index change

Event will be fired when user click/tap on Swiper. Receives touchend event as an arguments.

Event will be fired when Swiper goes to beginning or end position

Event will be fired when user release Swiper. Receives touchend event as an arguments.

Event will be fired when user touch and move finger over Swiper. Receives touchmove event as an arguments.

Event will be fired when user touch and move finger over Swiper in direction opposite to direction parameter. Receives touchmove event as an arguments.

Event will be fired when user touch Swiper. Receives touchstart event as an arguments.

Event will be fired after transition.

Event will be fired in the beginning of transition.

Event will be fired when swiper is unlocked (when watchOverflow enabled)

Event will be fired after swiper.update() call

Modules

Name Arguments Description
activeIndexChange (swiper)

Object with navigation parameters or boolean true to enable with default settings.

CSS class name added to navigation button when it becomes disabled

CSS class name added to navigation button when it becomes hidden

Toggle navigation buttons visibility after click on Slider’s container

CSS class name added to navigation button when it is disabled

String with CSS selector or HTML element of the element that will work like «next» button after click on it

String with CSS selector or HTML element of the element that will work like «prev» button after click on it

HTMLElement of «next» navigation button

HTMLElement of «previous» navigation button

Update navigation buttons state (enabled/disabled)

Name Type Default Description
navigation boolean | NavigationOptions

Event will be fired on navigation hide

Event will be fired on navigation show

Pagination

Pagination Parameters

Name Arguments Description
navigationHide (swiper)

Object with pagination parameters or boolean true to enable with default settings.

CSS class name of currently active pagination bullet

CSS class name of single pagination bullet

Defines which HTML tag will be used to represent single pagination bullet. Only for ‘bullets’ pagination type.

If true then clicking on pagination button will cause transition to appropriate slide. Only for bullets pagination type

CSS class name set to pagination when it is clickable

CSS class name of the element with currently active index in «fraction» pagination

Good to enable if you use bullets pagination with a lot of slides. So it will keep only few bullets visible at the same time.

The number of main bullets visible when dynamicBullets enabled.

String with CSS selector or HTML element of the container with pagination

CSS class name of pagination when it becomes inactive

Toggle (hide/show) pagination container visibility after click on Slider’s container

CSS class name set to pagination in horizontal Swiper

CSS class name set to pagination when it is disabled

The beginning of the modifier CSS class name that will be added to pagination depending on parameters

CSS class name of pagination progressbar fill element

Makes pagination progressbar opposite to Swiper’s direction parameter, means vertical progressbar for horizontal swiper direction and horizontal progressbar for vertical swiper direction

CSS class name of pagination progressbar opposite

CSS class name of the element with total number of «snaps» in «fraction» pagination

String with type of pagination. Can be ‘bullets’ , ‘fraction’ , ‘progressbar’ or ‘custom’

CSS class name set to pagination in vertical Swiper

Pagination Methods

Dom7 array-like collection of pagination bullets HTML elements. To get specific slide HTMLElement use swiper.pagination.bullets[1] .

HTMLElement of pagination container element

Render pagination layout

Update pagination state (enabled/disabled/active)

Pagination Events

Name Type Default Description
pagination boolean | PaginationOptions
<
bulletActiveClass string ‘swiper-pagination-bullet-active’
clickableClass string ‘swiper-pagination-clickable’
currentClass string ‘swiper-pagination-current’
formatFractionCurrent function( number )
formatFractionTotal function( number )
hiddenClass string ‘swiper-pagination-hidden’
horizontalClass string ‘swiper-pagination-horizontal’
progressbarFillClass string ‘swiper-pagination-progressbar-fill’
progressbarOppositeClass string ‘swiper-pagination-progressbar-opposite’
renderBullet function( index , className )
renderCustom function( swiper , current , total )
renderFraction function( currentClass , totalClass )
renderProgressbar function( progressbarFillClass )
totalClass string ‘swiper-pagination-total’
type ‘bullets’ | ‘fraction’ | ‘progressbar’ | ‘custom’ ‘bullets’
verticalClass string ‘swiper-pagination-vertical’

Event will be fired on pagination hide

Event will be fired after pagination rendered

Event will be fired on pagination show

Event will be fired when pagination updated

Scrollbar

Scrollbar Parameters

Name Arguments Description
paginationHide (swiper)

Object with scrollbar parameters or boolean true to enable with default settings.

Scrollbar draggable element CSS class

Size of scrollbar draggable element in px

Set to true to enable make scrollbar draggable that allows you to control slider position

String with CSS selector or HTML element of the container with scrollbar.

Hide scrollbar automatically after user interaction

Scrollbar element additional CSS class when it is disabled

Set to true to snap slider position to slides when you release scrollbar

Scrollbar Methods

HTMLElement of Scrollbar draggable handler element

HTMLElement of Scrollbar container element

Updates scrollbar translate

Updates scrollbar track and handler sizes

Scrollbar Events

Name Type Default Description
scrollbar boolean | ScrollbarOptions

Event will be fired on draggable scrollbar drag end

Event will be fired on draggable scrollbar drag move

Event will be fired on draggable scrollbar drag start

Autoplay

Autoplay Parameters

Name Arguments Description
scrollbarDragEnd (swiper, event)

Object with autoplay parameters or boolean true to enable with default settings

Delay between transitions (in ms). If this parameter is not specified, auto play will be disabled

If you need to specify different delay for specific slides you can do it by using data-swiper-autoplay (in ms) attribute on slide.

Set to false and autoplay will not be disabled after user interactions (swipes), it will be restarted every time after interaction

When enabled autoplay will be paused on mouse enter over Swiper container. If disableOnInteraction is also enabled, it will stop autoplay instead of pause

Enables autoplay in reverse direction

Enable this parameter and autoplay will be stopped when it reaches last slide (has no effect in loop mode)

When enabled autoplay will wait for wrapper transition to continue. Can be disabled in case of using Virtual Translate when your slider may not have transition

Autoplay Methods

Whether autoplay enabled and running

Autoplay Events

Name Type Default Description
autoplay boolean | AutoplayOptions

Event will be fired when slide changed with autoplay

Event will be fired in when autoplay started

Event will be fired when autoplay stopped

Free Mode

Free Mode Parameters

Name Arguments Description
autoplay (swiper)

Enables free mode functionality. Object with free mode parameters or boolean true to enable with default settings.

Minimum touchmove-velocity required to trigger free mode momentum

If enabled, then slide will keep moving for a while after you release it

Set to false if you want to disable momentum bounce in free mode

Higher value produces larger momentum bounce effect

Higher value produces larger momentum distance after you release slider

Higher value produces larger momentum velocity after you release slider

Set to enabled to enable snap to slides positions in free mode

Grid Parameters

Name Type Default Description
freeMode boolean | FreeModeOptions

Object with grid parameters to enable «multirow» slider.

Can be ‘column’ or ‘row’ . Defines how slides should fill rows, by column or by row

Number of slides rows, for multirow layout

rows > 1 is currently not compatible with loop mode ( loop: true )

Manipulation

Manipulation module adds useful Swiper methods to manipulate slides. It makes sense to use it only with Swiper Core version, not intended to be uses with Swiper Angular, React, Svelte or Vue.

Manipulation Methods

Add new slides to the required index. slides could be HTMLElement or HTML string with new slide or array with such slides, for example:

Add new slides to the end. slides could be HTMLElement or HTML string with new slide or array with such slides, for example:

Add new slides to the beginning. slides could be HTMLElement or HTML string with new slide or array with such slides, for example:

Remove all slides

Remove selected slides. slideIndex could be a number with slide index to remove or array with indexes.

Parallax

Swiper supports parallax transition effects for swiper/slides nested elements. There are two types of parallax elements supported:

  • Direct child elements of swiper . Parallax effect for such elements will depend on total slider progress. Useful for parallax backgrounds
  • Slides child elements. Parallax effect for such elements will depend on slide progress

To enable parallax effects you need to init Swiper with passed parallax:true parameter and add one of the following (or mix) attributes to required elements:

  • data-swiper-parallax — enable transform-translate parallax transition. This attribute may accept:
    • number — value in px (as for title, subtitle in example above) to move element depending on progress. In this case such element will be moved on ± this value in px depending on slide position (next or previous)
    • percentage — (as for «parallax-bg») to move element depending on progress and on its size. In this case such element will be moved on ± this percentage of its size (width in horizontal direction, and height in vertical direction) depending on slide position (next or previous). So if element has 400px width and you specified data-swiper-parallax=»50%» then it will be moved on ± 200px
  • data-swiper-parallax-x — same but for x-axis direction
  • data-swiper-parallax-y — same but for y-axis direction
  • data-swiper-parallax-scale — scale ratio of the parallax element when it is in «inactive» (not on active slide) state
  • data-swiper-parallax-opacity — opacity of the parallax element when it is in «inactive» (not on active slide) state
  • data-swiper-parallax-duration — custom transition duration for parallax elements

Parallax Parameters

Name Type Default Description
grid GridOptions

Object with parallax parameters or boolean true to enable with default settings.

Enable, if you want to use «parallaxed» elements inside of slider

Lazy Loading

To enable lazy loading, first of all we need a special layout for images or elements with background in slides:

  • Each lazy loaded image/element should have additional «swiper-lazy» class
  • Lazy image source for element should be specified in «data-src» attribute instead of «src»
  • Lazy image source set for element should be specified in «data-srcset» attribute instead of «srcset»
  • Lazy background image source should be specified in «data-background» attribute

You may also add animated preloader spinner to slide which will be removed automatically after image loaded:

Or white one for dark layout:

After that we need to enable lazy loading on Swiper initialization:

Lazy Loading Parameters

Name Type Default Description
parallax boolean | ParallaxOptions

Enables images lazy loading. Object with lazy loading parameters or boolean true to enable with default settings

Enables to check is the Swiper in view before lazy loading images on initial slides

CSS class name of lazy element

By default, Swiper will load lazy images after transition to this slide, so you may enable this parameter if you need it to start loading of new image in the beginning of transition

Set to true to enable lazy loading for the closest slides images (for previous and next slide images)

Amount of next/prev slides to preload lazy images in. Can’t be less than slidesPerView

CSS class name of lazy loaded element

CSS class name of lazy loading element

CSS class name of lazy preloader

Element to check scrolling on for checkInView . Defaults to window

Lazy Loading Methods

Load/update lazy images based on current slider state (position)

Force to load lazy images in slide by specified index

Lazy Loading Events

Name Type Default Description
lazy boolean | LazyOptions
scrollingElement CSSSelector | HTMLElement | Dom7Array

Event will be fired in the beginning of lazy loading of image

Event will be fired when lazy loading image will be loaded

Fade Effect

Be sure to have the effect param set to ‘fade’ in order for this to work.

Fade Effect Parameters

Name Arguments Description
lazyImageLoad (swiper, slideEl, imageEl)

Object with Fade-effect parameters

Enables slides cross fade

CSS selector of the element inside of the slide to transform instead of the slide itself. Useful to use with cssMode

Coverflow Effect

Be sure to have the effect param set to ‘coverflow’ in order for this to work.

Coverflow Effect Parameters

Name Type Default Description
fadeEffect FadeEffectOptions

Object with Coverflow-effect parameters.

Depth offset in px (slides translate in Z axis)

Slide rotate in degrees

Enables slides shadows

Stretch space between slides (in px)

CSS selector of the element inside of the slide to transform instead of the slide itself. Useful to use with cssMode

Flip Effect

Be sure to have the effect param set to ‘flip’ in order for this to work.

Flip Effect Parameters

Name Type Default Description
coverflowEffect CoverflowEffectOptions

Object with Flip-effect parameters

Limit edge slides rotation

Enables slides shadows

CSS selector of the element inside of the slide to transform instead of the slide itself. Useful to use with cssMode

Cube Effect

Be sure to have the effect param set to ‘cube’ in order for this to work.

Cube Effect Parameters

Name Type Default Description
flipEffect FlipEffectOptions

Object with Cube-effect parameters

Enables main slider shadow

Main shadow offset in px

Main shadow scale ratio

Enables slides shadows

Cards Effect

Be sure to have the effect param set to ‘cards’ in order for this to work.

Cards Effect Parameters

Name Type Default Description
cubeEffect CubeEffectOptions

Object with Cards-effect parameters

Enables slides shadows

CSS selector of the element inside of the slide to transform instead of the slide itself. Useful to use with cssMode

Creative Effect

Be sure to have the effect param set to ‘creative’ in order for this to work.

Creative Effect Parameters

Name Type Default Description
cardsEffect CardsEffectOptions

Object with Creative-effect parameters

Limit progress/offset to amount of side slides. If 1 , then slides all slides after prev/next will have same state. If 2 , then all slides after 2nd before/after active will have same state, etc.

Next slide transformations.

Enable this parameter if your custom transforms require 3D transformations ( translateZ , rotateX , rotateY )

Previous slide transformations. Accepts object of the following type:

Allows to multiply slides transformations and opacity.

Splits shadow «opacity» per slide based on limitProgress (only if transformation shadows enabled). E.g. setting limitProgress: 2 and enabling shadowPerProgress , will set shadow opacity to 0.5 and 1 on two slides next to active. With this parameter disabled, all slides beside active will have shadow with 1 opacity

CSS selector of the element inside of the slide to transform instead of the slide itself. Useful to use with cssMode

Thumbs

In addition to Controller component Swiper comes with Thumbs component that is designed to work with additional thumbs swiper in a more correct way than Controller which is used for syncing two swipers.

Thumbs Parameters

Name Type Default Description
creativeEffect CreativeEffectOptions

Object with thumbs component parameters

Allows to set on which thumbs active slide from edge it should automatically move scroll thumbs. For example, if set to 1 and last visible thumb will be activated (1 from edge) it will auto scroll thumbs

When enabled multiple thumbnail slides may get activated

Additional class that will be added to activated thumbs swiper slide

Swiper instance of swiper used as thumbs or object with Swiper parameters to initialize thumbs swiper

Additional class that will be added to thumbs swiper

Thumbs Methods

Swiper instance of thumbs swiper

Swiper supports zoom images functionality (similar to what you see on iOS when browsing single photo) where you can zoom-in image by pinch gesture and or by zoom-in/out by double tap on it. In this case, additional layout is required:

All «zoomable» images should be wrapped with the div with swiper-zoom-container class.

By default it expects to zoom one of the img , picture or canvas element. If you want to make zoom on some other custom element, then just add swiper-zoom-target class to this element. For example:

You can override maxRatio parameter for specific slides by using data-swiper-zoom attribute on zoom container.

Zoom Parameters

Name Type Default Description
thumbs ThumbsOptions

Enables zooming functionality. Object with zoom parameters or boolean true to enable with default settings

CSS class name of zoom container

Maximum image zoom multiplier

Minimal image zoom multiplier

Enable/disable zoom-in by slide’s double tap

CSS class name of zoomed in container

Zoom Methods

Whether the zoom module is enabled

Current image scale ratio

Disable zoom module

Enable zoom module

Zoom in image of the currently active slide

Zoom out image of the currently active slide

Toggle image zoom of the currently active slide

Zoom Events

Name Type Default Description
zoom boolean | ZoomOptions

Event will be fired on zoom change

Keyboard Control

Keyboard Control Parameters

Name Arguments Description
zoomChange (swiper, scale, imageEl, slideEl)

Enables navigation through slides using keyboard. Object with keyboard parameters or boolean true to enable with default settings

Set to true to enable keyboard control

When enabled it will control sliders that are currently in viewport

When enabled it will enable keyboard navigation by Page Up and Page Down keys

Keyboard Control Methods

Whether the keyboard control is enabled

Disable keyboard control

Enable keyboard control

Keyboard Events

Name Type Default Description
keyboard boolean | KeyboardOptions

Event will be fired on key press

Mousewheel Control

Mousewheel Control Parameters

Name Arguments Description
keyPress (swiper, keyCode)

Enables navigation through slides using mouse wheel. Object with mousewheel parameters or boolean true to enable with default settings

String with CSS selector or HTML element of the container accepting mousewheel events. By default it is swiper

Set to true to force mousewheel swipes to axis. So in horizontal mode mousewheel will work only with horizontal mousewheel scrolling, and only with vertical scrolling in vertical mode.

Set to true to invert sliding direction

Set to true and swiper will release mousewheel event and allow page scrolling when swiper is on edge positions (in the beginning or in the end)

Multiplier of mousewheel data, allows to tweak mouse wheel sensitivity

Minimum mousewheel scroll delta to trigger swiper slide change

Minimum mousewheel scroll time delta (in ms) to trigger swiper slide change

Mousewheel Control Methods

Whether the mousewheel control is enabled

Disable mousewheel control

Enable mousewheel control

Mousewheel Events

Name Type Default Description
mousewheel boolean | MousewheelOptions
<
eventsTarget ‘container’ | CSSSelector | HTMLElement | ‘wrapper’ ‘container’

Event will be fired on mousewheel scroll

Virtual Slides

Virtual Slides module allows to keep just required amount of slides in DOM. It is very useful in terms in performance and memory issues if you have a lot of slides, especially slides with heavyweight DOM tree or images.

Virtual Slides Parameters

Name Arguments Description
scroll (swiper, event)

Enables virtual slides functionality. Object with virtual slides parameters or boolean true to enable with default settings.

Increases amount of pre-rendered slides after active slide

Increases amount of pre-rendered slides before active slide

Enables DOM cache of rendering slides html elements. Once they are rendered they will be saved to cache and reused from it.

When enabled (by default) it will update Swiper layout right after renderExternal called. Useful to disable and update swiper manually when used with render libraries that renders asynchronously

Array with slides

Virtual Slides Methods

Object with cached slides HTML elements

Index of first rendered slide

Array with slide items passed by virtual.slides parameter

Index of last rendered slide

Append slide. slides can be a single slide item or array with such slides.

Prepend slide. slides can be a single slide item or array with such slides.

Remove all slides

Remove specific slide or slides. slideIndexes can be a number with slide index to remove or array with indexes.

Update virtual slides state

Hash Navigation

Hash navigation is intended to have a link to specific slide that allows to load page with specific slide opened.

To make it work, you need to enable it by passing hashNavigation:true parameter and adding slides hashes in data-hash attribute:

Hash Navigation Parameters

Name Type Default Description
virtual boolean | VirtualOptions
enabled boolean
renderExternal function( data )
renderExternalUpdate boolean true

Enables hash url navigation to for slides. Object with hash navigation parameters or boolean true to enable with default settings

Works in addition to hashnav to replace current url state with the new one instead of adding it to history

Set to true to enable also navigation through slides (when hashnav is enabled) by browser history or by setting directly hash on document location

Hash Navigation Events

Name Type Default Description
hashNavigation boolean | HashNavigationOptions

Event will be fired on window hash change

Event will be fired when swiper updates the hash

History Navigation

History Navigation Parameters

Name Arguments Description
hashChange (swiper)

Enables history push state where every slide will have its own url. In this parameter you have to specify main slides url like «slides» and specify every slide url using data-history attribute.

Object with history navigation parameters or boolean true to enable with default settings

Url key for slides

Works in addition to hashnav or history to replace current url state with the new one instead of adding it to history

Swiper page root, useful to specify when you use Swiper history mode not on root website page. For example can be https://my-website.com/ or https://my-website.com/subpage/ or /subpage/

Controller

Controller Parameters

Name Type Default Description
history boolean | HistoryOptions

Object with controller parameters or boolean true to enable with default settings

Defines a way how to control another slider: slide by slide (with respect to other slider’s grid) or depending on all slides/container (depending on total slider percentage).

Pass here another Swiper instance or array with Swiper instances that should be controlled by this Swiper

Set to true and controlling will be in inverse direction

Controller Methods

Pass here another Swiper instance or array with Swiper instances that should be controlled by this Swiper

Accessibility (a11y)

Accessibility Parameters

Name Type Default Description
controller ControllerOptions

Object with a11y parameters or boolean true to enable with default settings.

Message for screen readers for outer swiper container

Message for screen readers describing the role of outer swiper container

Message for screen readers for previous button when swiper is on first slide

Message for screen readers describing the role of slide element

Message for screen readers for next button when swiper is on last slide

Message for screen readers for next button

CSS class name of A11y notification

Message for screen readers for single pagination bullet

Message for screen readers for previous button

Message for screen readers describing the label of slide element

Value of swiper slide role attribute

Custom Build

You have two options of making custom version of Swiper.

Using JS Modules

If you use bundler with JS modules support in your project you can import only the modules you need:

The following modules are exported:

  • Virtual — Virtual Slides module
  • Keyboard — Keyboard Control module
  • Mousewheel — Mousewheel Control module
  • Navigation — Navigation module
  • Pagination — Pagination module
  • Scrollbar — Scrollbar module
  • Parallax — Parallax module
  • FreeMode — Free Mode module
  • Grid — Grid module
  • Manipulation — Slides manipulation module (only for Core version)
  • Zoom — Zoom module
  • Lazy — Lazy module
  • Controller — Controller module
  • A11y — Accessibility module
  • History — History Navigation module
  • HashNavigation — Hash Navigation module
  • Autoplay — Autoplay module
  • EffectFade — Fade Effect module
  • EffectCube — Cube Effect module
  • EffectFlip — Flip Effect module
  • EffectCoverflow — Coverflow Effect module
  • EffectCards — Cards Effect module
  • EffectCreative — Creative Effect module
  • Thumbs — Thumbs module

Using Build Script

Swiper comes with gulp builder that allows to build custom library version where you may include only required modules. We need the following:

Download and unzip Swiper GitHub repository to local folder

Install Node.js (if not installed)

Now, we need to install required dependencies. Go to the folder with downloaded and unzipped Swiper repository and execute in terminal:

Open scripts/build-config.js file:

Now, we are ready to build custom version of Swiper:

That is all. Generated CSS and JS files and their minified versions will be available in dist/ folder.

TypeScript Definitions

Swiper is fully typed, it exports Swiper and SwiperOptions types:

You can also check auto generated TypeScript definitions explorer for all the types, options, properties and methods.

Источник

Читайте также:  Фольксваген поло не работает ближний свет фар причина
Оцените статью
Name Type Default Description
a11y A11yOptions
firstSlideMessage string ‘This is the first slide’