Navitabs Macro

Vertical Orientation
vertical

Tick the box to display the tabs vertically. By default, tabs are oriented horizontally.

Width
width

The width of the vertical tabs in pixels. The default is 150 pixels.
This parameter only makes sense if the vertical orientation is enabled.

Tab style
tabStyle

Tab style defines how tabs look in the UI.

More details on the tab styles

As a user, you can switch between the tab style "Atlassian tabs" (default) and "index cards".

Switch between the styles by editing the macro and changing the "Tab style".

Tab style "Atlassian tabs" is the standard Atlassian tab layout. It is used as default.

Tab style "index cards" displays the tabs as cards (2D).

Use Without Body
usewithoutbody

Enable this option if you use the macro without a macro body. By default, the macro body is used.

First Tab
firsttab

Specify the name of the tab to display in the first position. This is useful for a "home" page.

Left truncation
ltrunc

The number of characters to truncate from the left of every tab title.
This makes sense in long page titles to save space. By default, the entire title appears.

More details on left truncation

Left truncation makes sense if you have long page titles with identical prefixes.

Use case:

You might have a number of pages all starting with "ch1 Child" that you want to display as tabs.

In order to save space, you can decide to cut (=truncate) the first 9 characters of each tab title. Here's how to do it:

1. Include the macro on your page. Per default, it will look like this:
   

   

2. Edit the macro and set "Left truncation" to 9. This means that the first 9 characters of each tab title will not be displayed.
   

   

3. Select "Preview" to see the shortened tab titles.
   

   

4. Once you are happy with the result, save the macro and publish the page.

Left truncation of the first tab
ltruncfirsttab

Tick the box if you want to truncate the tab you defined as the "first tab" as well.

Root page
root

Define the page whose child pages will be displayed as tabs. Leave blank for the current page. Use @parent for the parent page.

Include root page
includeroot

Tick the box to add an additional tab for the root page.

Depth
depth

The depth of child pages for which tabs are generated. The default is 1.

Sort by name
sort

Tick the box to switch from sort by position (default) to sort by name.

Reverse
reverse

Tick the box to reverse the sort order.

Labels
labels

Generate tabs for pages containing one or more labels (comma separated). Tabs are sorted alphabetically by default.
By setting this parameter, you switch from "children" to "labels" mode.

Space key
spacekey

Specify a space to only display labelled pages from that space. In most cases, it makes sense to limit the tabs to the current space.

Sort by label
sortbylabel

Tick the box to switch from sort by name (default) to sort by a label.