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 | Required |
|---|---|---|---|---|---|
| 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 Examples
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>