List group

You may need to let the end user to add items to a given list preserving its numbering and other properties like indentation, etcetera.

To do so with Docxpresso is absolutely straightforward because Docxpresso assumes that unless indicated otherwise if there is a variable within a list item that item is clonable.

Whenever we have a variable within a list item if we pass the mouse over it the following “gears” button will show up:


By clicking on it the following popup will show up:


Where we can configure the following display options (notice that the header info is mainly intended for developers or tech savvy users and as such we will largely ignore the details here).

The options include:

  • Clonable: that is checked by default implying that the list item will be clonable by the end user.
  • Printable: by default any list is both shown in the browser interface and in the final document but because of diverse reasons we may choose to hide it in any of them:
    • Always: default value, the table is shown in all interfaces.
    • Browser: the list item is only shown in the browser and it will not be printed in the final document.
    • Document: the opposite as before, i.e. the table will be printed but not shown in the browser.
  • Display: the default display option that by default will be “Show”. This in contrast to the previous printable option that is global will allow us to show or hide a block of content depending on the value of a variable:
    • Variable: the closed options variable that toggle the visibility properties of this list items.
    • Value: the value of set of values (separated by “;”) that will toggle the visibility of that list items, i.e. if the default display property is “show” whenever the chosen variable will take the given value (or any of the given values if more than one) the list items will be hidden and vice versa.