Skip to content

thednp/navbar

Repository files navigation

Navbar - Modern Navigation Component

Coverage Status ci NPM Version NPM Downloads jsDeliver typescript version vitest version vite version

The mobile first menu navigation for today's modern web, sourced with Typescript and packed with lots of features.

Demo

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

Navbar Highlights

  • Mobile First Design
  • Accessibility Focus
  • TypeScript sourced and powerful build tools
  • SCSS sources with flexible mixins and CSS variables
  • 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

How It Works

On mobile

  • uses the native 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.

Install

pnpm install -D @thednp/navbar
yarn add -D @thednp/navbar
npm install -D @thednp/navbar
deno add -D npm:@thednp/navbar@latest

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.

Typescript / ES

import Navbar from '@thednp/navbar'

const myNav = new Navbar('#myNav')

License

Navbar is released under MIT License.