embla-carousel

🌟 New features

The settle event is a new feature. This feature was specified and requested in issue #48.

embla.on('settle', () => {
  console.log(`The carousel has stopped scrolling.`)
})

The settle event allows users to hook onto when the carousel has stopped scrolling.

🛠️ Bugfixes

This patch resolves one bug:

• It solves issue #27. When Android devices fired the mousemove event during touch interactions, Embla threw a console error. This patch comes with a fix for this issue.

🌟 New features

The API method scrollBy() is a new feature. This feature was specified in issue #23 and requested in issue #21.

embla.scrollBy(0.5)

The scrollBy()method allows users to manipulate the current scroll progress by passing a number as an argument. Scroll to target is smooth.

🌟 New features

The options section in the readme has been updated with expandable details for each option:

🛠️ Bugfixes

This patch resolves two bugs:

• It solves issue #37 and cancels any drag interaction when contextmenu is opened.
• For mouse events, the carousel only listens for drag events if clicked mouse button is the left button.

🌟 New features

The API method clickAllowed() is a new feature. This feature was requested in issue #22 and #24.

embla.clickAllowed()

This method is an opt-in feature. Here is how it works: It returns false if:

Mouse Pointers

• Mouse drags the carousel.

Touch Pointers

• Touch drags the carousel.
• Carousel is in motion (i.e. is scrolling).

Otherwise it will return true.

📦 Package updates

Outdated NPM packages were updated in this release.

🛠️ Bugfixes

This release is a fix for the containScroll bug as described in issue #30.

🌟 New features

The API method scrollProgress() is a new feature. Implemented as discussed in issue #21.

embla.scrollProgress()

See this CodeSandbox for example usage.

👉 Changes

When using the option containScroll Embla will automatically merge any excessive snap points that share the same snap position as discussed in issue #19. This affects following API methods:

• canScrollPrev()
• canScrollNext()
• scrollSnapList()

🌟 New features

The scroll event has been added as a new feature.

embla.on('scroll', () => console.log('Carousel is scrolling'))

🛠️ Bug fixes

The API methods canScrollNext() and canScrollPrev() always returned false when loop: true. This solves the issue and always returns true for both these methods when loop: true.

Issue #15.

👉 Changes

Added API demo links to CodeSandbox examples.

🌟 New features

containScroll is now a feature. It contains slides to the carousel viewport to prevent excessive scrolling at the beginning or the end.

🛠️ Bugfixes

This release solves the Webpack 4 UMD module window issue.

🌟 New features

Improved drag accuracy:

• Pointer actions have been redesigned to have a higher accuracy and feel more natural.

Improved link handling:

• Links can now be used as slides.
• Links can now be used inside slides.
• Embla can differentiate between a click and drag interaction.

API methods added:

• scrollSnapList()

⚠️ Breaking changes

API method name changes:

• next() --> scrollNext()
• previous() --> scrollPrev()
• goTo() --> scrollTo()
• selectedIndex --> selectedScrollSnap()
• previousIndex --> previousScrollSnap()

API removed methods:

• groupedIndexes()

⚠️ Breaking changes

Options name changes:

• groupSlides --> slidesToScroll

API method name changes:

• hasPreviousIndex() --> canScrollPrevious()
• hasNextIndex() --> canScrollNext()

API removed methods:

• isLastIndex()
• isFirstIndex()

🛠 Bugfixes

When loop: true and the carousel container only contains a single slide, it will fallback to loop: false. Discussed in issue #12.

🌟 New features

Added following methods to the API:

• isFirstIndex()
• isLastIndex()
• hasPreviousIndex()
• hasNextIndex()