...
Description
This macro contains the wiki code which will be executed for each item of the surrounding report.
It is used by the Report Block and Report List macros. It will usually contain one or more uses of the Report Info macro to display reported values.
Parameters
Name | Required | Migratable to Cloud? | Default Value | Description |
|---|---|---|---|---|
trim |
|
...
|
...
| false | If set to true, the body will be have any whitespace at the beginning or end trimmed before being displayed. | |
injected |
|
...
|
...
| false | (Since 2.0.0) If set to true, the body will have any '%prefix:keychain%' values injected with values from the current report item prior to being rendered. |
Editor View
...
Macro Edit View
Not applicable.
Notes
Quick Examples
List the Children of the Current Page
| Code Block |
|---|
{report-list} {content-reporter:scope=@self > children} {text-sort:content:title} {content-reporter} {report-body}{report-info:content:title|link=true}{report-body} {report-list} |
Keychain Injection
Output the title and excerpt of each child page. As you can see, you can mix injected properties and standard calls.
| Code Block |
|---|
{report-block} {local-reporter:content:children} {local-reporter} {report-body:injected=true} h2. %content:title% {report-info:content:excerpt|render=wiki} {report-body} {report-block} |
Conditional Display
From Reporting 2
...
onwards report-body
...
can be displayed conditionally based on filters (e.g. text-filter). This is done by putting any filters the current item must match immediately before
...
the report-body
...
definition. For example:
| Code Block |
|---|
{report-block} {local-reporter:content:children} {report-body}This is always output.{report-body} {text-filter:content:title|include=FOO.*} {user-filter:content:creator|user=bob} {report-body}Only children who's title starts with FOO and were created by Bob will have this displayed.{report-body} {report-body}This is always output too.{report-body} {report-block |
...
} |
Tutorial Examples
| Filter by label (Content by label) | ||||||||
|---|---|---|---|---|---|---|---|---|
|