Breadcrumbs

This macro is used for inserting the breadcrumb target div and breadcrumbs.

ROOT Skin Location

In ThemeBuilder ROOT skin, the breadcrumbs are in the Title panel.

Storage Format

 
<ac:macro ac:name="panel-breadcrumbs">
<ac:parameter ac:name="parameter">value</ac:parameter>
</ac:macro>

Wiki Markup

 
{panel-breadcrumbs:parameter=value}

Parameter	Name	Description	Type	Default
forceexpansion	Force Expansion	All breadcrumbs will always be visible, i.e., the ellipsis is never used	boolean	false
ancestors	Visible Ancestors	The minimum number of visible ancestors before breadcrumbs are compressed into an ellipsis	int	3
legacy	Legacy Mode	Attempt to make breadcrumbs as backward compatible as possible with older themes	boolean	false
flag	Flag	A list of flags, one of which must be defined for the content to be displayed	string
notflag	Not Flag	A list of flags that must not be defined for the content to be displayed	string

Basic Example

The main difference between ThemeBuilder panel-breadcrumbs and Confluence breadcrumbs is that ThemeBuilder includes the link to the Dashboard by default.

To use panel-breadcrumbs in a ThemeBuilder panel, you can add the simplest form of the macro.

 
<ac:macro ac:name="panel-breadcrumbs" />
{panel-breadcrumbs}

Result

Both the Confluence and ThemeBuilder panel-breadcrumbs have been shown here for comparison.

HTML Output

ThemeBuilder adds additional classes to the HTML output for custom CSS styling:

dashboardbreadcrumb
pagescollectorbreadcrumb
pagebreadcrumb

 
<div id="breadcrumb-section">
Confluence Breadcrumbs
<ol id="breadcrumbs">
<li class="first">
<span class=""><a href="/confluence/collector/pages.action?key=AD">Pages</a></span>
</li>
<li>
<span class=""><a href="/confluence/display/AD/Adaptavist+Documentation+Home">Adaptavist Documentation
Home</a></span>
</li>
</ol>
Panel Breadcrumbs
<ol id="breadcrumbs">
<li class="first dashboardbreadcrumb">
<span><a href="/confluence/dashboard.action" title="Go to Dashboard">Dashboard</a></span>
</li>
<li class="pagescollectorbreadcrumb">
<span><a href="/confluence/collector/pages.action?key=AD">Pages</a></span>
</li>
<li class="last pagebreadcrumb">
<span><a href="/confluence/display/AD/Adaptavist+Documentation+Home">Adaptavist Documentation Home</a></span>
</li>
</ol>
</div>

Advanced Example

Follow this example and learn to control the number of levels hidden by the ellipses.

Default 'ancestors' (3)

 
<ac:macro ac:name="panel-breadcrumbs" />

Set 'ancestors' (2)

 
<ac:macro ac:name="panel-breadcrumbs">
<ac:parameter ac:name="ancestors">2</ac:parameter>
</ac:macro>

Set 'ancestors' (4)

 
<ac:macro ac:name="panel-breadcrumbs"> <ac:parameter ac:name="ancestors">4</ac:parameter> </ac:macro>