A JavaScript library to make navigation menus highlight active item based on the scroll position.

Downloads in past


1.3.06 years ago7 years agoMinified + gzip package size for menuspy in KB


A JavaScript library to make navigation menus highlight the item based on currently in view section.
  • No dependencies
  • Easy to use
  • Lightweight and fast


Include MenuSpy
<script src="menuspy.js"></script>

MenuSpy will be available in the global scope.
Or install via NPM/Yarn and require as a module
npm install menuspy

var MenuSpy = require('menuspy');

Initialize the plugin on your menu element
<header id="main-header">
      <li><a href="#features">Features</a></li>
      <li><a href="#usage">Usage</a></li>
      <li><a href="#options">Options</a></li>
      <li><a href="#examples">Examples</a></li>

You can also use data-target on the anchor element with a selector. Example:
<a href="#anything" data-target="selector">Anything</a>

var elm = document.querySelector('#main-header');
var ms = new MenuSpy(elm);

The MenuSpy() constructor accepts two arguments: the container element and an options object.


| Option | Type | Default | Description | | ---------------------| -------- | -------------------------- | ------------------------------------------------------------------------ | | menuItemSelector | String | a[href^="#"] | Menu items selector. | | activeClass | String | active | Class applied on menu item relative to the currently visible section. | | threshold | Integer | 15 | Ammount of space between your menu and the next section to be activated. | | enableLocationHash | Boolean | true | Enable or disable browser's hash location change. | | hashTimeout | Integer | 600 | Timeout to apply browser's hash location. | | callback | Function | function(currentItem) {} | A function to be called every time a new menu item activates. |