Buttons response

The buttons response construct is a container that can house one or more buttons to record values and actions, and move the study forward.

Creating a buttons response

Buttons responses can be added to instructions, questionnaires and trials timelines. To add a keyboard response to a trials timeline, click New item. To add a keyboard response to instructions or questionnaires, click New response. Select Response - keyboard from the type list and select one of the following creation options:

  • New: create a new keyboard response.
  • Copy: copy another keyboard response from the current study.
  • Clone (from a different trial): clone another keyboard response (trials timeline only).

Editing buttons response

If the buttons response is a sub-construct of trials:

Click anywhere along its row (Figure 1) to open the editor.

Figure 1. Open construct editor

If the buttons response is not on the trials timeline (e.g. in a questionnaire or instructions):

Click Edit in the top left corner of the construct (Figure 2). To save your changes, click Save in the bottom right corner of the editor to save your changes.

Figure 2. Open construct editor

Adding a button

In edit mode, click Add button in the button table, and then click Add when you're done.

Removing a button

In edit mode, click Delete on the button row you wish to remove.

WARNING: Deleting a button will also delete any trials rules related to that button.

Randomizing button order

If the buttons response is on the trials timeline, button layout order can be randomized. In edit mode, when two or more buttons are present, you can randomize their layout order by selecting:

Randomization is consistent across all trials, and can be made consistent across multiple trial blocks via block counterbalancing if the buttons response is a clone.

Editing timing (trials timeline only)

In edit mode, the following properties can be set via the timing table:

  • Start mode
    • Fixed: start time will be measured from the beginning of the trials timeline.
    • Offset from previous item: start time will be measured from the end of the previous item on the trials timeline. If there is no previous item, or the timeout of the previous item is set to nil(infinite), then start time will be measured from the beginning of the trial.
  • Start time (ms): when to initiate construct.
  • Duration mode
    • Fixed: duration will be a fixed time period.
    • Random: duration will be a random time period bound by minimum and maximum values.
    • Factor: duration will be a randomly chosen level from the factor selected.
    • Level: duration will be set to the value of the chosen level.
  • Timeout (ms): duration of construct presence.