# Heartslider

### A Minimalist JavaScript Slideshow

##### Version 3.5.3

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

[![](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: December 23, 2025

-   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
-   [ ] 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

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