How michalsnik/aos works
AOS is a browser-side, CSS-driven scroll-animation library. A page initializes it with options and data-aos elements; AOS discovers those elements, prepares per-element trigger positions, and responds to scrolling by applying animation classes and dispatching events. Resize and orientation changes recalculate positions, while DOM mutations can trigger a hard refresh. The README also documents per-element configuration, custom animations/easings, and integration with external CSS animation libraries. Relationships reflect the sampled source and README; Sass internals are represented by the documented styling entry point rather than inferred imports.
Main entry points: aos.js AOS API · prepare.js Element preparation · offsetCalculator.js Trigger positions · handleScroll.js Scroll handling
Components 11
Runtime orchestration
- AOS API
src/js/aos.js - Scroll handling
src/js/helpers/handleScroll.js - Device detection
src/js/helpers/detector.js - Mutation observer
src/js/libs/observer.js
Element preparation
- Element discovery
src/js/helpers/elements.js - Element preparation
src/js/helpers/prepare.js - Inline options
src/js/helpers/getInlineOption.js - Trigger positions
src/js/helpers/offsetCalculator.js - DOM offset
src/js/libs/offset.js
Animation styling
- Animation styles
src/sass/aos.scss
Other components
- Page integrator
Connections 14
- Page integrator → AOS API: initializes
README.md - Page integrator → AOS API: scrolls page
src/js/aos.js - AOS API → Element discovery: discovers elements
src/js/aos.js - AOS API → Element preparation: prepares elements
src/js/aos.js - AOS API → Scroll handling: handles scroll
src/js/aos.js - AOS API → Device detection: checks support
src/js/aos.js - AOS API → Mutation observer: registers watcher
src/js/aos.js - AOS API → Animation styles: imports styles
src/js/aos.js - Element preparation → Inline options: reads options
src/js/helpers/prepare.js - Element preparation → Trigger positions: calculates triggers
src/js/helpers/prepare.js - Trigger positions → Inline options: reads overrides
src/js/helpers/offsetCalculator.js - Trigger positions → DOM offset: measures elements
src/js/helpers/offsetCalculator.js - Scroll handling → Device detection: checks compatibility
src/js/helpers/handleScroll.js - Mutation observer → AOS API: requests hard refresh
src/js/aos.js