ng2-nice-smooth-scroll
v2.0.4
Published
A pure-javascript library and set of directives to scroll smoothly to an element with easing.
Downloads
8
Maintainers
Readme
Angular2 smooth scroll
base onAngular smooth scroll
A pure-javascript library and set of directives to scroll smoothly to an element with easing. Easing support contributed by Willem Liu with code from Gaëtan Renaudeau.
No jQuery required.
Just a wrapper with 2.0.0 version (https://github.com/kavil/ng2SmoothScroll)
Features
- Exposes a service that scrolls the window to an element's location
- Provides two directives that enable smooth scrolling to elements.
- Clean: No classes are added, no jQuery is required, no CSS files or configuration is needed.
- Scrolling within a custom container added in 2.0.0
Installation
// npm:
import { SmoothScrollToDirective, SmoothScrollDirective } from "ng2-nice-smooth-scroll";
...
declarations[
...
SmoothScrollToDirective,
SmoothScrollDirective,
...
]
Npm
Install with npm with:
npm install ng2-nice-smooth-scroll
Usage - As a directive
This module provides two directives:
smoothScroll:
Attribute. Scrolls the window to this element, optionally validating the expression inside scroll-if.
Example:
// Basic - The window will scroll to this element's position when compiling this directive
<div smoothScroll></div>
// With options
<div smoothScroll
[duration]="800"
[easing]="easeInQuint"
[offset]="120"
[middleAlign]="true"
[callbackBefore]="aFunction(element)"
[callbackAfter]="anotherFunction">
{{...}}
</div>
// Inside a custom container
<div smoothScroll
[duration]="800"
[easing]="easeInQuint"
[offset]="120"
[callbackBefore]="aFunction(element)"
[callbackAfter]="anotherFunction"
[containerId]="container-id">
{{...}}
</div>
// With condition
<div smoothScroll
[scrollIf]="myExpression">
{{...}}
</div>
// Inside ng-repeat
<div smoothScroll
[scrollIf]="myExpression"
[duration]="2500">
{{...}}
</div>
####scrollTo:
Attribute. Scrolls the window to the specified element ID when clicking this element.
Example:
// Basic
<a href="#"
[scrollTo]="'my-element-3'">
Click me!
</a>
// Custom containers
<a href="#"
[scrollTo]="'my-element-3'"
[containerId]="custom-container-id">
Click me!
</a>
// onClick for non-anchor tags
<div [scrollTo]="'my-element-3'"
[containerId]="custom-container-id">
Click me!
</div>
// With options
<button
[scrollTo]="'elem-id5'"
[duration]="1800"
[middleAlign]="true"
[callbackBefore]="aFunction(element)"
[callbackAfter]="anotherFunction">
Scroll to next page.
</button>
Options
duration
Type: Integer
Default: 800
The duration of the smooth scroll, in miliseconds.
offset
Type: Integer
Default: 0
The offset from the top of the page in which the scroll should stop.
easing
type: string
default: easeInOutQuart
the easing function to be used for this scroll.
middleAlign
type: boolean
default: false
Middle align the scrolled element
scrollOnClick
type: boolean
default: false
(smoothScroll directive only) Scroll to element when it is clicked
callbackBefore
type: function
default: function(element) {}
a callback function to run before the scroll has started. It is passed the element that will be scrolled to.
callbackAfter
type: function
default: function(element) {}
a callback function to run after the scroll has completed. It is passed the element that was scrolled to.
containerId
type: string
default: null
ID of the scrollable container which the element is a child of.
Easing functions
The available easing functions are:
- 'easeInQuad'
- 'easeOutQuad'
- 'easeInOutQuad'
- 'easeInCubic'
- 'easeOutCubic'
- 'easeInOutCubic'
- 'easeInQuart'
- 'easeOutQuart'
- 'easeInOutQuart'
- 'easeInQuint'
- 'easeOutQuint'
- 'easeInOutQuint'
Cheers.