Display a List of Data in a Page
Steps
Display a list of entries in a page with the liveData Macro, described in Live Data.
- Edit the page in "Source" mode or with the Wiki editor and write a liveData Macro where the list should appear.
{{liveData id="reports" properties="doc.title,tags,doc.date" source="liveTable" sourceParameters="className=XWiki.TagClass&translationPrefix=platform.index." /}} - Set source to the id of the Live Data source providing the entries, and sourceParameters to the query string that source expects.
- Set properties to the comma-separated ids of the properties to display, in the order they should appear. Leave it out to display every property the source declares.
- Set the optional id, sort, filters, limit and layouts parameters, listed in "liveData" Macro.
- Save the page. The entries are displayed in the first layout of the list, as follows:
FAQ
Where do I find the ids of the properties I can display?
They depend on the source; for the liveTable source they are the properties of the class named in className, plus document properties such as doc.title.
What is the id parameter for?
It names the instance. Each Live Data stores its display state in the page URL under that id, and scripts reach it by it, so two instances in one page must not share one. It is optional, and a page holding a single Live Data can do without it.
Can I display data that is not stored in the wiki?
Yes, by writing the entries in the Macro content as in-line data.
Can I display a Live Data from a Velocity template?
Yes, with the Live Data Script Service, which is the only option where Macros cannot be used.
More
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.
