What do LIST blocks do?
LIST blocks prompt the end user to provide a list of entries. This list can then be referenced through the LIST variables. Learn more on referencing variables.
LIST blocks are also used along with the LOOP block where for each entry in a paired list, the pages in the Loop are run through once. Learn more about LOOP blocks.
What are LIST variables used for?
LIST variables can be referenced to:
- Display a list of all entries the user has entered
- Create dynamic table rows inside a TABLE block. Learn more.
- Create dynamic table rows with a LOOP function inside a rich style document template. Learn more.
How to add and configure a LIST block
- Drag in a LIST block from the left panel and connect it to the other blocks
- Add Header under the “Header” field and a question or prompt inside the textbox (i.e. rich text editor) on the right panel in the Property Editor to help the end user insert the correct values in the list
Note: It is best practice to bold the questions/prompt similar to when formatting questions in Paragraph fields of FORM blocks.
For example, in a budgeting tool, you may want to prompt the end user to enter their expense items. Therefore the added Header is “List of Expense Items” and the added prompt is “Please list your items of expenditure”. See below screenshot.
How to show LIST size
You can write conditions to create logic based on the number of values (entries) in a list using the operator LIST_SIZE. The below examples illustrate some of the different ways you could reference LIST_SIZE when writing conditions to create logic in Checkbox.
|If there are no values in LIST123.||LIST123_SIZE < 1|
|If there is only one entry in LIST123.||LIST123_SIZE == 1|
|If there is more than one entry in LIST123.||LIST123_SIZE > 1|
Essentially, the LIST_SIZE variable is a number output and can be referenced and used with Operators as you would for a numerical value.