{navitabs}
The navitabs macro provides the following modes of which only one can be active at a time:
- Children (Default): generates tabs for all child-pages of current/specified page.
- Labels: generates tabs based on the specified labels.
Parameters|
| Parameter | Mandatory | Default | Mode | Description |
| usewithoutbody | no | false | Label/Children | enable, if you use the macro with an empty macro body |
| vertical | no | false (horizontal) | Label/Children | generates the tabs vertically if true |
| width | no | 120 | Label/Children | the width of the vertical tabs in px |
| root | no | current page | Children | generates tabs for all child-pages/descendants of the root-page, leave blank for current page, use @parent for parent page (only in children mode) |
| includeroot | no | false | Children | adds an additional tab for the root-page itself (only in children mode) |
| firsttab | no | – | Label/Children | defines the very first tab to be generated. Useful for a e.g. a home-page |
| depth | no | 1 | Children | depth of child-pages/descendants for which tabs are generated (only in children mode) |
| sort | no | false | Children | if tabs should be sorted alphabetically (only in children mode) |
| sortbylabel | no | false | Label | tabs are sorted alphabetically by default in label mode, use "true" for sorting alphabetically by label or explicitly set to "false" for natural sorting by label (only in label mode) |
| reverse | no | false | Children | if the sort order should be reversed (only in children mode) |
label
labels | no | – | Label | one or several (comma separated) labels. Generate tabs for pages containing this label. Tabs are sorted alphabetically. Setting this parameter disables the children mode |
| spacekey | no | all spaces | Label | use only pages from this space (only in label mode) |
| ltrunc | no | 0 | Label/Children | the number of characters to be truncated from the left of every tab |
| ltruncfirsttab | no | true | Label/Children | if the left truncation should be applied to the "firsttab" as well |
Display all child-pages of a page as tabs:{navitabs}
If you want the navitabs on the child-pages as well, place the following wiki syntax on every child-pages:
{navitabs:root=parentpage}
Display the tabs vertically:
{navitabs:vertical=true|root=parentpage}
Display the tabs vertically with the page content in the macro body:
{navitabs:vertical=true|root=Home|includeroot=true|firsttab=Home}Write the actual content of the page here...{navitabs}
Generate tabs of pages containing the label cats or dogs from the space animals:
{navitabs:labels=cats,dogs|spacekey=animals|includeroot=true|firsttab=Home}
