ngsticky
v1.7.12
Published
A simple, pure javascript (No jQuery required!) AngularJS directive to make elements stick when scrolling down.
Downloads
25,214
Maintainers
Readme
Angular Sticky
A simple, pure javascript (No jQuery required!) AngularJS directive to make elements stick when scrolling down.
Features
- Allows use of an offset so elements can be stuck to eg. 50px from the top of the browser
- Recalculates element position on page load and on window resize
- Clean: No external CSS or jQuery required, and it only adds the classes you specify.
Bower
Install with bower:
bower install ngSticky
Usage
Include the .js file in your page then enable usage of the directive by including the "sticky" module as a dependency. Use the directive as follows:
<div sticky> Hey there! </div>
To toggle the element stickiness you can bind with scope using the disable-sticky (ng-model) as follows {{ disabled = true }}:
<div sticky disable-sticky="disabled"> I won't stick! </div>
<div sticky disable-sticky="!disabled"> I will stick! </div>
To make the element stick within a certain offset of the top of the screen, you can provide an offset as follows:
<div sticky offset="100"> I won't touch the top of your screen! </div>
If you want to customize the style while the element is sticky, we have an api for you too:
<div sticky offset="100" sticky-class="imSoSticky"> Taste my glue! </div>
And if you want to customize the body style while the element is sticky:
<div sticky offset="100" body-class="somethingIsSticky"> Taste my glue! </div>
In order to enable sticky based on a media query:
<div sticky media-query="min-width: 768px"> Won't be sticky on small screens! </div>
If you want the sticky element to be scrollable only if it's smaller then the window inner height then you can set the stick-limit
attribute:
<div sticky offset="100" stick-limit="true"> Will stick only if the element isn't bigger then the view</div>
And if you want to confine an element to its parent, and let it 'bottom out', just add the confine
attribute:
<div sticky offset="100" confine="true"> Will unstick and stick to bottom of parent element</div>
NOTE: The confine attribute will automagically assign its parent a
position: relative
style in order to help with absolute positioning relative to the parent.
Cheers.