NavItem
Navigation item populates sidebar navigation with links. Every item should be placed inside a navigation group.
Properties
| Property | Attribute | Description | Type | Default |
|---|---|---|---|---|
active | active | Used for indicating the current page. This gives a prominent background to the nav item, and marks the item as the current page for assistive technology. | boolean | false |
icon | icon | The name of an icon from Nordicons to display for the nav item. | string | undefined | — |
href | href | The url the nav item should link to. Note: this is not used if you have nested navigation using the "subnav" slot. | string | undefined | — |
badge | badge | Allows you to add a notification badge with a number next to the nav item. | string | undefined | — |
open | open | When the nav items contains a subnav, controls whether the section is expanded or not. Note: this is only used if you have nested navigation using the "subnav" slot. | boolean | false |
Slots
| Slot name | Description |
|---|---|
Default slot | The default slot used for the nav item's text. |
subnav | Used for nesting navigation. When used the nav-item becomes a button to collapse the subnav, rather than a link. |
Methods
| Method name | Parameters | Description |
|---|---|---|
focus(options?: FocusOptions) => void | options: An object which controls aspects of the focusing process. | Programmatically move focus to the component. |
blur() => void | N/A | Programmatically remove focus from the component. |
click() => void | N/A | Programmatically simulates a click on the component. |
| Event | Detail Type | Description |
|---|---|---|
toggle | NordEvent | Dispatched whenever a nav item's state changes between open and closed. |
activate | NordEvent | Dispatched whenever a nav item has been marked as active |
This component has no CSS custom properties.
Usage
This section includes guidelines for designers and developers about the usage of this component in different contexts.
Do
- Group navigation items into navigation groups based on related categories.
- Use group headings to clarify the category of a section.
- Use icons for all top level navigation items.
Don’t
- Don’t use navigation item outside of navigation group and navigation components.
Content guidelines
When writing navigation item labels, always write them in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):
My tasks
My Tasks
Avoid unnecessary words and articles in item labels, such as “the”, “an” or “a”:
Change theme
Change the theme
Avoid ending item labels in punctuation:
Switch user
Switch user.
Use as few words as possible to describe each item label:
Payments
Payments in your clinic
Avoid all caps for item labels and group titles:
Dashboard
DASHBOARD
Integration
For integration guidelines, please see Web Components documentation .