React UI Components Documentation

ReactJS NavigationBar Component

The NavigationBar component for ReactJS is a versatile component for building collapsible side-menu systems. It has header and content sections(like tabs).

Prerequisites

Refer to ReactJS Getting Started before you start with this help topic.

Configuration

The NavigationBar component for ReactJS requires the following imports.

 
import React from 'react';
import ReactDOM from 'react-dom';
import JqxNavigationBar from 'jqwidgets-react/react_jqxnavigationbar.js';

Then we create our component class. Properties and methods are put as ReactJS props.

  
class App extends React.Component {
render () {
return (
<JqxNavigationBar width={440} height={440}>
<div>
Early History of the Internet
</div>
<div>
<ul>
<li>1961 First packet-switching papers</li>
<li>1966 Merit Network founded</li>
<li>1966 ARPANET planning starts</li>
<li>1969 ARPANET carries its first packets</li>
<li>1970 Mark I network at NPL (UK)</li>
</ul>
</div>
<div>
Merging the networks and creating the Internet
</div>
<div>
<ul>
<li>1981 Computer Science Network (CSNET)</li>
<li>1982 TCP/IP protocol suite formalized</li>
<li>1982 Simple Mail Transfer Protocol (SMTP)</li>
<li>1983 Domain Name System (DNS)</li>
</ul>
</div>
</JqxNavigationBar>
)
}
}

Finally we render our class in the desired HTML element:

 
ReactDOM.render(<App />, document.getElementById('app'));

Events Methods & Properties

In order to bind to any event, change any property or call any method, we need a reference to the component.
For that we use the ReactJS "ref" Callback Attribute:

 
<JqxNavigationBar ref='myNavigationBar' width={440} height={440}..... />

Now, when we have a reference, we need to call the desired event/property/method.
This is done in the componentDidMount() ReactJS Component Lifecycle method.

 
class App extends React.Component {
componentDidMount()
{
//your logic
}
render ()
{
return
(
....
)
}
};

Events

The collapsingItem event is triggered when a NavigationBar item is going to be collapsed.

The following example demonstrates how to add an event listener:

 
componentDidMount ()
{
this.refs.myNavigationBar.on('collapsingItem', (event) =>
{
//your logic
});
}

Methods & Properties

This is how you call methods & props:

Every component have a method setOptions which accepts a object as an argument. This object contains component settings.

Every component also have a method getOptions which returns a object containing the component settings.

NavigationBar Examples

Overview

The following example demonstrates how to create a NavigationBar component.

Multiple Items

The following example demonstrates how multiple items can be expanded.

NavigationBar API

API Reference of the jQWidgets NavigationBar component for React: NavigationBar API