diff --git a/navigation/divisions.mdx b/navigation/divisions.mdx index 13da2f80..3d775bd3 100644 --- a/navigation/divisions.mdx +++ b/navigation/divisions.mdx @@ -1,5 +1,5 @@ --- -title: Tabs, Anchors, Dropdowns +title: "Tabs, Anchors, Dropdowns" --- ## Tabs @@ -8,9 +8,15 @@ Tabs help distinguish between different topics or sections of your documentation. - + - + ```json docs.json @@ -45,9 +51,15 @@ documentation. Anchors are another way to section your content. They show up on top of your side navigation. - + - + The configuration is very similar to the tab configuration. We highly recommend that you set an `icon` field as well. @@ -82,16 +94,27 @@ Valid icon values include all named [Font Awesome](https://fontawesome.com/icons } ``` + + We recommend using anchors in the global settings of `docs.json` to point to external links. For anchors used as the primary navigation structure, you can use `pages` , `openapi`, and `groups`. + + ## Dropdowns - + - + Dropdowns show up in the same place as anchors, but are consolidated into a single dropdown. We also recommend that you set an icon for each dropdown item (from [Font Awesome](https://fontawesome.com/icons) or [Lucide](https://lucide.dev/icons)). + ```json docs.json "navigation": { "dropdowns": [ @@ -121,7 +144,6 @@ We also recommend that you set an icon for each dropdown item (from [Font Awesom } ``` - ## Nested Hierarchy You can use any combination of anchors, tabs, and dropdowns - either one can be nested within each other interchangeably. @@ -163,6 +185,7 @@ You can use any combination of anchors, tabs, and dropdowns - either one can be } ``` + ```json Top-Level Tabs { "navigation": { @@ -242,5 +265,4 @@ You can use any combination of anchors, tabs, and dropdowns - either one can be } ``` - - + \ No newline at end of file