KingSora/OverlayScrollbars
OverlayScrollbars
OverlayScrollbars es un plugin de scrollbar en JavaScript y un gestor de scroll de elementos DOM que reemplaza las barras de desplazamiento nativas del navegador con versiones superpuestas personalizables. Funciona como un componente de UI para dar estilo a las pistas y manejadores de las barras de desplazamiento mientras preserva el comportamiento de scroll original y la accesibilidad.
El proyecto asegura la consistencia de la UI entre navegadores al sobrescribir las implementaciones nativas con barras de desplazamiento web personalizadas. Utiliza un sistema de propiedades personalizadas CSS y temas predefinidos para permitir que la apariencia visual de las barras de desplazamiento coincida con diseños de sitios web específicos.
La librería incluye una interfaz programática para controlar los diseños de las barras de desplazamiento y los modos de rendimiento por elemento. Cuenta con una arquitectura de plugins para añadir comportamientos personalizados o polyfills de compatibilidad y proporciona herramientas para el recálculo manual del diseño cuando los tamaños de los elementos o el contenido cambian.
Features
- Scrollbar Components - Replaces native browser scrollbars with fully styleable overlay components that maintain accessibility.
- Cross-Browser UI Components - Ensures a consistent visual appearance and behavior of scrollbars across different web browsers.
- Native Scrollbar Hiding - Wraps elements in containers to hide native browser scrollbars while preserving original overflow behavior.
- Scroll-Handle Synchronization - Synchronizes the visual position of custom scroll handles with the underlying native scroll offset.
- Plugin-Based Extensibility - Implements a plugin system to inject optional behaviors and optimize bundle size via tree-shaking.
- Layout Recalculation Triggers - Provides methods to manually trigger layout updates for scrollbars when element dimensions or content change.
- Scroll Instance Managers - Provides a programmatic interface to control scrollbar layouts and performance modes on a per-element basis.
- Scrollbars - Provides a comprehensive system for customizing scrollbar aesthetics using themes and CSS variables.
- CSS Variable Styling Systems - Provides a system for customizing scrollbar tracks and handles using native CSS variables.
- UI Component Styling - Allows detailed visual customization of scrollbar tracks and handles using CSS properties.
- Independent Instance Management - Supports multiple isolated scrollbar instances with distinct configurations across different DOM containers.
- Programmatic Scroll Management - Provides programmatic control over scrollbar behavior and layout updates within web applications.
