Search packages, repositories and app categories

Package detailsv1.0.8

smooth_scroll_multiplatform

A wrapper for scrollable widgets that enables smooth scrolling with a mouse on all platforms.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
1.3K
Likes
30
Pub points
130

Install package

flutter pub add smooth_scroll_multiplatform

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter package that enhances scrollable widgets with smooth, mouse-driven scrolling across all platforms. It wraps existing scrollable components—like ListView or ScrollViewController—to provide a fluid, continuous scrolling experience when using a mouse, improving usability on desktop and web. The package ensures consistent behavior regardless of the target platform, making it ideal for applications requiring precise navigation. It leverages native input handling to deliver responsive and natural scrolling motion.

Use cases

  • Desktop application navigation
  • Web app smooth scrolling
  • Cross-platform UI consistency
  • Enhanced user experience on mouse input
  • Scrolling in data-heavy interfaces

Key features

  • Platform-agnostic smooth scrolling
  • Mouse-centric scroll optimization
  • Seamless integration with existing scrollables
  • Supports all major platforms
  • Minimal configuration required

Suitable for

  • Developers targeting multiple platforms
  • Apps with extensive scrollable content
  • Desktop and web-focused Flutter projects
  • UX-focused interface design
  • Projects needing refined scroll behavior

Considerations

  • May not affect touch-based scrolling
  • Requires mouse input for full effect
  • Limited impact on mobile platforms
  • Best suited for non-mobile use cases
  • Potential performance overhead on large lists

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Multiplatform Smooth Scroll

A fork of the dyn_mouse_scroll package, including Wizzel1's fixes and my own fixes; Provides wrapper for scrollable widgets that enables smooth scrolling with a mouse wheel, trackpad or touch screen on all platforms; This fork fixes all issues regarding trackpad, mouse/trackpad switching and animations, fixing the slippery effect when changing scroll direction; The fork also changes the default mouse scroll animation to look smoother; Additionally, it allows to change the scroll speed, on top of the duration and animation curve.

First gif: Scrolling slowly.
Second gif: Scrolling quickly (flick scroll).
Third gif: Mobile drag scroll detected, physics change.

Features

  • Animate smooth scroll based on speed of user's scroll.
  • Automatically detect if the wrong ScrollPhysics is being used and update using provider.
  • Adjust the duration of your scroll events.
  • Choose what mobile physics you would like to use.

Basic Usage

DynMouseScroll(
  builder: (context, controller, physics) => ListView(
    controller: controller,
    physics: physics,
    children: ...
    )
)

With additional settings:

DynMouseScroll(
  durationMS: 500,
  scrollSpeed: 4.4,
  animationCurve: Curves.easeOutQuart,
  builder: (context, controller, physics) => ListView(
    controller: controller,
    physics: physics,
    children: ...
    )
)

Problem:

Flutter does not animate smooth scrolls for pointers, causing choppy experiences for the end user. One package, web_smooth_scroll, attempts to fix this problem by disabling default scrolling entirely (mobile can't drag now) and listening for pointer events to animate the scroll controller that can only move at one speed.

Solution:

To allow mobile default scrolling to still be accessible I detect the user's platform and automatically update if the detection was wrong. When the user scrolls, the 'futurePosition' variable is updated and the animation is started I set the mobile scroll physics as the default one, switching to desktop scroll physics as the mouse wheel scroll is initiated and only starting the animation after the widget is rebuilt; the desktop scroll physics then takes priority over mobile physics, switching back to mobile physics only after the last scroll animation has ended, only if no new scroll wheel action had been initiated in the meantime.

Categories

Dependencies

Dependency list 1 items

Source repository

Projects using this package