NavConfig
Page data is defined in the config's navConfig field. Properties for this field are documented here.
WARNING
Several of these properties overlap with properties on the page's Frontmatter. Properties defined on the NavConfig take precedence over properties defined on each page's Frontmatter.
The NavConfig
type is a union of two types:
export type NavConfig = RouteMeta | NavMeta
API
RouteMeta
Metadata that describes a route.
Name & Description | Option(s) | Default |
---|---|---|
id * The path segment for this route. |
| |
Nested routes. | RouteMeta[] | |
If true , the side nav item will be expanded on initial load. Does nothing if
the entry is a leaf node. |
| |
If true, this route will not be shown in the side navigation or adjacent
routes' page links. |
| |
If true, the breadcrumbs will not render on this route. |
| |
If true, this page's contents will not be added to the search index. |
| |
If true, the page links will be hidden on this route. |
| |
If true, the side navigation will be hidden on this route. |
| |
If true, the table of contents be hidden on this route. |
| |
By default, pages with a RouteMeta are ordered before pages that are not
defined. Set this property to true to disable that behavior. |
| false |
If true , the route will be flagged as restricted. This flag does nothing
internally. You will need to handle this in your application. |
| |
Title for the page in the side nav. Takes precedence over title. |
| |
The title of the item in the side nav. Will be parsed from the page's
frontmatter if it is not defined in the RouteMeta. |
|
id
*
Type
string
Description
The path segment for this route.
Type
RouteMeta[]
Description
Nested routes.
Type
boolean
Description
If
true
, the side nav item will be expanded on initial load. Does nothing if
the entry is a leaf node.Type
boolean
Description
If true, this route will not be shown in the side navigation or adjacent
routes' page links.
Type
boolean
Description
If true, the breadcrumbs will not render on this route.
Type
boolean
Description
If true, this page's contents will not be added to the search index.
Type
boolean
Description
If true, the page links will be hidden on this route.
Type
boolean
Description
If true, the side navigation will be hidden on this route.
Type
boolean
Description
If true, the table of contents be hidden on this route.
Type
boolean
Default
false
Description
By default, pages with a RouteMeta are ordered before pages that are not
defined. Set this property to
true
to disable that behavior.Type
boolean
Description
If
true
, the route will be flagged as restricted. This flag does nothing
internally. You will need to handle this in your application.Type
string
Description
Title for the page in the side nav. Takes precedence over title.
Type
string
Description
The title of the item in the side nav. Will be parsed from the page's
frontmatter if it is not defined in the RouteMeta.
NavMeta
Metadata describing a nav item without an associated route. These entries are used to render separators or section titles between other nav items.
Note that this is currently limited to top-level nav items (not supported in children).
Name & Description | Option(s) | Default |
---|---|---|
A label that describes a group of nav items. |
| |
Render a horizontal separator. |
|
Type
string
Description
A label that describes a group of nav items.
Type
boolean
Description
Render a horizontal separator.