The {scrollbar} macro displays a linear navigation bar that makes scrolling through adjacent pages easy...

This macro is used on almost every page on our website. It's that bar at the top of the page that allows you to quickly jump to the next or previous page and even up to the parent page.

It's best used where there are groups of related pages (like these navigation macros for example) as it allows the user to access the related pages without re-viewing the parent page which would generally contain an index of those pages.

Add the macro to your page as follows:

{scrollbar}

Parameters

Parameter	Required	Default	Notes
up		true	If set to false, the link to the parent page will not be shown.
icons		true	If set to false, the icons associated with links will not be shown.
no-css		false	If set to true, the Unknown macro: {glossary} CSS used to format the scrollbar will not be added to the page. This is useful if you have provided your own styles using Builder's CSS Custom Styles.

This software is free for both commercial and non-commerical use.

This macro is compatible with Confluence 1.4.x and 1.5.x. It has been tested by Adaptavist with Confluence 1.4.1, 1.4.3 and 1.4.4. It has been tested by David Peterson with Confluence 1.5-DR2.

This macro is usually pre-installed with Builder accounts. If you wish to install it on your own Confluence install, please download it from the Confluence Extensions Page.

Adaptavist maintain a JIRA Project for tracking bug reports and feature requests for this macro. The currently reported items are shown below:

• children macro
• Online Documentation and Download

Basic Use

Add a scrollbar to a page:

{scrollbar}

The result is shown below:

Disabling link to parent page

To disable the link to the parent page, use the following notation:

{scrollbar:up=false}

The result is shown below:

Disabling icons

To create a text-only scrollbar, use the following:

{scrollbar:icons=false}

The result is shown below:

Custom Styles

To use your own style sheets with the scrollbar, use the following notation:

{scrollbar:no-css=true}

The result is shown below:

As you will have probably noticed, the scrollbar above looks no different to that on Example #1 - that's because our other scrollbar examples did not specify the "no-css" parameter. If any scrollbar on your page outputs default stylesheets, then all other scrollbars will look the same even if they use the "no-css" parameter. There's currently no way around this, but it's being worked on (see the Issue Tracking tab at the top of this page).

If you do not specify any styles, the scrollbar will look quite messy. To get the same effect used by Adaptavist (at least on other pages in this user guide), add the following styles to your CSS Custom Styles:

/* scrollbar macro styles */

table.ScrollbarTable {
padding: 3px;
width: 100%;
padding: 3px;
margin: 0px;
border: 1px solid #DDDDDD;
background-color: transparent;
}

td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
td.ScrollbarPrevName {text-align: left;border: none;}
td.ScrollbarParent {text-align: center;border: none;}
td.ScrollbarNextName {text-align: right;border: none;}
td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}