ionic-scroller
v0.0.4
Published
Angular and IonicFramework extension to scroll-top, -bottom, -to, -anchor
Downloads
9
Maintainers
Readme
ionicScroller
ionicScroller is an Angular.js and Ionic Framework extension for simple scroll-top, -bottom, -to functionality.
Installation
- run
bower install ionic-scroller
- or run
npm install ionic-scroller
- or download zip from release page: https://github.com/KillerCodeMonkey/ionicScroller/releases
Usage
- load ionic, ionic-scroller scripts in your index.html
- add dependency to your app module
var myAppModule = angular.module('ionicScrollerTest', ['ionic', 'ionicScroller']);
- use directives in your html --> ion-scroller-top, ion-scroller-bottom, ion-scroller-to, ion-scroller-anchor
<ion-scroller-top css-class="button button-assertive" offset="20" text="UP!" scroll-delegate="delegateHandle" animate="true"></ion-scroller-top>
- the generated buttons are hidden on shown with ng-show/ng-hide, so you can animate showing and hiding of the buttons through css as well ;)
- add class with absolute position to move button over your list ;)
Configuration
ion-scroller-top and ion-scroller-bottom
- change button text:
text="YOUR TEXT OR EMPTY"
(default: Top / Bottom) - animate scrolling:
animate="true"
(default false) - auto-hide at offset:
offset="10"
(ion-scroller-bottom: hides button if scroll position top >= offset, default: -1; ion-scroller-top: hides button if scroll position top <= offset, default: -1; offset="-1": does not hide the button) - connect to delegateHandle:
scroll-delegate="delegateHandle"
(default, the main delegateHandle like ion-content) - style through class or ng-class expression:
css-class="button button-assertive"
(wraps up in ng-class, default: 'button button-dark')
ion-scroller-to
- change button text:
text="YOUR TEXT OR EMPTY"
(default: GoTo) - animate scrolling:
animate="true"
(default false) - left, top:
left="10" top="50"
(target scroll position, required) - connect to delegateHandle:
scroll-delegate="delegateHandle"
(default, the main delegateHandle like ion-content) - style through class or ng-class expression:
css-class="button button-assertive"
(wraps up in ng-class, default: 'button button-dark')
ion-scroller-anchor
- change button text:
text="YOUR TEXT OR EMPTY"
(default: GoTo) - animate scrolling:
animate="true"
(default false) - anchor:
anchor="domNodeId"
(target node-id, required) - connect to delegateHandle:
scroll-delegate="delegateHandle"
(default, the main delegateHandle like ion-content) - style through class or ng-class expression:
css-class="button button-assertive"
(wraps up in ng-class, default: 'button button-dark')