☰

Smooth Scroll

Enables smooth page scrolling using JavaScript. Improved from an initial concept by Winceptor.

Tác giả
DXRK1E
Cài đặt hàng ngày
0
Số lần cài đặt
105
Đánh giá
0 0 0
Phiên bản
2.4
Đã tạo
23-07-2024
Đã cập nhật
29-01-2025
Size
10 KB
Giấy phép
MIT
Áp dụng cho
Tất cả trang web

Smooth Scroll UserScript

Description:

This UserScript enhances your browsing experience by enabling smooth, animated scrolling on web pages. Unlike the default, jarring scroll behavior, this script provides a more fluid and visually pleasing way to navigate through content. It's designed to be customizable, allowing you to adjust the scrolling speed and smoothness to your personal preference.

Note: While this script is designed to be lightweight and performant, users on low-end PCs may experience some slight lag during scrolling. This is due to the increased processing required for the smooth animation.

Key Features:

  • Smooth Scrolling: Replaces the default jumpy scroll with a smooth animation.
  • Customizable: Allows you to adjust scroll smoothness and acceleration.
  • Intelligent Scrolling: Only animates when a significant scroll distance is detected.
  • Dynamic Refresh Rate: Automatically adjusts animation refresh rate for optimal performance.
  • Works Across Elements: Smooth scrolling works not just on the main page, but also on scrollable elements within the page.
  • Passive Event Listener (Optional): Allows users to configure if they want to use passive event listeners for enhanced performance.
  • Memory Efficient: Uses modern JavaScript techniques to avoid memory leaks.

How It Works:

This UserScript listens for mouse wheel (or trackpad) scroll events. When it detects one, it smoothly animates the scroll position of the page or scrollable element. It works by:

  1. Intercepting Scroll Events: Catches mouse wheel events, preventing the default scroll behavior.
  2. Calculating Scroll Amount: Determines how much to scroll based on the event.
  3. Animating the Scroll: Uses requestAnimationFrame to incrementally move the scroll position, creating a smooth effect.
  4. Dynamic Speed Adjustment: Adjusts scroll animation speed dynamically depending on the speed of the scroll and the desired smoothness.
  5. Stopping Scroll: Stops the animation when scrolling is no longer detected or the maximum animation duration is met.

Settings:

The script includes adjustable settings that you can modify in the script's code:

  • scrollSmoothness: Controls the animation smoothness. A value of 0 means the scroll will be very smooth and slow, 1 means the animation is going to be closer to the default speed. The best value is somewhere around 0.5.
  • scrollAcceleration: Controls how fast the scroll speed increases. Higher values cause a more aggressive acceleration, lower values less of an acceleration.
  • debugMode: Set to 1 to see console logs from the script; set to 0 to disable logging.
  • targetRefreshRate: Target animation refresh rate.
  • maxRefreshRate: Maximum refresh rate used for the animation.
  • minRefreshRate: Minimum refresh rate used for the animation.
  • animationDuration: Maximum duration (in milliseconds) for a scroll animation.
  • scrollThreshold: Minimum scroll distance required to trigger the smooth scrolling animation.
  • passiveEventListeners: If you want to use passive event listeners, set to true; false is the default value.

Installation:

  1. Install a UserScript manager (e.g., Tampermonkey, Violentmonkey).
  2. Copy the code for this script.
  3. In your UserScript manager, create a new script and paste the code.
  4. Save the script, and it will now automatically run on all websites.