diff --git a/Documentation.md b/Documentation.md index 20c950d..ab4cc2c 100644 --- a/Documentation.md +++ b/Documentation.md @@ -9,12 +9,21 @@ All-in-one starter app with behavioral task trials
fixation

Builds a trial with a fixation dot and optional photodiode box.

+
multiSurvey
+

Builds a multi choice/select survey trial.

+
showImage

Builds a trial with a onscreen message and optional photodiode box

showMessage

Builds a trial with a onscreen message, optional buttons and optional photodiode box

+
slider
+

Builds a trial with a onscreen message and allows the subject to respond by dragging a slider.

+
+
survey
+

Builds a trial with a question and with free response text fields. The subject types in answers.

+
userId

Builds a trial with set Id message and user Id input.

@@ -53,6 +62,20 @@ Builds a trial with a fixation dot and optional photodiode box. | options.taskCode | number | Task code to be saved into data log (default: 1) | | options.numBlinks | number | Number of times the pulse needs to be repeated for photodiode box, when USE_PHOTODIODE is set true. (default: 1) | + + +## multiSurvey +Builds a multi choice/select survey trial. + + +| Param | Type | Description | +| --- | --- | --- | +| options | Object | | +| options.responseType | string | This tells jsPsych which plugin file to use to run the trial. (default: 'survey_multi_choice') | +| options.preamble | string | HTML formatted string to display at the top of the page above all the questions. (default: empty string) | +| options.prompts | string \| Array | The question prompts, this can be a string (one question) or an Array of strings (multiple questions) (default: "") | +| options.ansChoices | Object | Object consisting of the key as the answer choice name and value as the array of answer choices. (default: {}) | + ## showImage @@ -99,6 +122,28 @@ Builds a trial with a onscreen message, optional buttons and optional photodiode | options.numBlinks | number | Number of times the pulse needs to be repeated for photodiode box, when USE_PHOTODIODE is set true. (default: 1) | | options.buttons | Array | This array contains the keys that the subject is allowed to press in order to respond to the stimulus. Keys can be specified as their numeric key code or as characters (e.g., 'a', 'q'). The default value of jsPsych.ALL_KEYS means that all keys will be accepted as valid responses. Specifying jsPsych.NO_KEYS will mean that no responses are allowed. Only to be specified if the options.responseType is html_button_response (default: ["OK"], if options.responseType === html_button_response, otherwise ignored) | + + +## slider +Builds a trial with a onscreen message and allows the subject to respond by dragging a slider. + + +| Param | Type | Description | +| --- | --- | --- | +| message | string | The string to be displayed, this can be formatted as an HTML string. (default: empty string) | + + + +## survey +Builds a trial with a question and with free response text fields. The subject types in answers. + + +| Param | Type | Description | +| --- | --- | --- | +| options | Object | | +| options.stimulus | string | Onscreen stimulus in HTML to be shown in the trial, if not set default text is empty. If the stimulus is not provided, message should be provided as a string. (default: "") | +| options.message | string | Onscreen message to be shown in the trial. (default: "") | + ## userId