Merges tables (and lists) into one table (or list).
Properties
Column Names
List of column names to render.
If blank the columns from the tables are used.
Discard
Allows to discard list items or rows.
empty | Discard empty list items or table rows without cell content. |
|---|
no-links | Discard list items or table rows if there is not at least one link. |
|---|
no-items | Discard list items or table rows if link has class projectdoc-no-docs. |
|---|
full | Discard list items or table rows if fully set (all cells have content). |
|---|
partial | Discard table rows if there is at least one empty cell. |
|---|
is-checked | Discard list items or table rows if a task list with at least one checked checkbox is found. |
|---|
is-not-checked | Discard list items or table rows if a task list with at least one checkbox is found that is not checked. |
|---|
strikethrough | Discard list items or table rows if at least some text is tagged with strikethrough. |
|---|
The values empty, no-links, no-items, and no-links + no-items are typically used for definition, numbered, and bullet lists.
The values empty, full, and partial are typically used for tables. The value partial only has meaning for tables.
The value can be controlled by the space property Table Merger Macro Param Discard. The space property Table Merger override empty Items overrides the macro configuration.
Sort By
Specify the column names for a sort order. The suffix "-" will invert the sort order (descending).
Any string will turn on sort on list items.
Note that sorting is executed on table rows. If the rows reference documents, the properties used for sorting must be rendered in the tables.
CSS Class
Set to the table or definition list.
Macro Body
Tables or lists (dl, ul, ol) found in the body of the macro are merged.
Only tables or lists of the same kind are merged. If a collection of one kind is found, collection of other types are not merged. For instance you cannot merge tables with definition lists. If at least one table is found, lists of any kind are not merged.
Details
Some details on using this macro.
Nested Lists
Since lists may be nested, it is important to only use list roots when merging lists. Therefore lists are required to be siblings to be merged successfully. If lists are nested within other containers, the root containers can be marked with to select the contained list.
This is especially useful when the Content Marker Macro is used to make parts of lists only available for users with specified permissions or being members of specified groups.
Page Size Warnings
This macro supports macros that render a table. If such a macro runs into the limits set by the page size configuration and renders a warning, then this macro will render an error.
Ressources
Related information.
