Nav GroupReady
Navigation group includes all the actions or items in a single group and is used for grouping items into related categories.
<nord-nav-group style="max-inline-size: 220px">
<nord-nav-item href="#" icon="navigation-search">Search</nord-nav-item>
<nord-nav-item href="#" icon="navigation-notifications">Notifications</nord-nav-item>
<nord-nav-item href="#" icon="navigation-tasks">My tasks</nord-nav-item>
</nord-nav-group>
Properties
Property | Attribute | Description | Type | Default |
---|---|---|---|---|
heading | heading | Heading and accessible label for the nav group | string | undefined | undefined |
Events
Event | Description | Type |
---|---|---|
toggle | Dispatched whenever a nav item's state changes between open and closed. | NordEvent |
activate | Dispatched whenever a nav item has been marked as active | NordEvent |
Slots
Slot name | Description |
---|---|
Default slot | The default slot used for the nav items. |
Dependencies
This component is internally dependent on the following components:
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 for grouping other types of content.
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):
Avoid unnecessary words and articles in item labels, such as “the”, “an” or “a”:
Avoid ending item labels in punctuation:
Use as few words as possible to describe each item label:
Avoid all caps for item labels and group titles:
Integration
For integration guidelines, please see Web Components documentation. This documentation explains how to implement and use Nord Web Components across different technologies such as Vue.js, React, or Vanilla JavaScript.
Troubleshooting
If you experience any issues while using Nord Web Components, please head over to the Support page for more guidelines and ways to contact us.