nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

How to display flat list of descendant pages in confluence

Adolfo Casari

I need to display a flat list of pages descendants of a page in confluence. The idea is to put this list at the top of a (home) page to show all of its descendants.

Page Tree and Children Display macros offer a hierarchy display only .

Any ideas?

Thanks in advance,

Accepted answers

Davin Studer

You could do this with a user macro and the children display macro. Create a user macro with the below velocity template. Set "Macro Body Processing" to "Rendered". Then on your page add the user macro and put the children display macro inside it.

## Developed by: Davin Studer
## Date created: 04/20/2015
## @noparams
#set( $id = $action.dateFormatter.calendar.timeInMillis )
&lt;div id="children$id"&gt;$body&lt;/div&gt;
&lt;style type="text/css"&gt;
    #children$id .childpages-macro {
        padding: 0;
        margin: 0;
    }    
	#children$id .childpages-macro li {
        display: inline-block;
        text-decoration: none;
        margin-right: 10px;
    }
    #children$id .childpages-macro li a::before {
        content: '[';
    }
    #children$id .childpages-macro li a::after {
        content: ']';
    }
&lt;/style&gt;

All comments

TomC

Adolfo, are you asking for a display of only the first-level descendants ('children') vs. second-level ('grandchildren') and beyond, or an actual flat list with all descendant pages listed regardless of parent-child relationship? If the latter is what you want, do you need the pages to exist in the hierarchical position they were created in? If not, then of course you can easily move/drag them to be all direct children and thus use either macro can work.

Adolfo Casari

Hi, it's the children only. I need to display a page's children as a flat list, not a tree hirarchy. Reason for this is to include this list at the top of the page in a single row (I only use 5-6 children in my case). Macro Table of Contents allows flat list, but that only works for the headings inside a page, but the idea is the same.

TomC

Given that, have you tried either using the parameter's descendants depth at '1'?

For your needs I think the Children macro with 'Depth of Descendants' set at '1' would be best. Here is the same listing of children - utilizing the same parent page - for each macro (actual names of pages blurred out). The Children macro lists bullets, the Page Tree macro lists bullets AND clickable 'twisties' (they look like 'greater than' symbols) if there are pages under them.

Children macro screenshot -shows Depth of Descendants setting:

childrenmacro.png

Page tree macro screenshot - shows Start Depth setting:

pagetreemacro.png

childrenmacro.png

Adolfo Casari

Right, but I need that list horizontal, not vertical. I don't see any options in the macros to do that. Each page should be between [ ] .

Davin Studer

## Developed by: Davin Studer
## Date created: 04/20/2015
## @noparams
#set( $id = $action.dateFormatter.calendar.timeInMillis )
&lt;div id="children$id"&gt;$body&lt;/div&gt;
&lt;style type="text/css"&gt;
    #children$id .childpages-macro {
        padding: 0;
        margin: 0;
    }    
	#children$id .childpages-macro li {
        display: inline-block;
        text-decoration: none;
        margin-right: 10px;
    }
    #children$id .childpages-macro li a::before {
        content: '[';
    }
    #children$id .childpages-macro li a::after {
        content: ']';
    }
&lt;/style&gt;

TomC

Davin, Thanks for backing me up - I know how to use a lot of the existing macros but not how to create velocity templates. It appears you have supplied a reasonable solution. Hope it helps Adolfo. Cheers, Tom

Adolfo Casari

Thanks for your help. That macro did the trick!.

Davin Studer

My pleasure.

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

confluence