mciastek/sal
Sal
Sal is a lightweight vanilla JavaScript library designed to trigger CSS animations and execute custom logic as elements enter the browser viewport. It serves as a programmatic wrapper for the Intersection Observer API, providing a viewport trigger system to handle visibility thresholds and scroll-based animations.
The library operates as a dependency-free frontend tool that manages animations through a class-based trigger mechanism and the injection of CSS custom properties. It includes a system for tracking dynamic content, allowing the observer to be updated to include new elements injected into the document at runtime.
The project covers viewport visibility tracking and animation playback control, enabling the definition of visibility thresholds and the execution of events when elements enter or exit the visible screen area.
Features
- Scroll-Triggered Animations - Activates CSS animations when elements enter the viewport using configurable durations and easing.
- Visibility Event Hooks - Dispatches custom events when elements enter or exit the viewport to allow external logic integration.
- Viewport Transition Handlers - Executes CSS transitions and custom logic based on element visibility thresholds in the viewport.
- DOM Element Re-scanning - Refreshes the monitored target list at runtime to include newly injected DOM elements.
- Element Visibility Detection - Executes custom JavaScript logic or events when specific page elements enter or exit the visible screen.
- Class-Based Animation Triggers - Initiates predefined stylesheet transitions by toggling specific CSS classes on elements.
- Viewport Visibility Observers - Executes custom logic when animated elements enter or exit the visible screen area.
- Dynamic Element Observation - Detects and tracks new elements added to the DOM asynchronously to apply scroll animations.
- Intersection Observer Wrappers - Provides a programmatic wrapper for the Intersection Observer API to handle visibility thresholds.
- Scroll Trigger Libraries - A lightweight vanilla JavaScript library that triggers CSS animations upon viewport entry.
- CSS Variable Animators - Controls animation timing and easing by dynamically updating CSS custom properties on target elements.
- Animation Playback Controls - Provides controls to determine if animations play once or repeat upon each viewport entry.
- Animation State Tracking - Tracks playback status and iteration counts for individual animation instances during scrolling.
- Dynamic Content Animation Tools - Adds animation observers to new elements injected into the DOM without reloading the page.
- Visibility Trigger Configurators - Defines the percentage of an element's area or root margin required to trigger animations.
- Dependency-Free Frontend Libraries - Provides a dependency-free, small-footprint utility for adding scroll-triggered visual effects.
- Scroll-Based Animations - Performance-focused, lightweight scroll animation library.
