Overview

The Navitabs plugin provides a very simple solution which allows users to navigate between pages. It generates horizontal or vertical navigation tabs that look just like the tabs in Confluence.

Navitabs Macro

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.

 

navitabs
confluence-content
NameDescriptionTypeThis is a required fieldDefaultValues
Root page
root
The page you want to display all child pages as tabs. Leave blank for current page, use @parent for parent page (only in children mode)confluence-content
Include root page
includeroot
Adds an additional tab for the root page. (only in children mode)booleanfalse
Depth
depth
Depth of child pages for which tabs are generated. (only in children mode)int1
Labels
labels
Generate tabs for pages containing one or more labels (comma separated). Tabs are sorted alphabetically by default. Set this parameter to switch from children to label mode.string
Space key
spacekey
Limit the pages by space. (only in label mode)spacekey
Vertical Orientation
vertical
Display the tabs vertically or horizontally.booleanfalse
Width
width
The width of the vertical tabs in pixels. (only if vertical is enabled)int150
Use Without Body
usewithoutbody
Enable this option, if you use the macro without a macro body.booleanfalse
First Tab
firsttab
The name of the tab to display at the first position. Useful for a "home" page.string
Sort by name
sort
Enable to switch from sort by position to sort by name. (only in children mode)booleanfalse
Sort by label
sortbylabel
Enable to switch from sort by name to sort by label. (only in label mode)booleanfalse
Reverse
reverse
Enable to reverse the sort order (only in children mode)booleanfalse
Left truncation
ltrunc
Number of characters to truncate from the left of every tab.int0
Left truncation of first tab
ltruncfirsttab
If you want to truncate the tab you defined as the "first tab" as well.booleantrue

Display all child-pages of a page as tabs:

If you want the navitabs on the child-pages as well, place the following wiki syntax on every child-pages:

Display the tabs vertically:

Display the tabs vertically with the page content in the macro body:

Generate tabs of pages containing the label cats or dogs from the space animals:

 

Localtab Macros 

With the Localtab Group and the Localtab macros, content of a Confluence page can be arranged as tabs. The Localtab Group and the Localtab macros can only be used together.

Localtab Group{localtabgroup}
Macro to generate Confluence-like navigation tabs based on its containing Localtab macros.
confluence-content

Parameter

NameDescriptionTypeThis is a required fieldDefaultValues
Vertical orientation
vertical
Display the tabs vertically or horizontally.booleanfalse

Localtab{localtab}
confluence-content

Parameter

NameDescriptionTypeThis is a required fieldDefaultValues
Title
title
The title of the tab.string
Active
active
Specify whether this tab should be active when page is loaded.booleanfalse
Link ID
id
Optional ID to link to this tab.
Example: when using ID ExampleTab, you can link to this tab with #ExampleTab. Needs to be unique on the page.
string

Use the Localtab macros inside a Localtab-Group macro:

Childtabs Macro

The Childtabs macro automatically generates tabs with content from child pages.

Childtabs{childtabs}
confluence-content

Parameter

NameDescriptionTypeThis is a required fieldDefaultValues
Root page
root
The page of which you want to display all child pages as tabs. Leave blank for current page.confluence-content
Vertical orientation
vertical
Display the tabs vertically or horizontally.booleanfalse
Left truncation
ltrunc
Number of characters to truncate from the left of every tab.int0

FAQ

 How can I link to specific tabs when using the Localtab macro?

E.g. when you set the Localtab parameter "ID" to ExampleTab, you can link to this tab by inserting an advanced link with #ExampleTab.

 Why is Panelbox now a paid add-on?

bitvoodoo was founded in 2008. We offer many free add-ons, as well as some paid add-ons and a complete range of services, from system installation and configuration to support, training and custom development.

The Panelbox add-on was first listed in the Atlassian Marketplace in 2010. One of our main goals is to produce high quality software, which in our understanding, means that our add-ons are always compatible with the latest version of the Atlassian software they were developed for, and are, for example, compliant with the Atlassian User Interface Guidelines. This constantly generates maintenance work. To provide this service in the future, we have now decided to change the Panelbox add-on from a free plan to a paid one, at a very reasonable price. We are confident that all of our loyal customers will understand this move.

 

Support