Wiki source code of Live Data
Last modified by Pierre Jeanjean on 2026/10/16 13:17
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Live Data is a feature provided by the [[Live Data Macro>>doc:extensions:Extension.Live Data.Macro.WebHome]] extension. A Live Data instance can display dynamic lists of data from multiple sources, and provides different [[layouts>>doc:documentation.xs.user.livedata.layouts.WebHome]] (table, cards) as well as support for pagination, selection, multi-sort, advanced filtering (through different [[panels>>doc:documentation.xs.user.livedata.panels.WebHome]]) and in-line editing. The Page Index, the index of attachments and the list of orphaned pages are all Live Data instances, which is why they all behave the same way. | ||
| 2 | |||
| 3 | {{image reference="live-data-page-index.png" size="extra" alt="The Page Index of a wiki, displayed as a Live Data table with a pagination bar above the entries and a filter row under the column headers"/}} | ||
| 4 | |||
| 5 | While the document's author controls what is available in the Live Data instance, the reader is free to customize the display on their side. Display changes, which includes the current page of results, the sort, the filters, the visible properties and their order, are stored in the page's URL, meaning that a specific view can be freely shared with others, or bookmarked. | ||
| 6 | |||
| 7 | {{version since="18.9.0RC1"}} | ||
| 8 | To focus on a Live Data, the reader can click "Maximize" in its menu: it will then cover the whole window, until either "Minimize" is clicked from the same menu or the "Escape" key is pressed. | ||
| 9 | |||
| 10 | {{image reference="live-data-maximize.png" size="large" alt="The Maximize action in the Actions section of the open menu of a Live Data"/}} | ||
| 11 | {{/version}} | ||
| 12 | |||
| 13 | When the source of the entries supports it and a user is allowed to make changes, values can be [[edited in place>>doc:documentation.xs.user.livedata.edit-value-place.WebHome]] without leaving the page, or in bulk through [[Edit mode>>doc:documentation.xs.user.livedata.edit-mode.WebHome]]. | ||
| 14 | |||
| 15 | Any page can display a Live Data, as described in [[Display a List of Data in a Page>>doc:documentation.xs.user.livedata.display-data.WebHome]]. Live Data is the replacement for the older [[live table>>doc:extensions:Extension.Livetable Macro]] feature, which will be removed eventually, so live table users should [[migrate their live tables>>doc:documentation.xs.user.livedata.migrate-live-table.WebHome]]. |
