Defines a column as a text input.
The list input macro is added to the checklist macro to define an input column for the list.
o
Edit the list input macro to add the name of the column heading.
The list input macro can be configured to store the input column list values either:
- on the page listed in the row of the entered value.
- on the current page of the checklist.
The default entry value is 20 characters maximum.
The list input macro can also be configured to display values as read-only.
This is useful when the macro is added to other content but you only want the column list values to be edited on a specific page(s) with the added macro. The column values storage needs to be set to be on the row pages.
The macro allows the column values to be sorted by a number of entry types including
- string (S)
- integer (I)
- date (D)
You can also set the column as already sorted (A) to prevent sorting the list on this input column.
The column values are stored as metadata values (see storage type parameter in the table below).
See also Example 4.
Parameters
parameter | Mandatory? | Default | Description | Comments |
|---|---|---|---|---|
| yes | The heading of the column | ||
| yes | 20 | The maximum number of characters read | |
| no |
| Determines where to store the value. Use |
|
| no |
| Type of value to be used to sort the table by this column. Values could be any of A: Already sorted; C: Currency; D: Date; F: Float; I: Integer; S: String | |
| no | Width of the column | ||
| no |
| Whether or not the column is read-only | |
| no | The style sheet (CSS) class to use for the cells |
Change in key format
When using storage=checklist (i.e., store the metadata values into the page containing the checklist) the metadata value name is
<Column Heading>.<Space Key>:<Row page title>
This new format replaces the old
<Column Heading>.<Row page title>
{list-input:cols=20|heading=Common pet names|store=list}