@ngui/scrollable

Angular2 Scrollable Section Detection With Animation

Stats

stars 🌟issues ⚠️updated 🛠created 🐣size 🏋️‍♀️
178Dec 18, 2017Jun 30, 2016Minified + gzip package size for @ngui/scrollable in KB

Readme

scrollable

Angular2 Automatic Scroll Detection With Animation

IMPORTANT NOTICE

After 0.9.0 or higher, ng2-scrollable has been changed to @ngui/scrollable. Here are the changes;

  • Module ng2-scrollable is changed to @ngui/scrollable.
  • Direvtive ng2-scrollable is changed to ngui-scrollable.
  • Class name Ng2ScrollaleModule is changed to NguiScrollableModule.

Plunker Example: https://plnkr.co/edit/wLVudY?p=preview&open=app.component.ts

Install

  1. install @ngui/scrollable

     $ npm install @ngui/scrollable --save-dev
    
  2. add map and packages to your systemjs.config.js

     map['@ngui/scrollable'] = 'node_modules/@ngui/scrollable/dist/scrollable.umd.js';
    
  3. import NguiScrollableModule to your AppModule

     import { NguiScrollableModule } from '@ngui/scrollable';
     
     @NgModule({
       imports: [BrowserModule, FormsModule, NguiScrollableModule],
       declarations: [AppComponent],
       bootstrap: [ AppComponent ]
     })
     export class AppModule { }
    

Usage it in your code

    <ul>
      <li [class.current]="id=='s1'" (click)="scrollable.el.scrollTo('s1')">One
      <li [class.current]="id=='s2'" (click)="scrollable.el.scrollTo('s2')">Two
      <li [class.current]="id=='s3'" (click)="scrollable.el.scrollTo('s3')">Three
      <li [class.current]="id=='s4'" (click)="scrollable.el.scrollTo('s4')">Four
      <li [class.current]="id=='s5'" (click)="scrollable.el.scrollTo('s5')">Five
      <li [class.current]="id=='s6'" (click)="scrollable.el.scrollTo('s6')">Six
      <li [class.current]="id=='s7'" (click)="scrollable.el.scrollTo('s7')">Seven
      <li [class.current]="id=='s8'" (click)="scrollable.el.scrollTo('s8')">Eight
      <li [class.current]="id=='s9'" (click)="scrollable.el.scrollTo('s9')">Nine
    </ul>
    <div class="scrollable" (scrolledTo)="id=$event" ngui-scrollable>
      <div id="s1">One</div>
      <div id="s2">Two</div>
      <div id="s3">Three</div>
      <div id="s4">Four</div>
      <div id="s5">Five</div>
      <div id="s6">Six</div>
      <div id="s7">Seven</div>
      <div id="s8">Eight</div>
      <div id="s9">Nine</div>
    </div>

     

For full example, please check out test directory to see the example of;

  • systemjs.config.js
  • app.module.ts
  • and app.component.ts.

ng2-ui welcomes new members and contributors

This module is only improved and maintained by contributors like you.

As a contributor, it's NOT required to be skilled in Javascript nor Angular2. You are only to be open-minded and interested in helping others. As a contributor, you do following;

  • Updating README.md
  • Improving code comments
  • Answering issues and building FAQ
  • Documentation
  • Translation

In result of your active contribution, you will be listed as a core contributor on https://ng2-ui.github.io, and a member of ng2-ui too.

If you are interested in becoming a contributor and/or a member of ng-ui, please send me email to allenhwkim AT gmail.com with your github id.

LICENSE

MIT

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.