• Demonstration:
  • Java API: Nav
  • JavaScript API: Nav
  • Style Guide:
CE
PE

Employment/Purpose

A container is used to display navitem, it should be placed inside a navbar.

Example

<navbar orient="vertical" width="200px">
    <navitem label="Home" iconSclass="z-icon-home" />
    <nav label="Get Started" iconSclass="z-icon-th-list" badgeText="3">
        <navitem label="Step One" />
        <navitem label="Step Two" />
        <navitem label="Step Three" />
    </nav>
    <navitem label="About" iconSclass="z-icon-flag" />
    <navitem label="Contact" iconSclass="z-icon-envelope"/>
</navbar>

Properties

Badge Text

This property set the badge text for the Nav,it is used to present more details of Nav. For example, a Nav with label “Get Started” contains three Navitem components. If we want to let user know how much items in the Nav without opening it, we can show the children numbers of current Nav by org.zkoss.zkmax.zul.Nav#setBadgeText(java.lang.String) API. The code snippets as shown below:

![](/zk_component_ref/images/ZKComRef_Nav_badgeText.png)
<nav label="Get Started" iconSclass="z-icon-th-list" badgeText="3">
    <navitem label="Step One" />
    <navitem label="Step Two" />
    <navitem label="Step Three" />
</nav>`</pre></div></td>
</tr>
</tbody>
</table>

# Supported Events

| Name | Event Type |
|---|---|
| `onOpen` | Event:
[org.zkoss.zk.ui.event.OpenEvent](https://www.zkoss.org/javadoc/latest/zk/org/zkoss/zk/ui/event/OpenEvent.html) Denotes user has
opened or closed a nav component. |

- Inherited Supported Events: [ LabelImageElement](/zk_component_ref/labelimageelement#Supported_Events)

# Supported Children

`*`[` Nav`](/zk_component_ref/nav)`, `[` Navitem`](/zk_component_ref/navitem)`,`[` Navseparator`](/zk_component_ref/navseparator)



# Version History



| Version | Date         | Content                                                                                    |
|---------|--------------|--------------------------------------------------------------------------------------------|
| 7.0.0   | August, 2013 | [Nav](http://www.zkoss.org/javadoc/latest/zk/org/zkoss/zkmax/zul/Nav.html) was introduced. |