Bug Fixes

• Remove scrollbars click event when its no longer required. #720

Changelogs:

You can read further details in the corresponding changelogs.

• overlayscrollbars
• overlayscrollbars-react
• overlayscrollbars-vue
• overlayscrollbars-ngx
• overlayscrollbars-svelte
• overlayscrollbars-solid

Improvements

• Introduce and document the new CSS Custom Properties: --os-viewport-overflow-x and --os-viewport-overflow-y which can be used to better control the overflow style of the viewport element.
• Support for the auto value for overwrites of the overflow style of the viewport.

Changelogs:

You can read further details in the corresponding changelogs.

• overlayscrollbars
• overlayscrollbars-react
• overlayscrollbars-vue
• overlayscrollbars-ngx
• overlayscrollbars-svelte
• overlayscrollbars-solid

Improvements

• Streamline css styles for the viewport and wrapper elements to allow overwrites of the overflow property. #718

Bug Fixes

• Initialization bridging via data-overlayscrollbars-initialize attribute conflicted with the showNativeOverlaidScrollbars: true option when initialized to the body element. #713

Changelogs:

You can read further details in the corresponding changelogs.

• overlayscrollbars
• overlayscrollbars-react
• overlayscrollbars-vue
• overlayscrollbars-ngx
• overlayscrollbars-svelte
• overlayscrollbars-solid

Improvements

• Use the ResizeObservers options.box option to remove the need for additional DOM elements in supported browsers.
• Significant performance improvements in the update logic.

Changelogs:

You can read further details in the corresponding changelogs.

• overlayscrollbars
• overlayscrollbars-react
• overlayscrollbars-vue
• overlayscrollbars-ngx
• overlayscrollbars-svelte
• overlayscrollbars-solid

Features

• Add the possibility to define a trusted type policy for websites with a CSP. #697

Improvements

• Change ScrollAnimationTimeline keyframes to not animate css-custom-properties to improve scroll performance. #705

Changelogs:

You can read further details in the corresponding changelogs.

• overlayscrollbars
• overlayscrollbars-react
• overlayscrollbars-vue
• overlayscrollbars-ngx
• overlayscrollbars-svelte
• overlayscrollbars-solid

Improvements

• Add pen to the list of "hoverable" pointer devices. #690

Changelogs:

You can read further details in the corresponding changelogs.

• overlayscrollbars
• overlayscrollbars-react
• overlayscrollbars-vue
• overlayscrollbars-ngx
• overlayscrollbars-svelte
• overlayscrollbars-solid

Features

• The option scrollbars.clickScroll now supports the value 'instant'. The ClickScrollPlugin is not required for it to work. #645

Improvements

• Rewrite clickScroll animation for better performance and to support in and out easing for a smoother animation.

Changelogs:

You can read further details in the corresponding changelogs.

• overlayscrollbars
• overlayscrollbars-react
• overlayscrollbars-vue
• overlayscrollbars-ngx
• overlayscrollbars-svelte
• overlayscrollbars-solid

Features

• Add the possibility to define a nonce value for websites with a CSP. #646

Improvements

• Reduced bundle size due to removed compatiblity code.
• clickScroll will not cancel on fast clicks / taps. #650
• Add easing to the clickScroll animation.
• The scrollbar-handle offset and size calculations are now entirely in CSS and will not force reflows.
• Use custom css properties for setting the scrollbar-handle offset and size.

Bug Fixes

• Only take the initial scroll coordinates from the viewport element if it has a scrollable overflow. (Otherwise take the initial scroll coordinates from the target element) #652

Changelogs:

You can read further details in the corresponding changelogs.

• overlayscrollbars
• overlayscrollbars-react
• overlayscrollbars-vue
• overlayscrollbars-ngx
• overlayscrollbars-svelte
• overlayscrollbars-solid

Breaking Changes

• Although not a major release, I've decided to remove the rtlScrollBehavior field from the Environment object. The reason for it is a switch of how the library now detects scroll coordinates for non default flow directions. The replacement for this field is the scrollCoordinates field of the State object for each instance.

Features

• Support non default flow directions (block and inline) not only direction: rtl. #625
• A new field scrollCoordinates in the State object. It indicates the min. and max. scroll coordinates for the viewport. (useful for non default flow direction scrolling)
• A new field scrollCoordinatesChanged in the updateHints object. It indicates whether the scroll coordinates changed in an update.

Improvements

• Fix a Firefox only behavior where releasing a scrollbar handle over an anchor would trigger the anchor and navigate to it.
• Change zoom detection: instead of the window.resize event, the window.matchMedia event is used.
• Greatly improve how dragging and releasing the scrollbar handle behaves for scroll-snapped viewports.

Bug Fixes

• Fix a bug here pointer capture was released too early for wacom pen devices. #630

Changelogs:

You can read further details in the corresponding changelogs.

• overlayscrollbars
• overlayscrollbars-react
• overlayscrollbars-vue
• overlayscrollbars-ngx
• overlayscrollbars-svelte
• overlayscrollbars-solid

Improvements

• Improvements for running in deno and bun.
• Initialization as the body element is now detected as such when the tag name of the target element is "body". Previously this detection was done with target === target.ownerDocument.body which would not work when creating a new body element in memory.
• If a non generated elements.viewport element is provided during initialization its scroll position will be taken as the initial scroll position instead of the scroll position of the target element.
• When interacting with the scrollbars itself the scrollbars.autoHideDelay will now apply when the scrollbars would be auto hidden when the interaction ends.

Changelogs:

You can read further details in the corresponding changelogs.

• overlayscrollbars
• overlayscrollbars-react
• overlayscrollbars-vue
• overlayscrollbars-ngx
• overlayscrollbars-svelte
• overlayscrollbars-solid