MenuSpy

一个 JavaScript 库,用于使导航菜单根据当前视图部分突出显示项目。「A JavaScript library to make navigation menus highlight the item based on currently in view section.」

Github stars Tracking Chart

MenuSpy

A JavaScript library to make navigation menus highlight the item based on currently in view section.

  • No dependencies
  • Easy to use
  • Lightweight and fast

Usage

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

npm install menuspy

Yarn

yarn add menuspy
var MenuSpy = require('menuspy');

Initialize the plugin on your menu element

<header id="main-header">
  <nav>
    <ul>
      <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>
    </ul>
  </nav>
</header>

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.

Options, 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.

Overview

Name With Ownerlcdsantos/menuspy
Primary LanguageJavaScript
Program languageJavaScript (Language Count: 1)
Platform
License:MIT License
Release Count7
Last Release Name1.3.0 (Posted on )
First Release Name1.0.1 (Posted on )
Created At2016-09-25 05:18:20
Pushed At2021-06-07 12:19:23
Last Commit At2021-06-07 09:19:23
Stargazers Count301
Watchers Count9
Fork Count37
Commits Count39
Has Issues Enabled
Issues Count15
Issue Open Count9
Pull Requests Count4
Pull Requests Open Count0
Pull Requests Close Count1
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private
To the top