# Heartslider

### A Minimalist JavaScript Slideshow

##### Version 3.5.4

'''''''''''''''''

[![](https://data.jsdelivr.com/v1/package/gh/austenhart/heartslider/badge)](https://www.jsdelivr.com/package/gh/austenhart/heartslider)

Features:

- No dependancies
- Custom user settings
- Small and lightweight
- Progressive loading for multiple sourceset images and video
- Optional swipe and click to advance

Change Log:

#### Last Updated: April 21, 2026

- 3.5.4 - Added stackOnMobile and preload APIs, improved transition/manual-skip timing, fixed allowFullVideoPLayback bug.
- 3.5.3 - Fixed destroy debug bug.
- 3.5.2 - Fixed goTo debug bug again.
- 3.5.1 - Fixed goTo debug bug, and allowFullVideoPlayback option.
- 3.5.0 - Improved logic for slide timing, delay, and manual transition. Progressive now supports an offset. Added debug setting.
- 3.4.14 - Fixed an animation stutter when manually advancing slides / looping on videos is now optional.
- 3.4.13 - Prevented videos from auto-playing paused slideshows.
- 3.4.12 - Fixed issue with duplicated active class.
- 3.4.11 - Added module file for NPM imports (mjs).
- 3.4.10 - Added CSS to package.json.
- 3.4.9 - Fixed package.json command.
- 3.4.8 - Fixed minified file issue.
- 3.4.7 - Added Destroy and GoTo functions. Restored FadeInOut option for transition effect.
- 3.4.6 - Fixed loadHandler error
- 3.4.5 - Fixed gap with dash, smoother visibilityHandler animations
- 3.4.4 - Made dots look less awful. Added 'firstImageLoad' callback.
- 3.4.3 - Added 'dots' for indicators and babel to workflow
- 3.4.2 - Reverted 'first-image-loaded' class
- 3.4.1 - Fixed issue with initing multiple slideshows
- 3.4.0 - Added progress indicators and support for video
- 3.3.1 - Fixed issue with custom Events
- 3.3.0 - Added transitionStart and transitionEnd events
- 3.2.7 - Many QOL improvements; buttons will auto-pause slideshow while click/swipe will not
- 3.2.6 - Fixed prev/next button selector
- 3.2.5 - Loop false works again
- 3.2.5 - Loop false works again
- 3.2.4 - Fixed issue with tab-index on first slide
- 3.2.3 - Added support for buttons!
- 3.2.2 - Fixed issue with progressiveLoad.
- 3.2.1 - Fixing timing errors with pause/resume/click/swipe
- 3.2.0 - Added click and swipe to advance
- 3.1.5 - Cleaning up repo and getting ready for 4.0
- 3.1.4 - Support for multiple images within slides
- 3.1.3 - First slide no longer takes years to fade in on start
- 3.1.2 - Comment improvements, removed will-change from CSS
- 3.1.1 - Fixed setting paused issues, added option to enable pauseOnInactiveWindow
- 2.1.3 - Added option to enable or disable the visibility change function
- 2.1.2 - Slideshow now pauses when user changes tabs/windows. PREV function still not working. Converted spaces to tabs.
- 2.1.1 - Fixed flashing z-index problem with custom transition
- 2.1.0 - Cleaned up code and added ability to choose between fadeOut (default) and fadeInOut!
- 2.0.6 - Fixed private variable scope error
- 2.0.5 - Added conditionals for slides without images
- 2.0.4 - Fixed jumping issue when looping past last slide
- 2.0.3 - Updated CSS and JS for compatibility with IE (ugh)
- 2.0.2 - Removed .children selector so jQuery doesn't get confused

To Do:

- [ ] If video is not long enough, slow it down at the end to prevent abrupt stop
- [ ] Add fadeRight or fadeLeft effect
- [x] Delay start
- [ ] Add ability to navigate with arrow keys
- [ ] Make randomize a string with 'start' and 'all' options
- [ ] Add counter (with custom separator, place inside heart-slideshow?)
- [ ] Add support for the <picture> and elements with multiple sources
- [ ] Live swipe transition progress
- [ ] Use JS bind() function instead of using "\_this" variable
- [x] Potentially add inner-container to house buttons and counter
- [x] Expose a goTo function, add index and skip animation option
- [x] Restore transition animation options (crossfade vs fadeout)
- [x] Destroy function (including all event listeners, timers, classnames and attributes)
- [x] Fix onTransitionEnd function timing
- [x] Fix stutter issue when changing tabs
- [x] Add type: "dot" option to indicators
- [x] Add firstImageLoaded callback
- [x] Add progress indicator options (dots or dashes, with fill)
- [x] Support for <video>
- [x] Remove delay when setting slideshows to paused
- [x] Better way to manage multiple slideshows
- [x] Add callback functions
- [x] Make sure slideshow initializes when not using data-src or data-srcset
- [x] Fix - clicking too soon after start skips slide transition for the first two slides
- [x] Add first image loaded callback
- [x] Add native support for prev/next buttons
- [x] Fix pause not working
- [x] Fix jump to second slide on click when slideshow is paused
- [x] Swipe to advance
- [x] Manually advancing a slide should transition quicker (or a custom time)
- [x] Wait until first image load to start timer

'''''''''''''''