The mobile first menu navigation for today's modern web, sourced with Typescript and packed with lots of features.
Download the package and check the docs folder, or check it online here.
- 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
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 theclick
handler
On the desktop
- hides mobile specific elements and changes event behavior to mouse hover
- opens submenus on
mouseenter
, by addingopen
andopen-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.
pnpm install -D @thednp/navbar
yarn add -D @thednp/navbar
npm install -D @thednp/navbar
deno add -D npm:@thednp/navbar@latest
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.
import Navbar from '@thednp/navbar'
const myNav = new Navbar('#myNav')
Navbar is released under MIT License.