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 | NavMetaAPI
RouteMeta
Metadata that describes a route.
| Prop | Type | Default |
|---|---|---|
id * The path segment for this route. | string | |
Nested routes. | RouteMeta[] | |
If true, the side nav item will be expanded on initial load. Does nothing if
the entry is a leaf node. | boolean | |
Used for grouping pages at the same level under a common section heading. | string | |
Order for the groups within this item's hierarchy. | string[] | |
If true, this route will not be shown in the side navigation or adjacent
routes' page links. | boolean | |
If true, the breadcrumbs will not render on this route. | boolean | |
If true, this page's contents will not be added to the search index. | boolean | |
If true, the page links will be hidden on this route. | boolean | |
If true, the side navigation will be hidden on this route. | boolean | |
If true, the table of contents be hidden on this route. | boolean | |
By default, pages with a RouteMeta are ordered before pages that are not
defined. Set this property to true to disable that behavior. | boolean | false |
If true, the route will be flagged as restricted. This flag does nothing
internally. You will need to handle this in your application. | boolean | |
This property is only available for top-level items. | never | |
This property is only available for top-level items. | never | |
Title for the page in the side nav. Takes precedence over title. | string | |
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. | string |
id
*
Type
stringDescription
The path segment for this route.
Type
RouteMeta[]
Description
Nested routes.
Type
booleanDescription
If
true, the side nav item will be expanded on initial load. Does nothing if
the entry is a leaf node.Type
stringDescription
Used for grouping pages at the same level under a common section heading.
Type
string[]
Description
Order for the groups within this item's hierarchy.
Type
booleanDescription
If true, this route will not be shown in the side navigation or adjacent
routes' page links.
Type
booleanDescription
If true, the breadcrumbs will not render on this route.
Type
booleanDescription
If true, this page's contents will not be added to the search index.
Type
booleanDescription
If true, the page links will be hidden on this route.
Type
booleanDescription
If true, the side navigation will be hidden on this route.
Type
booleanDescription
If true, the table of contents be hidden on this route.
Type
booleanDescription
By default, pages with a RouteMeta are ordered before pages that are not
defined. Set this property to
true to disable that behavior.Type
booleanDescription
If
true, the route will be flagged as restricted. This flag does nothing
internally. You will need to handle this in your application.Type
neverDescription
This property is only available for top-level items.
Type
neverDescription
This property is only available for top-level items.
Type
stringDescription
Title for the page in the side nav. Takes precedence over title.
Type
stringDescription
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).
Side nav item data.
| Prop | Type |
|---|---|
never | |
A label that describes a group of nav items. | string |
Render a horizontal separator. | boolean |
Type
neverType
stringDescription
A label that describes a group of nav items.
Type
booleanDescription
Render a horizontal separator.
Last updated on by Ryan Bower