3.0.13 • Published 2 years ago

navbar.js v3.0.13

Weekly downloads
17
License
MIT
Repository
github
Last release
2 years ago

Navbar.js - Modern Navigation Component

The mobile first menu navigation for today's modern web, developed with ES6+ JavaScript, TypeScript definitions and packed with lots of features.

NPM Version NPM Downloads jsDeliver

Demo

Download the package and check the demo folder, or check it online here.

Navbar.js Highlights

  • Mobile First Design
  • Accessibility Focus
  • ES6+ sources with TypeScript definitions and powerful build tools
  • SCSS sources with powerful mixins and advanced inheritance and automation functionality
  • very light footprint, 5kb in size when minified
  • 3 sets of positions top (main), left or right
  • provides a set of options for JavaScript initialization
  • DATA API allows you to automatically initiate without JS invocation
  • modern browsers supported and semi-modern alike with a special polyfill for IE10+ provided

How It Works

On mobile

  • uses the default events behavior, it requires some elements to click on
  • shows the <button class="navbar-toggle"> element for element visibility toggle
  • menu items have a <button class="subnav-toggle"> element that enables visibility of the submenus
  • makes use of the open-mobile class to toggle submenus via the click handler

On the desktop

  • hides mobile specific elements and changes event behavior to mouse hover
  • opens submenus on mouseenter, by adding open and open-position classes to the menu item, in rapid succession
  • hides submenus on mouseleave, by removing the above classes in a delayed succesion

On both mobile and desktop, Navbar.js allows for full keyboard navigation via the TAB and SPACE keys. In addition, directional arrows provide navigation on desktop with RTL support.

NPM

You can install this through NPM:

$ npm install navbar.js

Browser Usage

Download the latest package. unpack and inspect the contents. You need to copy the navbar.js and navbar.css or their minified variations to your app assets folders as follows. Link the required CSS in your document <head> tag

<link href="../assets/css/navbar.css" rel="stylesheet">

Link the required JS in your document <body> tag, though it should work in the <head> as well

<script src="../assets/js/navbar.js"></script>

Initiate the function for your elements at the end of your <body> tag

<script>
var myMenu = new Navbar('selector');
</script>

To use the DATA-API, you need to provide the data-function="navbar" attribute to your navbar, like so:

<nav class="navbar" data-function="navbar">
  <a href="#" title="App Name">Brand Name</a>
  <button class="navbar-toggle">
    <i class="menu-icon"></i>
  </button>
  <div>
    <ul class="nav">
      <li><a href="#">Link Title</a></li>
      <li><a href="#">Another Link Title</a></li>
    </ul>
  </div>
</nav>

Alternatively you can use only the menu itself and use the specific attribute:

<div class="sidebar">
  <ul class="nav" data-function="navbar">
    <li><a href="#">Link Title</a></li>
    <li><a href="#">Another Link</a></li>
  </ul>
</div>

Other initialization and markup options apply, explained in the demo.

ES6+

import Navbar from 'navbar.js'

let myNav = new Navbar('#myNav')

Node

// get and store it
var Navbar = require("navbar.js");

// initialize it
var myMenu = new Navbar('#myNav');

License

MIT License

3.0.9

2 years ago

3.0.12

2 years ago

3.0.4

2 years ago

3.0.13

2 years ago

3.0.3

2 years ago

3.0.10

2 years ago

3.0.11

2 years ago

3.0.8

2 years ago

3.0.7

2 years ago

3.0.6

2 years ago

3.0.5

2 years ago

3.0.2

2 years ago

3.0.1

2 years ago

3.0.0

2 years ago

2.1.9

3 years ago

2.1.8

3 years ago

2.1.7

3 years ago

2.1.6

3 years ago

2.1.4

3 years ago

2.1.5

3 years ago

2.1.3-alpha3

3 years ago

2.1.3-alpha4

3 years ago

2.1.3-alpha2

3 years ago

2.1.3-alpha1

3 years ago

2.1.2

3 years ago

2.1.1

3 years ago

2.1.0

4 years ago

2.0.8

4 years ago

2.0.7

4 years ago

2.0.6

4 years ago

2.0.5

4 years ago

2.0.3

4 years ago

2.0.2

4 years ago

2.0.0

4 years ago

1.0.7

7 years ago

1.0.6

7 years ago

1.0.5

7 years ago

1.0.4

8 years ago

1.0.3

8 years ago

1.0.2

8 years ago

1.0.1

8 years ago

1.0.0

8 years ago