KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #ai-agent #cli #claude-code #open-source #deepseek-harness #dsh-plugin #python #mcp

naviboard

★ 66 Open GitHub ↗

A javascript library for handling navigation on web application and feature phone applications.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# naviboard JS

[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
[![Travis](https://img.shields.io/travis/amanboss9/naviboard.svg)](https://travis-ci.org/amanboss9/naviboard.svg?branch=master)
[ ![NPM Version](http://img.shields.io/npm/v/naviboard.svg?style=flat) ](https://www.npmjs.com/package/naviboard)
[ ![Downloads This Week](http://img.shields.io/npm/dm/naviboard.svg?style=flat) ](https://www.npmjs.com/package/naviboard)
[ ![License](http://img.shields.io/npm/l/naviboard.svg?style=flat) ](https://www.npmjs.com/package/naviboard)
[![](https://data.jsdelivr.com/v1/package/npm/naviboard/badge)](https://www.jsdelivr.com/package/npm/naviboard)
[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)

Naviboard is a library for navigation with the help of keyboard/keypad in the feature phone web applications(e.g kaiOS applications). This library helps developer to think about logic rather than thinking about handling navigation in their web page by simple API's. Developers working on feature phones which need navigation support from keypad to browse in their native application will surely be benefited with this small javascipt library.It auto generates a navigation schema based on desired navigation according to design.

Naviboard is available as a NPM module for use with node.js. If you don't use node to install the library then you can simply include naviboard.js or naviboard.min.js from the dist folder in this repo. These files are UMD wrapped so they can be used with or without a module loader such as requireJS.

```
 npm install naviboard
```

### Steps to setup: 
- Developer can include it directly or by CDN link in `index.html` like below:

```html
<script src="https://cdn.jsdelivr.net/npm/naviboard@latest-version/dist/naviboard.min.js"></script>
```
- Please check the latest stable version available in the release list.

- After installing/including in `index.html` naviBoard will be available globally.Its ready to use like below:

Whenever the component(Angular, React etc) or the web page is initiating the loading, considering below as the first step:
Give class `navigable` to the elements which require navigation under a parent component.

```html
<div class="wrapper" id='ParentElementID'>
    <div class="box a navigable">A</div>
    <div class="box b navigable">B</div>
    <div class="box c navigable">C</div>
    <div class="box d navigable">D</div>
    <div class="box e navigable">E</div>
</div>
```
Now give id as arguement to the API `setNavigation` eg. ParentElementID in above case.

```javascript
 naviBoard.setNavigation('ParentElementID')
```
- <p data-height="265" data-theme-id="light" data-slug-hash="ZRdZxQ" data-default-tab="html,result" data-user="amanboss9" data-embed-version="2" data-pen-title="exampleNavigation" class="codepen">See the Pen <a href="https://codepen.io/amanboss9/pen/ZRdZxQ/">exampleNavigation</a> by Aman Sharma (<a href="https://codepen.io/amanboss9">@amanboss9</a>) on <a href="https://codepen.io">CodePen</a>.</p>

- <p data-height="277" data-theme-id="0" data-slug-hash="zLYwaZ" data-default-tab="js,result" data-user="amanboss9" data-pen-title="Spatial-Navigation Naviboard" class="codepen">See the Pen <a href="https://codepen.io/amanboss9/pen/zLYwaZ/">Spatial-Navigation Naviboard</a> by Aman Sharma (<a href="https://codepen.io/amanboss9">@amanboss9</a>) on <a href="https://codepen.io">CodePen</a>.</p>

Go to the below link for proper understanding of other API's

- https://jsfiddle.net/amanboss9/zv5hocxq/2/embedded/result

Yippie!!
All set to navigate through the elements.

Now when we want to navigate other page or component, we need to destroy the previous component and set the new one for navigation. Its advisable to use destroy method associated with the component like `componentWillUnmount()` in react or `this.$onDestroy` in angular v1.6.

```javascript
 naviBoard.destroyNavigation('ParentElementID')
```
### Other API's:

Whenever the client is getting refreshed(some new DOM element insertion or deletion) we need to handle it with updated navigation schema and for this we use `refreshNavigation` API.

e.g if a new component has been added in run time we need to update our library for taking care of the newly added element or removed element.

```javascript
 naviBoard.refreshNavigation('ParentElementID',status)
```

status could be update ,destroy and refresh depending upon the change in navigation required in application.

- There is one more API for getting the current focused element by navigation. "By navigation" explicitly means that if focus is been hindered by other thing we might lose track of the desired navigation.

Current active element can be used to attach events. Like one can attach `click` event on element and can use `ng-click` on top of that.

```javascript
 naviBoard.getActiveElement()
```

- You can attach event according to component currently having the access for navigation by getting the current rendered component and can map it to different event.

```javascript
 naviBoard.getNavigationComponent()
``` 
- User can pause the navigation in between as well. For Ex: If a rest call is happening and before the response if user wants to pause the navigation and after response if user wants to again resume navigation, he can by using the below API's.

```javascript
 naviBoard.pauseNavigation()
```

```javascript
 naviBoard.resumeNavigation()
```

Happy Coding!!!

> Use **naviboard** and suggest changes or modifications required as its a small step for *developers* to save their time in order to navigate in feature phone/banana phones applications instead writing lot of extra lines.

naviboard

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README