list input

Defines a column as a text input.

o
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.

o

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.

o

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

parameter

Mandatory?

Default

Description

Comments

heading

yes



The heading of the column



Input Character Width

yes

20

The maximum number of characters read



storage type

no

rows

Determines where to store the value. Use rows to store the values for this column into the pages representing each row (metadata value name is <Column Heading>), or checklist to store the values into the page containing the checklist (metadata value name is <Column Heading>.<Space Key>:<Row page title>)

store=checklist not supported with Comala Boards

sorttype

no

S

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



width

no



Width of the column



readonly

no

false

Whether or not the column is read-only



CSS class

no



The style sheet (CSS) class to use for the cells



Example

{list-input:cols=20|heading=Common pet names|store=checklist}