Coder Social home page Coder Social logo

cyrilferte / animatescroll.js Goto Github PK

View Code? Open in Web Editor NEW

This project forked from rampatra/animatescroll.js

0.0 1.0 0.0 97 KB

A Simple jQuery Plugin for Animating Scroll

Home Page: http://plugins.compzets.com/animatescroll

License: Other

JavaScript 34.06% CSS 13.41% HTML 52.53%

animatescroll.js's Introduction

AnimateScroll

Gitter

A Simple jQuery Plugin for Animating the Scroll

Demo can be seen at http://plugins.compzets.com/animatescroll

What is it exactly?

AnimateScroll is a jQuery plugin which enables you to scroll to any part of the page in style by just calling the animatescroll() function with the id or classname of the element where you want to scroll to.

It gives power to the user with its various options to customize the style of scrolling, scroll speed and many more. Supports more than 30 unique Scrolling Styles.

Usage

You need two things for this plugin to work, one is "jQuery library" and the other animatescroll.js file.

Just include the animatescroll.js file after the "jQuery library" as shown in the code snippet below and you're done.

NOTE: The only dependency for this plugin to work is jQuery library.

<html>
    <head>
        <script src="//ajax.googleapis.com/ajax/libs/jquery/1.8.3/jquery.min.js"></script>
        <script src="animatescroll.js">
    </head>
    <body>
        <div id="section-1">This is the element where you want to scroll to<div>
        
        /*
         * You may call the function like this
         * (but better attach an event listener)
         */
        <a onclick="$('[jquery selector]').animatescroll([options]);">Go to Element</a>
    </body>
</html>

You can either download the files or install from Bower (package manager):

bower install animatescroll

NOTE: There are two js files, if you do not want the various easing effects, you can use the animatescroll.noeasing.js

Options

AnimateScroll has 6 options:

  1. easing
  2. scrollSpeed
  3. padding
  4. element
  5. onScrollStart
  6. onScrollEnd

####easing (default: easing)

This option defines the scrolling style. The various easing effects supported can be seen at www.easings.net (Accepts string only)

####scrollSpeed (default: 400)

Controls the scrolling speed, higher is the number slower is the scroll speed (Accepts only number)

####padding (default: 0)

Adjusts little ups and downs in scrolling. Suppose a small amount of padding is applied to a particular element due to which the scroll didn't end at the right position, so this option helps you to rectify (Accepts numbers only, can be negative)

####element (default: html, body)

Added in v1.0.5. The element in which you want this plugin to work. Default is "body". (Accepts any jQuery/CSS selector)

####onScrollStart

Added in v1.0.7. A function to be called before scrolling starts

####onScrollEnd

Added in v1.0.7. A function to be called after the scrolling ends completely with animations

To add an option:

$('[jquery selector]').animatescroll({
  <optionName> : <optionValue>
});

Easing Effects

This plugin supports more than 30 different styles of scrolling. The easing option lets you choose a particular style of scrolling according to your choice.

The different easing effects are:

swing, easeInQuad, easeOutQuad, easeInOutQuad, easeInCubic, easeOutCubic, easeInOutCubic, easeInQuart,
easeOutQuart, easeInOutQuart, easeInQuint, easeOutQuint, easeInOutQuint, easeInSine, easeOutSine, easeInOutSine,
easeInExpo, easeOutExpo, easeInOutExpo, easeInCirc, easeOutCirc, easeInOutCirc, easeInElastic, easeOutElastic,
easeInOutElastic, easeInBack, easeOutBack, easeInOutBack, easeInBounce, easeOutBounce, easeInOutBounce

About

My name is Ram Swaroop. I am an app developer and a tech aficionado from India. I make apps/plugins for mobile, web and computer. Have a look at some of them at ramswaroop.me.

This is my first jQuery Plugin and I hope you all like it. You are free to make more improvements to the code by sending a pull-request.

If my plugin helped you or unlikely for any issues tweet me @ramswarooppatra, will be happy to hear from you.

Sponsors

Proudly sponsored by BrowserStack.

animatescroll.js's People

Contributors

rampatra avatar ramswaroop avatar srph avatar gitter-badger avatar

Watchers

Cyril Ferte avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.