Use this field plug-in when you would like to time multiple select_one and/or select_multiple fields within the same field list. This will have a persistent timer at the top, even if the enumerator/respondent scrolls down. The timer is optional, so you can also use the field plug-in to create a scrollable field list group.
To learn all about how to use this field plug-in, check out the wiki, which goes into full detail on all of the features, parameters, and how to retrieve its data.
For timing a single select_one or select_multiple field alone on one screen, see the timed-choice field plug-in.
This field plug-in supports the select_one and select_multiple field types. Just like with normal fields, the field type will determine what kind of buttons are shown: radio buttons or checkboxes.
Important: Unlike other fields, the choices selected are NOT stored in the field value, but in the field plug-in metadata. To retrieve that metadata, use the plug-in-metadata() function. Sections of data are stored in a pipe-separated (|) list, with the first section storing time data, and each subsequent section storing the choices selected on each question inside the timed field list. To learn how to understand that data, check out the wiki, section 5. Retrieving the selected choices.
To use this field plug-in as-is, just download the timed-field-list.fieldplugin.zip file from this repo, and attach it to your form.
To use with the sample form:
- Download the sample form from this repo.
- Download the timed-field-list.fieldplugin.zip file from this repo.
- Also download the button-to-advance.fieldplugin.zip field plug-in file (readme).
- Upload the sample form to your server with the two field plug-ins attached.
- Adjust the parameters as you see fit.
To learn more about using the sample form, check out the wiki, section 1.1 Main sample form.
There are many optional parameters you can use to customize the field plug-in. For details on all of the parameters and how to use them, see the wiki, section 4.1 Required parameter. However, here is a brief overview of the most common parameters:
| name | Description | Default |
|---|---|---|
labels (required) |
List of labels for each row of choices. These will go in the left-most column. Each label should be separated by a pipe (|). |
(none) |
duration (optional) |
Starting time on the timer. If this parameter is not defined, the field will not be timed. | (none) |
header (optional) |
Header of the column with the row labels, i.e. what will be in the top-left cell of the table of choices. | (none) |
advance (optional) |
If this field has a value of 1, then the field will auto-advance when time runs out |
0 |
block (optional) |
By default, when time runs out, fields will be blocked, meaning the selected choices cannot be changed (i.e. they cannot be selected or un-selected). If this parameter has a value of 0, then rows will not be blocked after time runs out. |
1 |
nochange (optional) |
If this parameter has a value of 1, then once a choice is selected in a row, then that row will be blocked, and it cannot be changed. |
0 |
| Feature / Property | Support |
|---|---|
| Supported field type(s) | select_one, select_multiple |
| Default values | No |
| Custom constraint message | No |
| Custom required message | No |
| Read only | Yes |
| media:image | Yes |
| media:audio | Yes |
| media:video | Yes |
label appearance |
No |
list-nolabel appearance |
No |
quick appearance |
No |
minimal appearance |
No |
compact appearance |
No |
compact-# appearance |
No |
quickcompact appearance |
No |
quickcompact-# appearance |
No |
likert appearance |
No |
likert-min appearance |
No |
likert-mid appearance |
No |
-
Sample form
You can find a form definition in this repo here: extras/sample-form. -
Developer documentation
More instructions for developing and using field plug-ins can be found here: https://github.com/surveycto/Field-plug-in-resources