Material Admin
Scrollspy
Scrollspy
Scrollspy is a jQuery plugin that tracks certain elements and which element the user's screen is currently centered on. Our main demo of this is our table of contents on every documentation page to the right. Clicking on these links will also scroll the page to that element.
<div class="row">
<div class="col s12 m9 l10">
<div id="introduction" class="section scrollspy">
<p>Content </p>
</div>
<div id="structure" class="section scrollspy">
<p>Content </p>
</div>
<div id="initialization" class="section scrollspy">
<p>Content </p>
</div>
</div>
<div class="col hide-on-small-only m3 l2">
<ul class="section table-of-contents">
<li><a href="#introduction">Introduction</a></li>
<li><a href="#structure">Structure</a></li>
<li><a href="#initialization">Intialization</a></li>
</ul>
</div>
</div>
Initialization
var elem = document.querySelector('.scrollspy');
var instance = M.ScrollSpy.init(elem, options);
// Or with jQuery
$(document).ready(function(){
$('.scrollspy').scrollSpy();
});
Options
Name | Type | Default | Description |
---|---|---|---|
throttle | Number | 100 | Throttle of scroll handler. |
scrollOffset | Number | 200 | Offset for centering element when scrolled to. |
activeClass | String | 'active' | Class applied to active elements. |
getActiveElement | Function | Used to find active element. |
Methods
Because jQuery is no longer a dependency, all the methods are called on the plugin instance. You can get the plugin instance like this:
var instance = M.ScrollSpy.getInstance(elem);
/* jQuery Method Calls
You can still use the old jQuery plugin method calls.
But you won't be able to access instance properties.
$('.scrollspy').scrollSpy('methodName');
*/
.destroy();
Destroy plugin instance and teardown
instance.destroy();
Properties
Name | Type | Description |
---|---|---|
el | Element | The DOM element the plugin was initialized with. |
options | Object | The options the instance was initialized with. |