Cerulean Sea Navigation is a lightweight, dependency-free library designed to enhance your website's scrolling and animation experiences. Leveraging the popular smooth-scroll and aos libraries, it offers an easy-to-use interface for smooth scrolling and on-scroll animations with minimal setup.
- Smooth scrolling to anchor links with customizable speed.
- On-scroll animations with AOS (Animate On Scroll) for any element, configurable with options such as duration and once-only animations.
You can install cerulean-sea-navigation via npm:
npm install cerulean-sea-navigationOr, if you prefer, yarn:
yarn add cerulean-sea-navigationFirst, import cerulean-sea-navigation in your JavaScript module:
import CeruleanSeaNavigation from 'cerulean-sea-navigation';Then, initialize it:
new CeruleanSeaNavigation();This sets up both the smooth scroll and AOS functionalities with default settings.
CeruleanSeaNavigation works out of the box with sensible defaults, but both smooth scrolling and AOS can be customized further if needed.
To adjust smooth scroll settings, modify the initSmoothScroll method in CeruleanSeaNavigation:
initSmoothScroll() {
new SmoothScroll('a[href*="#"]', {
speed: 500, // Adjust scrolling speed (in ms)
speedAsDuration: true // Use speed as duration rather than a velocity
});
}Similarly, to customize AOS settings, adjust the initAOS method:
initAOS() {
AOS.init({
duration: 1000, // Control animation duration
once: false, // Repeat animations on scroll
});
}We welcome contributions to cerulean-sea-navigation! Whether it's bug reports, feature requests, or contributions to the code, please feel free to reach out or submit a pull request.
This project is licensed under the MIT License - see the LICENSE file for details.