Nav GroupReady

Navigation group includes all the actions or items in a single group and is used for grouping items into related categories.

Open in new window

View RTL

<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>

<nord-navigation>
  <nord-nav-group style="max-inline-size: 220px">
    <nord-nav-item href="#">Dashboard</nord-nav-item>

    <nord-nav-item icon="navigation-reports">
      Reports
      <nord-nav-group slot="subnav">
        <nord-nav-item href="#">Payments</nord-nav-item>
        <nord-nav-item href="#" active>Disputes</nord-nav-item>
      </nord-nav-group>
    </nord-nav-item>
  </nord-nav-group>
</nord-navigation>

<nord-nav-group heading="Workspace" style="max-inline-size: 220px">
  <nord-nav-item href="#" active icon="navigation-dashboard">Dashboard</nord-nav-item>
  <nord-nav-item href="#" icon="navigation-payments">Payments</nord-nav-item>
  <nord-nav-item href="#" icon="navigation-reports">Reports</nord-nav-item>
  <nord-nav-item href="#" icon="navigation-settings">Settings</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`

Slots

Slot name	Description
Default slot	The default slot used for the nav items.

Dependencies

This component is internally dependent on the following components:

Icon
Icons are used to provide additional meaning or in places where text label doesn’t fit. Icon component allows you to display an icon from the Nordicons library.

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):

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. This documentation explains how to implement and use Nord Web Components across different technologies such as Vue.js, React, or Vanilla JavaScript.

Integration Guidelines

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.