ngx-scroll-class
v1.2.2
Published
An Angular directive for spy on elements whether they were scrolled into(out) the screen, and append classes.
Downloads
14
Maintainers
Readme
NgxScrollClass
The scroll spy on html elements for Angular 4.
See live demo on: https://laxersnine.github.io/ngx-scroll-class/
Using
Install the npm module:
npm i ngx-scroll-class --save
Import ScrollClassModule on the module that you want to use the directive.
import { ScrollClassModule } from 'ngx-scroll-class';
@ngModule({
imports: [ScrollClassModule]
})
- Use
scrollClass
directive to spy on any element inwindow
.
<img name="elementToSpy" src="" alt="" scrollClass inScreenClassName="animated shake"/>
- Or use
scrollContainer
directive so that you can spy on elements in a scrollable container like<div>
<div scrollContainer="container">
<img name="elementToSpy" src="" alt="" scrollClass inScreenClassName="animated shake" containerName="container"/>
</div>
Then the animated shake
will be appended to img class when the image appears on the screen by scroll.
API
ScrollContainerDirective
Input
scrollContainer
: The container name which to make ScrollClassDirective understand who it belongs to.
ScrollClassDirective
Input
inScreenClassName
: Classes to be added when the element is scrolled into the screen. The default value is empty.outScreenClassName
: Classes to be added when the element is scrolled out of the screen. The default value is empty.containerName
: The container to observe. This is for the cases that the element is in a scrollable container likediv
, instead ofwindow
. The default value would be domwindow
object.repeatAnimate
: Append class to the element each time to scroll into(out) or just once.
Output
scrollIn
: Be fired when the element is scrolled to the view. The directive emits the element itself.
Example
Download the source code in this repo, run ng serve
and navigate to http://localhost:4200/
.
Development server
Run ng serve
for a dev server. Navigate to http://localhost:4200/
. The app will automatically reload if you change any of the source files.