wavescrollbar
TypeScript icon, indicating that this package has built-in type declarations

1.0.2 • Public • Published

Wavescrollbar Logo

🚀 Wavescrollbar 🌐 is a javascript library, which adds modern progress bar at the top.

NPM Version Package License NPM Downloads Coverage

🌍 Guia en español

🌐 Description

Wavescrollbar is a library to create a modern, efficient and scalable scroll bar. It uses modern JavaScript, is built with TypeScript (retains compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming).

Under the hood, Wavescrollbar uses javascript, but also provides compatibility with a wide range of other libraries, such as p. Eg ReactJs, Vuejs, Angular, which allows easy use of the countless third-party add-ons that are available.

📝 Philosophy

Wavescrollbar aims to provide a ready-to-use application architecture that allows effortless creation of applications with progress bar at the top, and highly verifiable, scalable, poorly coupled and easy to maintain.

📦 Installation

To start using Wavescrollbar you need to install it with the package manager npm or yarn, as shown in the next section or download it directly!

// To install using npm
npm install wavescrollbar -S
 
// Para instalar mediante yarn
yarn add wavescrollbar

▶️ Getting started

HTML

<!DOCTYPE html>
<html lang="en">
<head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <meta http-equiv="X-UA-Compatible" content="ie=edge">
   <title>Wavescrollbar</title>
   <link rel="stylesheet" href="css/wavescrollbar.css">
</head>
<body>
   <wavescrollbar>
   </wavescrollbar>
 
   <script src="js/wavescrollbar.js"></script> 
   <script>
      var wavescrollbar = new Wavescrollbar()
   </script> 
</body>
</html>

Add the javascript and css file to make it work properly!

<!-- Import the CSS file -->
<link rel="stylesheet" href="css/wavescrollbar.css">
 
<!-- Import the javascript file -->
<script src="js/wavescrollbar.js"></script>

📝 Features

Method Parameter
1 setAnimation None
2 setContainerBackground color
3 setGradient options
4 setBackground color
5 setTransition options
6 setHeight value

📚 Method setAnimation

Example:

// We instantiate the animation method
wavescrollbar.setAnimation() //It does not need parameters.

📚 Method setContainerBackground

Example:

/**
 * @param color
 * */
// 
// Default-> #eeeeee
const color = "#eafbea"
wavescrollbar.setContainerBackground(color)

📚 Method setGradient

Example:

/**
 * @param options: object
 * */
 
const options = {
   // default-> 90deg
   angle: "45deg", // 0deg - 360deg
   // Default-> ["#11998e", "#38ef7d"]
   colors: [
      "#11998e",
      "#38ef7d",
      "red",
      "blue"
   ]
}
wavescrollbar.setGradient(options)

📚 Method setBackground

Example:

/**
 * @param color
 * */
// Default-> pink
const color = "red"
wavescrollbar.setBackground(color)

📚 Method setTransition

Example:

/**
 * @param options
 * */
 
const options = {
   // Default-> .2s
   duration: "100ms",
   // Default-> 0s
   delay: '0s',
   // Default-> linear
   timing: "ease-in-out" // "linear" | "ease" | "ease-in" | "ease-in-out" | "ease-out"
}
wavescrollbar.setTransition(options)

📚 Method setHeight

Example:

/**
 * @param value
 * */
// Default-> 5px
const height = "10px"
wavescrollbar.setHeight(height)

⭐ Support for

Wavescrollbar is an open source project licensed by MIT. You can grow thanks to the sponsors and the support of the amazing sponsors. If you want to join them, contact me here.

🎩 Contributors

Yoni Stack Yoni Stack

🎩 Stay in touch

📜 License

Wavescrollbar is MIT licensed.

Package Sidebar

Install

npm i wavescrollbar

Weekly Downloads

0

Version

1.0.2

License

MIT

Unpacked Size

65.7 kB

Total Files

16

Last publish

Collaborators

  • yonicb