7.2.0 • Published 9 years ago

angular-smooth-scrollbar v7.2.0

Weekly downloads
399
License
MIT
Repository
github
Last release
9 years ago

angular-smooth-scrollbar

npm npm npm Travis

smooth-scrollbar for angular projects.

Requirements

Angular 1.4+

Install

Via npm:

npm install angular-smooth-scrollbar --save

Or via bower:

bower install angular-smooth-scrollbar --save

Demo

http://idiotwu.github.io/angular-smooth-scrollbar/

Usage

  1. Include all dependencies in your page file:

    <link rel="stylesheet" href="smooth-scrollbar/dist/smooth-scrollbar.css">
    
    <script src="angular.js"></script>
    <script src="smooth-scrollbar/dist/smooth-scrollbar.js"></script>
    <script src="angular-smooth-scrollbar/dist/angular-smooth-scrollbar.js"></script>
  2. Add SmoothScrollbar as dependency to your angular app:

    angular.module('myApp', ['SmoothScrollbar']);
  3. Use it wherever you want:

    • As element:

      <scrollbar name="scrollbar_name">
          ...
      </scrollbar>
    • As attribute:

      <section scrollbar="scrollbar_name">
          ...
      </section>

Available Options

parametertypedefaultdescription
namestring@N/ANaming current scrollbar.
speednumber=1Scrolling speed scale.
dampingnumber=0.1Delta reduce damping, a float value between (0, 1), the lower the value is, the more smooth the scrolling will be.
thumbMinSizenumber=20Minimal size for scrollbar thumb.
syncCallbacksBooleanfalseExecute listeners in synchronous or asynchronous.
renderByPixelsboolean=trueRender scrolling by integer pixels, set to true to improve performance.
alwaysShowTracksboolean=falseKeep scrollbar tracks visible whether it's scrolling or not.
continuousScrollingboolean=|string='auto'Whether allow upper scrollable content to continue scrolling when current scrollbar reaches edge. When set to 'auto', it will be enabled on nested scrollbars, and disabled on first-class scrollbars.
overscrollEffectboolean=|string=falseExperimental overscroll effect, 'bounce' for iOS style effect and 'glow' for Android style effect. Be careful when you enable this feature!
overscrollEffectColorstring@'#87ceeb'Canvas paint color with 'glow' effect.
overscrollDampingNumber0.2The same as damping, but for overscrolling.

Confusing with the option field? Try edit tool here!

ScrollbarServiceProvider

You can configure default scrollbar behavior here:

angular.module('myApp', ['SmoothScrollbar'])
.config((ScrollbarServiceProvider) => {
    // set default scrollbar behavior
});

ScrollbarServiceProvider.setDefaultOptions( options )

Set default scrollbar options for your angular app.

ScrollbarService

By given scrollbar a name via attribute, you can access your scrollbar instances through ScrollbarService.

    <scrollbar name="myScrollbar">...</scrollbar>
app.controller('MyCtrl', (ScrollbarService) => {
    const myScrollbar = ScrollbarService.getInstance('myScrollbar');
    ...
});

ScrollbarService.generateName()

Return a timestamp string, this will be useful while trying naming scrollbars uniquely.

ScrollbarService.getInstance( name )

Get scrollbar instance by giving the name, and return a promise with instance.

ScrollbarService.destroyInstance( name )

Destroy scrollbar with the given name.

APIs

Documents

License

MIT.

7.2.0

9 years ago

7.1.0

9 years ago

7.0.0

9 years ago

6.4.0

9 years ago

6.3.0

9 years ago

6.2.0

9 years ago

6.1.0

9 years ago

6.0.0

9 years ago

5.6.1

9 years ago

5.6.0

9 years ago

5.5.0

9 years ago

5.3.0

9 years ago

5.2.1

9 years ago

5.2.0

9 years ago

5.0.2

9 years ago

5.0.1

9 years ago

5.0.0

9 years ago

4.2.0

9 years ago

4.1.1

9 years ago

4.1.0

9 years ago

4.0.0

9 years ago

3.0.0

9 years ago

2.3.1

9 years ago

2.3.0

9 years ago

2.2.2

9 years ago

2.2.1

9 years ago

2.2.0

9 years ago

2.1.0

9 years ago

2.0.1

10 years ago

2.0.0

10 years ago

1.0.2

10 years ago

1.0.0

10 years ago

0.4.1

10 years ago

0.4.0

10 years ago

0.3.9

10 years ago

0.3.8

10 years ago

0.3.7

10 years ago

0.3.4

10 years ago

0.3.3

10 years ago

0.3.2

10 years ago

0.3.1

10 years ago

0.3.0

10 years ago

0.2.5

10 years ago

0.2.4

10 years ago

0.2.3

10 years ago

0.2.2

10 years ago

0.2.1

10 years ago

0.2.0

10 years ago

0.1.6

10 years ago

0.1.5

10 years ago

0.1.4

10 years ago

0.1.3

10 years ago

0.1.2

10 years ago

0.1.1

10 years ago

0.0.15

10 years ago

0.0.14

10 years ago

0.0.13

10 years ago

0.0.12

10 years ago

0.0.11

10 years ago

0.0.10

10 years ago

0.0.9

10 years ago

0.0.8

10 years ago

0.0.6

10 years ago

0.0.5

10 years ago

0.0.4

10 years ago

0.1.0

10 years ago

0.0.3

10 years ago

0.0.2

10 years ago

0.0.1

10 years ago