Skip to main content

Nav Containers

Nav containers let you place a styled list of links anywhere inside a section — as a sidebar, a horizontal bar, or a tabbed navigation strip.

Available types

ElementRenders asBootstrap class
nav-list:Vertical pill list.nav.flex-column.nav-pills
nav-bar:Horizontal pill bar.nav.nav-pills
nav-tabs:Horizontal tab strip (styling only, no JS).nav.nav-tabs

Syntax

Indent child link lines with 2 spaces or 1 tab under the container keyword.

nav-list:
Home -> /
Blog -> /blog
Contact -> /contact
nav-bar:
Home -> /
Blog -> /blog
Pricing -> /pricing
nav-tabs:
Overview -> /docs
API Reference -> /docs/api
Examples -> /docs/examples

Child item syntax

Two equivalent forms are accepted for each child line:

  • Bare link (preferred): Label -> /path
  • nav-item: alias: nav-item: Label -> /path

Both produce identical output. Choose whichever reads more naturally in context.

nav-list:
Home -> /
nav-item: Blog -> /blog

Placing nav containers in a layout

Nav containers are elements, so they can be used inside any section or column alongside other content.

/// section

col:
nav-list:
Overview -> /docs
Getting Started -> /docs/getting-started
API -> /docs/api

col:
h2: Documentation
p: Browse the guides on the left to get started.

Notes

  • nav-tabs: renders the Bootstrap tab styling only. It does not wire up JavaScript tab-switching behaviour. Use it for visual navigation where each tab is a real page link.
  • Active state is not automatically highlighted; apply custom CSS if you need to mark the current page.