LiveData table

Last modified by Thiago Krieck on 2026/11/18 14:13

Warning
Draft

This page is a draft. The standards on it are proposals still under discussion, so they may change and should not be treated as final yet.

The standard

Any list of entries that users browse, sort or filter (pages, users, attachments, objects) should be a LiveData. Static tables in content should stay plain wiki tables.

  • When to use: New lists should use the {{liveData}} macro, or {{documents}} for lists of pages. The legacy livetable (#livetable) should not be used anymore, since it looks and behaves differently and doesn't get the LiveData features (column reordering, advanced filters, edit mode).
  • Columns: Should show only what users need to identify and compare entries, with a default sort (such as by name or location), so that the list opens in a predictable order. A column that can't be sorted or filtered should be declared so, so that users aren't offered controls that do nothing.
  • Row actions: Should go in the actions column (_actions) and reuse the default actions (view, edit, copy, rename, rights, delete), so that the same action has the same icon and label in every list. Deleting an entry should follow Delete confirmation.
  • Description: A list whose purpose isn't obvious from the page should set the description parameter, since it is shown above the table and linked to it for screen readers.
  • Empty state: Should say why the list is empty and, when the user can act, how to add the first entry. See Empty state.
  • Feedback: Progress and errors of row actions and inline edits should use transient notifications. See Alerts and notifications.

Reference example: Page Index → Pages. It lists pages with title, location, date and author, is sorted by location by default, marks the likes column as not sortable or filterable, and offers copy, rename, rights and delete in the actions column. Index → All attachments follows the same model, with typed columns for size and date.

livedata-reference-page-index.png

LiveData table: Page Index → Pages

Notes

  • The default liveTable source is a LiveData source; it has nothing to do with the legacy livetable markup.
  • The automated accessibility checks only warn about missing labels and unfocusable scrollable regions, so these should be checked by hand. See Accessibility.

More

Get Connected