This field plug-in supports the creation of a table for data input in SurveyCTO forms. While this has been a SurveyCTO limitation so far, it is possible to address this request through the creation of a Repeat Group with table appearance, which displays the data collected in a table. This field plug-in, however, allows you to create the real grid appearance and edit data directly from the table.
This plug-in is currently under beta. If you you find a problem with the field plug-in, please email support@surveycto.com.
- Define number of rows and columns in the table.
- Define the labels for the rows and columns in the table.
- Use the
numbersappearance for numeric input. - Use dynamic references in the headings for rows and columns.
This field plug-in requires the text field type.
The data is stored in a pipe (|) separated list of items such as:
1|2|3|4|5|6|7|8|9|0|
For example, if you have the following table:
| A | B | |
|---|---|---|
| 1 | A1 | B1 |
| 2 | A2 | B2 |
The data will be stored as:
A1|B1|A2|B2|
You can use any of the functions in the Working with lists of items section of our documentation on Using expressions in your forms: a reference for all operators and functions. Specifically, the item-at() function will allow you to retrieve items from the saved value.
Note: Because the responses are separates by a pipe (|) make sure there are no pipes (|) in any of the actual text in the responses.
| Feature / Property | Support |
|---|---|
| Supported field type(s) | text |
| Default values | No |
| Constraint message | Uses default behavior |
| Required message | Uses default behavior |
| Read only | Yes (shows the current value, if present) |
| media:image | No |
| media:audio | No |
| media:video | No |
numbers appearance |
Yes |
The following parameters are required for this field plug-in:
| Parameter key | Parameter value |
|---|---|
columns |
The number of columns to be displayed. |
rows |
The number of rows to be displayed. |
column_headers |
The headings for each column separated by a pipe (|). |
row_headers |
The headings for each row separated by a pipe (|). |
required (optional) |
Indicates whether some or all the cells in the table should have a value. When set to 1 all the the cells in the table should have a value. Default is 0. |
Note: Because the headings are separates by a pipe (|) make sure there are no pipes (|) in any of the text in the headers.
-
Sample form
You can find some sample form definitions in here:extras/sample-form -
Developer documentation
Instructions and resources for developing your own field plug-ins.
https://github.com/surveycto/Field-plug-in-resources -
User documentation
How to get started using field plug-ins in your SurveyCTO form.
https://docs.surveycto.com/02-designing-forms/03-advanced-topics/06.using-field-plug-ins.html