jspsych 6.3.0 → 7.1.1

package/docs/plugins/jspsych-serial-reaction-time-mouse.md

@@ -1,52 +0,0 @@
-# jspsych-serial-reaction-time-mouse plugin
-
-The serial reaction time mouse plugin implements a generalized version of the SRT task [(Nissen & Bullmer, 1987)](https://doi.org/10.1016%2F0010-0285%2887%2990002-8). Squares are displayed in a grid-based system on the screen, and one square changes color. The participant must click on the square that changes color.
-
-## Parameters
-
-In addition to the [parameters available in all plugins](/overview/plugins#parameters-available-in-all-plugins), this plugin accepts the following parameters. Parameters with a default value of *undefined* must be specified. Other parameters can be left unspecified if the default value is acceptable.
-
-| Parameter                 | Type           | Default Value | Description                              |
-| ------------------------- | -------------- | ------------- | ---------------------------------------- |
-| target                    | array          | *undefined*   | The location of the target. The array should be the `[row, column]` of the target. |
-| grid                      | array          | `[[1,1,1,1]]` | This array represents the grid of boxes shown on the screen. Each inner array represents a single row. The entries in the inner arrays represent the columns. If an entry is `1` then a square will be drawn at that location on the grid. If an entry is `0` then the corresponding location on the grid will be empty. Thus, by mixing `1`s and `0`s it is possible to create many different grid-based arrangements. |
-| grid_square_size          | numeric        | 100           | The width and height in pixels of each square in the grid. |
-| target_color              | hex color code | `#999`        | The color of the target square.          |
-| response_ends_trial       | boolean        | `true`        | If true, the trial ends after a mouse click. Feedback is displayed if `show_response_feedback` is true. |
-| pre_target_duration       | numeric        | 0             | The number of milliseconds to display the grid *before* the target changes color. |
-| trial_duration            | numeric        | null          | The maximum length of time of the trial, not including feedback. |
-| fade_duration             | numeric        | null          | If a positive number, the target will progressively change color at the start of the trial, with the transition lasting this many milliseconds. |
-| allow_nontarget_responses | boolean        | false         | If true, the user can make nontarget response. |
-| prompt                    | string         | null          | This string can contain HTML markup. Any content here will be displayed below the stimulus. The intention is that it can be used to provide a reminder about the action the subject is supposed to take (e.g., which keys to press). |
-
-## Data Generated
-
-In addition to the [default data collected by all plugins](/overview/plugins#data-collected-by-all-plugins), this plugin collects the following data for each trial.
-
-| Name   | Type    | Value                                    |
-| ------ | ------- | ---------------------------------------- |
-| grid   | array   | The grid representation. Each inner array represents a single row. The entries in the inner arrays represent the columns. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-| target | array   | The `[row, column]` target location on the grid. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-| rt     | numeric | The response time in milliseconds for the subject to make a response. The time is measured from when the second stimulus first appears on the screen until the subject's response. |
-| response | array | The `[row, column]` response location on the grid. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-| correct | boolean | Whether the response location matches the target location (`true`) or not (`false`)l
-
-## Examples
-
-#### Basic example with four squares in a single row
-```javascript
-var trial = {
-  type: 'serial-reaction-time-mouse',
-  grid: [[1,1,1,1]],
-  target: [0,1]
-}
-```
-
-#### 2x2 grid with extra space in the middle
-```javascript
-var trial = {
-  type: 'serial-reaction-time-mouse',
-  grid: [[1,0,1],[0,0,0],[1,0,1]],
-  target: [0,2]
-}
-```

package/docs/plugins/jspsych-serial-reaction-time.md

@@ -1,57 +0,0 @@
-# jspsych-serial-reaction-time plugin
-
-The serial reaction time plugin implements a generalized version of the SRT task [(Nissen & Bullemer, 1987)](https://doi.org/10.1016%2F0010-0285%2887%2990002-8). Squares are displayed in a grid-based system on the screen, and one square changes color. The participant presses a key that corresponds to the darkened key. Feedback is optionally displayed, showing the participant which square the key they pressed matches.
-
-## Parameters
-
-In addition to the [parameters available in all plugins](/overview/plugins#parameters-available-in-all-plugins), this plugin accepts the following parameters. Parameters with a default value of *undefined* must be specified. Other parameters can be left unspecified if the default value is acceptable.
-
-| Parameter              | Type             | Default Value         | Description                              |
-| ---------------------- | ---------------- | --------------------- | ---------------------------------------- |
-| target                 | array            | *undefined*           | The location of the target. The array should be the `[row, column]` of the target. |
-| grid                   | array            | `[[1,1,1,1]]`         | This array represents the grid of boxes shown on the screen. Each inner array represents a single row. The entries in the inner arrays represent the columns. If an entry is `1` then a square will be drawn at that location on the grid. If an entry is `0` then the corresponding location on the grid will be empty. Thus, by mixing `1`s and `0`s it is possible to create many different grid-based arrangements. |
-| choices                | array of strings | `[['3','5','7','9']]` | The dimensions of this array must match the dimensions of `grid`. Each entry in this array is the key that should be pressed for that corresponding location in the grid. Entries can be left blank if there is no key associated with that location of the grid. |
-| grid_square_size       | numeric          | 100                   | The width and height in pixels of each square in the grid. |
-| target_color           | hex color code   | `#999`                | The color of the target square.          |
-| response_ends_trial    | boolean          | `true`                | If true, the trial ends after a key press. Feedback is displayed if `show_response_feedback` is true. |
-| pre_target_duration    | numeric          | 0                     | The number of milliseconds to display the grid *before* the target changes color. |
-| trial_duration         | numeric          | null                  | The maximum length of time of the trial, not including feedback. |
-| show_response_feedback | boolean          | false                 | If true, show feedback indicating where the user responded and whether it was correct. |
-| feedback_duration      | numeric          | 200                   | The length of time in milliseconds to show the feedback. |
-| fade_duration          | numeric          | null                  | If a positive number, the target will progressively change color at the start of the trial, with the transition lasting this many milliseconds. |
-| prompt                 | string           | null                  | This string can contain HTML markup. Any content here will be displayed below the stimulus. The intention is that it can be used to provide a reminder about the action the subject is supposed to take (e.g., which keys to press). |
-
-## Data Generated
-
-In addition to the [default data collected by all plugins](/overview/plugins#data-collected-by-all-plugins), this plugin collects the following data for each trial.
-
-| Name      | Type    | Value                                    |
-| --------- | ------- | ---------------------------------------- |
-| grid      | array   | The representation of the grid. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-| target    | array   | The representation of the target location on the grid. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-| response  | string | Indicates which key the subject pressed. |
-| rt        | numeric | The response time in milliseconds for the subject to make a response. The time is measured from when the second stimulus first appears on the screen until the subject's response. |
-| correct   | boolean | `true` if the subject's response matched the target. |
-
-## Examples
-
-#### Basic example with four squares in a single row
-```javascript
-var trial = {
-  type: 'serial-reaction-time',
-  grid: [[1,1,1,1]],
-  target: [0,1]
-}
-```
-
-#### 2x2 grid, Showing feedback for 500ms
-```javascript
-var trial = {
-  type: 'serial-reaction-time',
-  grid: [[1,1],[1,1]],
-  choices: [['r','t'],['f','g']],
-  target: [1,0],
-  show_response_feedback: true,
-  feedback_duration: 500
-}
-```

package/docs/plugins/jspsych-survey-html-form.md

@@ -1,50 +0,0 @@
-# jspsych-survey-html-form plugin
-
-The survey-html-form plugin displays a set of `<inputs>` from a HTML string. The type of input can be freely chosen, for a list of possible input types see the [MDN page on inputs](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). The subject provides answers to the input fields.
-
-## Parameters
-
-In addition to the [parameters available in all plugins](/overview/plugins#parameters-available-in-all-plugins), this plugin accepts the following parameters. Parameters with a default value of *undefined* must be specified. Other parameters can be left unspecified if the default value is acceptable.
-
-Parameter | Type | Default Value | Description
-----------|------|---------------|------------
-html | string | *undefined* | HTML formatted string containing all the input elements to display. Every element has to have its own distinctive name attribute. The `<form>` tag must not be included and is generated by the plugin. This string can contain other HTML elements besides the input fields.
-preamble | string | empty string | HTML formatted string to display at the top of the page above all the questions.
-button_label | string |  'Continue' | The text that appears on the button to finish the trial.
-dataAsArray | boolean |  false | Retrieve the data as an array e.g. [{name: "INPUT_NAME", value: "INPUT_VALUE"}, ...] instead of an object e.g. {INPUT_NAME: INPUT_VALUE, ...}. This might be useful if you omit naming your inputs.
-autofocus | string | empty string | The HTML element ID of a form field to autofocus on. The focused element is the element that will receive keyboard events. For elements like `<input type="text">` or `<textbox>`, autofocus means that the cursor will appear in the text input area when the trial loads.
-autocomplete | boolean | false | This determines whether or not all of the input elements on the page should allow autocomplete. Setting this to true will enable autocomplete or auto-fill for the form.
-
-## Data Generated
-
-In addition to the [default data collected by all plugins](/overview/plugins#data-collected-by-all-plugins), this plugin collects the following data for each trial.
-
-Name | Type | Value
------|------|------
-response | object | An object containing the response for each input. The object will have a separate key (variable) for the response to each input, with each variable being named after its corresponding input element. Each response is a string containing whatever the subject answered for this particular input. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-rt | numeric | The response time in milliseconds for the subject to make a response. |
-
-## Examples
-
-### Basic example
-
-```javascript
-var form_trial = {
-  type: 'survey-html-form',
-  preamble: '<p> How are you feeling <b>right now?</b> </p>',
-  html: '<p> I am feeling <input name="first" type="text" />, <input name="second" type="text" />, and <input name="third" type="text" />.</p>'
-};
-```
-
-### Example using the autofocus parameter
-
-In this example, the browser will focus on the element with the ID `test-resp-box` when the trial loads. For `<input type="text">` elements, this means that the cursor will appear inside the text box.
-
-```javascript
-var autofocus_trial = {
-  type: 'survey-html-form',
-  preamble: '<p> What is your favorite bird?</p>',
-  html: '<p>My favorite bird is <input type="text" id="test-resp-box" name="response" size="10" /></p>',
-  autofocus: 'test-resp-box'
-};
-```

package/docs/plugins/jspsych-survey-likert.md

@@ -1,70 +0,0 @@
-# jspsych-survey-likert plugin
-
-The survey-likert plugin displays a set of questions with Likert scale responses. The subject responds by selecting a radio button.
-
-## Parameters
-
-In addition to the [parameters available in all plugins](/overview/plugins#parameters-available-in-all-plugins), this plugin accepts the following parameters. Parameters with a default value of *undefined* must be specified. Other parameters can be left unspecified if the default value is acceptable.
-
-Parameter | Type | Default Value | Description
-----------|------|---------------|------------
-questions | array | *undefined* | An array of objects, each object represents a question that appears on the screen. Each object contains a prompt, labels and required parameter that will be applied to the question. See examples below for further clarification.`prompt`: Type string, default value is *undefined*. The strings are the question that will be associated with a slider. `labels`: Type array, default value is *undefined*. Each array element is an array of strings. The innermost arrays contain a set of labels to display for an individual question. If you want to use blank responses and only label the end points or some subset of the options, just insert a blank string for the unlabeled responses.`required`: Type boolean, default value is false. Makes answering questions required. `name`: Name of the question. Used for storing data. If left undefined then default names (`Q0`, `Q1`, `...`) will be used for the questions.
-randomize_question_order | boolean | `false` | If true, the display order of `questions` is randomly determined at the start of the trial. In the data object, `Q0` will still refer to the first question in the array, regardless of where it was presented visually.
-preamble | string | empty string | HTML formatted string to display at the top of the page above all the questions.
-scale_width | numeric | null | The width of the likert scale in pixels. If left `null`, then the width of the scale will be equal to the width of the widest content on the page.
-button_label | string |  'Continue' | Label of the button.
-autocomplete | boolean | false | This determines whether or not all of the input elements on the page should allow autocomplete. Setting this to true will enable autocomplete or auto-fill for the form.
-
-## Data Generated
-
-In addition to the [default data collected by all plugins](/overview/plugins#data-collected-by-all-plugins), this plugin collects the following data for each trial.
-
-Name | Type | Value
------|------|------
-response | object | An object containing the response for each question. The object will have a separate key (variable) for each question, with the first question in the trial being recorded in `Q0`, the second in `Q1`, and so on. The responses are recorded as integers, representing the position selected on the likert scale for that question. If the `name` parameter is defined for the question, then the response object will use the value of `name` as the key for each question. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-rt | numeric | The response time in milliseconds for the subject to make a response. The time is measured from when the questions first appear on the screen until the subject's response(s) are submitted. |
-question_order | array | An array with the order of questions. For example `[2,0,1]` would indicate that the first question was `trial.questions[2]` (the third item in the `questions` parameter), the second question was `trial.questions[0]`, and the final question was `trial.questions[1]`. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-
-## Examples
-
-#### Basic example
-
-```javascript
-var scale_1 = [
-  "Strongly Disagree", 
-  "Disagree", 
-  "Neutral", 
-  "Agree", 
-  "Strongly Agree"
-];
-
-var likert_page = {
-  type: 'survey-likert',
-  questions: [
-    {prompt: "I like vegetables.", labels: scale_1}
-  ]
-};
-```
-
-#### Multiple questions in a random order
-
-```javascript
-var scale_1 = [
-  "Strongly Disagree", 
-  "Disagree", 
-  "Neutral", 
-  "Agree", 
-  "Strongly Agree"
-];
-
-var likert_page = {
-  type: 'survey-likert',
-  questions: [
-    {prompt: "I like vegetables.", name: 'Vegetables', labels: scale_1},
-    {prompt: "I like fruit.", name: 'Fruit', labels: scale_1},
-    {prompt: "I like meat.", name: 'Meat', labels: scale_1},
-    {prompt: "I like dairy.", name: 'Dairy', labels: scale_1}
-  ],
-  randomize_question_order: true
-};
-```

package/docs/plugins/jspsych-survey-multi-choice.md

@@ -1,48 +0,0 @@
-# jspsych-survey-multi-choice plugin
-
-The survey-multi-choice plugin displays a set of questions with multiple choice response fields. The subject selects a single answer.
-
-## Parameters
-
-In addition to the [parameters available in all plugins](/overview/plugins#parameters-available-in-all-plugins), this plugin accepts the following parameters. Parameters with a default value of *undefined* must be specified. Other parameters can be left unspecified if the default value is acceptable.
-
-Parameter | Type | Default Value | Description
-----------|------|---------------|------------
-questions | array | *undefined* | An array of objects, each object represents a question that appears on the screen. Each object contains a prompt, options, required, and horizontal parameter that will be applied to the question. See examples below for further clarification.`prompt`: Type string, default value is *undefined*. The string is prompt/question that will be associated with a group of options (radio buttons). All questions will get presented on the same page (trial).`options`: Type array, defualt value is *undefined*. An array of strings. The array contains a set of options to display for an individual question.`required`: Type boolean, default value is null. The boolean value indicates if a question is required('true') or not ('false'), using the HTML5 `required` attribute. If this parameter is undefined, the question will be optional. `horizontal`:Type boolean, default value is false. If true, then the question is centered and the options are displayed horizontally. `name`: Name of the question. Used for storing data. If left undefined then default names (`Q0`, `Q1`, `...`) will be used for the questions.
-randomize_question_order | boolean | `false` | If true, the display order of `questions` is randomly determined at the start of the trial. In the data object, `Q0` will still refer to the first question in the array, regardless of where it was presented visually.
-preamble | string | empty string | HTML formatted string to display at the top of the page above all the questions.
-button_label | string |  'Continue' | Label of the button.
-autocomplete | boolean | false | This determines whether or not all of the input elements on the page should allow autocomplete. Setting this to true will enable autocomplete or auto-fill for the form.
-
-## Data Generated
-
-In addition to the [default data collected by all plugins](/overview/plugins#data-collected-by-all-plugins), this plugin collects the following data for each trial.
-
-Name | Type | Value
------|------|------
-response | object | An object containing the response for each question. The object will have a separate key (variable) for each question, with the first question in the trial being recorded in `Q0`, the second in `Q1`, and so on. The responses are recorded as the name of the option label selected (string). If the `name` parameter is defined for the question, then the response object will use the value of `name` as the key for each question. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-rt | numeric | The response time in milliseconds for the subject to make a response. The time is measured from when the questions first appear on the screen until the subject's response(s) are submitted. |
-question_order | array | An array with the order of questions. For example `[2,0,1]` would indicate that the first question was `trial.questions[2]` (the third item in the `questions` parameter), the second question was `trial.questions[0]`, and the final question was `trial.questions[1]`. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-
-## Examples
-
-```javascript
-var page_1_options = ["Strongly Disagree", "Disagree", "Neutral", "Agree", "Strongly Agree"];
-var page_2_options = ["Strongly Disagree", "Disagree", "Somewhat Disagree", "Neural", "Somewhat Agree", "Agree", "Strongly Agree"];
-
-var multi_choice_block = {
-  type: 'survey-multi-choice',
-  questions: [
-    {prompt: "I like vegetables", name: 'Vegetables', options: page_1_options, required:true}, 
-    {prompt: "I like fruit", name: 'Fruit', options: page_2_options, required: false}
-  ],
-};
-
-var multi_choice_block_horizontal = {
-  type: 'survey-multi-choice',
-  questions: [
-    {prompt: "I like vegetables", options: page_1_options, required: true, horizontal: true,}, 
-    {prompt: "I like fruit", options: page_2_options, required: false, horizontal: true}
-  ],
-};
-```

package/docs/plugins/jspsych-survey-multi-select.md

@@ -1,53 +0,0 @@
-# jspsych-survey-multi-select plugin
-
-The survey-multi-select plugin displays a set of questions with multiple select response fields. The subject could select multiple answers.
-
-## Parameters
-
-In addition to the [parameters available in all plugins](/overview/plugins#parameters-available-in-all-plugins), this plugin accepts the following parameters. Parameters with a default value of *undefined* must be specified. Other parameters can be left unspecified if the default value is acceptable.
-
-Parameter | Type | Default Value | Description
-----------|------|---------------|------------
-questions | array | *undefined* | An array of objects, each object represents a question that appears on the screen. Each object contains a prompt, options and horizontal parameter that will be applied to the question. See examples below for further clarification.`prompt`: Type string, default value of *undefined*. The string is the prompt/question that will be associated with a group of options (check boxes). All questions will get presented on the same page (trial).`options`: Type array, default value of *undefined*. The array contains a set of options to display for an individual question.`horizontal`: Type boolean, default value of false. If true, the questions are centered and options are displayed horizontally. `required`: Type boolean, default value of true. If true, then at least one option must be selected. `name`: Name of the question. Used for storing data. If left undefined then default names (`Q0`, `Q1`, `...`) will be used for the questions.
-randomize_question_order | boolean | `false` | If true, the display order of `questions` is randomly determined at the start of the trial. In the data object, `Q0` will still refer to the first question in the array, regardless of where it was presented visually.
-preamble | string | empty string | HTML formatted string to display at the top of the page above all the questions.
-button_label | string |  'Continue' | Label of the button.
-required_message | string | 'You must choose at least one response for this question' | Message to display if required response is not given.
-autocomplete | boolean | false | This determines whether or not all of the input elements on the page should allow autocomplete. Setting this to true will enable autocomplete or auto-fill for the form.
-
-## Data Generated
-
-In addition to the [default data collected by all plugins](/overview/plugins#data-collected-by-all-plugins), this plugin collects the following data for each trial.
-
-Name | Type | Value
------|------|------
-response | object | An object containing the response for each question. The object will have a separate key (variable) for each question, with the first question in the trial being recorded in `Q0`, the second in `Q1`, and so on. For each question, the responses are recorded as arrays containing any response options that were selected (strings). If the `name` parameter is defined for the question, then the response object will use the value of `name` as the key for each question. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-rt | numeric | The response time in milliseconds for the subject to make a response. The time is measured from when the questions first appear on the screen until the subject's response(s) were submitted. |
-question_order | array | An array with the order of questions. For example `[2,0,1]` would indicate that the first question was `trial.questions[2]` (the third item in the `questions` parameter), the second question was `trial.questions[0]`, and the final question was `trial.questions[1]`. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-
-## Examples
-
-#### Basic example with multiple questions on a page.
-
-```javascript
-var multi_select_block = {
-    type: 'survey-multi-select',
-    questions: [
-      {
-        prompt: "Which of these colors do you like?", 
-        options: ["Red", "Yellow", "Green", "Blue", "Black"], 
-        horizontal: true,
-        required: true,
-        name: 'Colors'
-      }, 
-      {
-        prompt: "Which of these foods do you like?", 
-        options: ["Apples", "Bananas", "Carrots", "Donuts", "Eggplant"], 
-        horizontal: true,
-        required: true,
-        name: 'Foods'
-      }
-    ], 
-    randomize_question_order: true
-};
-```

package/docs/plugins/jspsych-survey-text.md

@@ -1,63 +0,0 @@
-# jspsych-survey-text plugin
-
-The survey-text plugin displays a set of questions with free response text fields. The subject types in answers.
-
-## Parameters
-
-In addition to the [parameters available in all plugins](/overview/plugins#parameters-available-in-all-plugins), this plugin accepts the following parameters. Parameters with a default value of *undefined* must be specified. Other parameters can be left unspecified if the default value is acceptable.
-
-Parameter | Type | Default Value | Description
-----------|------|---------------|------------
-questions | array | *undefined* | An array of objects, each object represents a question that appears on the screen. Each object contains a prompt, value, required, rows, and columns parameter that will be applied to the question. See examples below for further clarification. `prompt`: Type string, default value of *undefined*. The string is the prompt for the subject to respond to. Each question gets its own response field. `value`: Type string, default value of `""`. The string will create placeholder text in the text field. `required`: Boolean; if `true` then the user must enter a response to submit. `rows`: Type integer, default value of 1. The number of rows for the response text box. `columns`: Type integer, default value of 40. The number of columns for the response text box. `name`: Name of the question. Used for storing data. If left undefined then default names (`Q0`, `Q1`, `...`) will be used for the questions.
-randomize_question_order | boolean | `false` | If true, the display order of `questions` is randomly determined at the start of the trial. In the data object, `Q0` will still refer to the first question in the array, regardless of where it was presented visually.
-preamble | string | empty string | HTML formatted string to display at the top of the page above all the questions.
-button_label | string |  'Continue' | The text that appears on the button to finish the trial.
-autocomplete | boolean | false | This determines whether or not all of the input elements on the page should allow autocomplete. Setting this to true will enable autocomplete or auto-fill for the form.
-
-## Data Generated
-
-In addition to the [default data collected by all plugins](/overview/plugins#data-collected-by-all-plugins), this plugin collects the following data for each trial.
-
-Name | Type | Value
------|------|------
-response | object | An object containing the response for each question. The object will have a separate key (variable) for each question, with the first question in the trial being recorded in `Q0`, the second in `Q1`, and so on. For each question, the response is a string containing whatever text was in the response box when the responses were submitted. If the `name` parameter is defined for the question, then the response object will use the value of `name` as the key for each question. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-rt | numeric | The response time in milliseconds for the subject to make a response. The time is measured from when the questions first appear on the screen until the subject's response(s) were submitted. |
-question_order | array | An array with the order of questions. For example `[2,0,1]` would indicate that the first question was `trial.questions[2]` (the third item in the `questions` parameter), the second question was `trial.questions[0]`, and the final question was `trial.questions[1]`. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-
-## Examples
-
-### Basic example
-
-```javascript
-var survey_trial = {
-  type: 'survey-text',
-  questions: [
-    {prompt: "How old are you?"}, 
-    {prompt: "Where were you born?", placeholder: "City, State/Province, Country"}
-  ],
-};
-```
-
-### Custom number of rows and columns
-
-```javascript
-var survey_trial = {
-  type: 'survey-text',
-  questions: [
-    {prompt: "How old are you?", rows: 5, columns: 40}, 
-    {prompt: "Where were you born?", rows: 3, columns: 50}
-  ],
-};
-```
-
-### Defining the name of questions
-
-```javascript
-var survey_trial = {
-  type: 'survey-text',
-  questions: [
-    {prompt: "How old are you?", name: 'Age'}, 
-    {prompt: "Where were you born?", name: 'BirthLocation'}
-  ],
-};
-```

package/docs/plugins/jspsych-video-button-response.md

@@ -1,54 +0,0 @@
-# jspsych-video-button-response plugin
-
-This plugin plays a video and records responses generated by button click. The stimulus can be displayed until a response is given, or for a pre-determined amount of time. The trial can be ended automatically when the subject responds, when the video file has finished playing, or if the subject has failed to respond within a fixed length of time. You can also prevent a button response from being made before the video has finished playing. The button itself can be customized using HTML formatting.
-
-Video files can be automatically preloaded by jsPsych using the [`preload` plugin](jspsych-preload.md). However, if you are using timeline variables or another dynamic method to specify the video stimulus, you will need to [manually preload](/overview/media-preloading/#manual-preloading) the videos. Also note that video preloading is disabled when the experiment is running as a file (i.e. opened directly in the browser, rather than through a server), in order to prevent CORS errors - see the section on [Running Experiments](/overview/running-experiments.md) for more information.
-
-## Parameters
-
-In addition to the [parameters available in all plugins](/overview/plugins#parameters-available-in-all-plugins), this plugin accepts the following parameters. Parameters with a default value of *undefined* must be specified. Other parameters can be left unspecified if the default value is acceptable.
-
-Parameter | Type | Default Value | Description
-----------|------|---------------|------------
-stimulus | array | *undefined* | An array of file paths to the video. You can specify multiple formats of the same video (e.g., .mp4, .ogg, .webm) to maximize the [cross-browser compatibility](https://developer.mozilla.org/en-US/docs/Web/HTML/Supported_media_formats). Usually .mp4 is a safe cross-browser option. The plugin does not reliably support .mov files. The player will use the first source file in the array that is compatible with the browser, so specify the files in order of preference.
-choices | array of strings | *undefined* | Labels for the buttons. Each different string in the array will generate a different button.
-button_html | HTML string | `'<button class="jspsych-btn">%choice%</button>'` | A template of HTML for generating the button elements. You can override this to create customized buttons of various kinds. The string `%choice%` will be changed to the corresponding element of the `choices` array. You may also specify an array of strings, if you need different HTML to render for each button. If you do specify an array, the `choices` array and this array must have the same length. The HTML from position 0 in the `button_html` array will be used to create the button for element 0 in the `choices` array, and so on.
-margin_vertical | string | '0px' | Vertical margin of the button(s).
-margin_horizontal | string | '8px' | Horizontal margin of the button(s).
-prompt | string | null | This string can contain HTML markup. Any content here will be displayed below the stimulus. The intention is that it can be used to provide a reminder about the action the subject is supposed to take (e.g., which key to press).
-width | numeric | width of the video file | The width of the video display in pixels.
-height | numeric | heigh of the video file | The height of the video display in pixels.
-autoplay | boolean | true | If true, the video will begin playing as soon as it has loaded.
-controls | boolean | false | If true, controls for the video player will be available to the subject. They will be able to pause the video or move the playback to any point in the video.
-start | numeric | null | If given a value, the video will start at this time point in seconds.
-stop| numeric | null | If given a value, the video will stop at this time point in seconds.
-rate | numeric | null | The playback rate of the video. 1 is normal, <1 is slower, >1 is faster.
-trial_ends_after_video | bool | false | If true, then the trial will end as soon as the video file finishes playing.
-trial_duration | numeric | null | How long to wait for the subject to make a response before ending the trial in milliseconds. If the subject fails to make a response before this timer is reached, the subject's response will be recorded as null for the trial and the trial will end. If the value of this parameter is null, then the trial will wait for a response indefinitely.
-response_ends_trial | boolean | true | If true, then the trial will end whenever the subject makes a response (assuming they make their response before the cutoff specified by the `trial_duration` parameter). If false, then the trial will continue until the value for `trial_duration` is reached. You can set this parameter to `false` to force the subject to view a stimulus for a fixed amount of time, even if they respond before the time is complete.
-response_allowed_while_playing | boolean | true | If true, then responses are allowed while the video is playing. If false, then the video must finish playing before the button choices are enabled and a response is accepted. Once the video has played all the way through, the buttons are enabled and a response is allowed (including while the video is being re-played via on-screen playback controls). 
-
-
-## Data Generated
-
-In addition to the [default data collected by all plugins](/overview/plugins#data-collected-by-all-plugins), this plugin collects the following data for each trial.
-
-Name | Type | Value
------|------|------
-response | numeric | Indicates which button the subject pressed. The first button in the `choices` array is 0, the second is 1, and so on. 
-rt | numeric | The response time in milliseconds for the subject to make a response. The time is measured from when the stimulus first appears on the screen until the subject's response. 
-stimulus | array | The `stimulus` array. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. 
-
-## Example
-
-```javascript
-var trial = {
-	type: 'video-button-response',
-	stimulus: [
-		'video/sample_video.mp4',
-		'video/sample_video.ogg'
-	],
-	choices: ['Happy','Sad','Angry','Peaceful'],
-	prompt: '<p>Which emotion the best descriptor of the main character\'s feelings?</p>'
-}
-```

package/docs/plugins/jspsych-video-keyboard-response.md

@@ -1,50 +0,0 @@
-# jspsych-video-keyboard-response plugin
-
-This plugin plays a video file and records a keyboard response. The stimulus can be displayed until a response is given, or for a pre-determined amount of time. The trial can be ended automatically when the subject responds, when the video file has finished playing, or if the subject has failed to respond within a fixed length of time. You can also prevent a keyboard response from being recorded before the video has finished playing.
-
-Video files can be automatically preloaded by jsPsych using the [`preload` plugin](jspsych-preload.md). However, if you are using timeline variables or another dynamic method to specify the video stimulus, you will need to [manually preload](/overview/media-preloading/#manual-preloading) the videos. Also note that video preloading is disabled when the experiment is running as a file (i.e. opened directly in the browser, rather than through a server), in order to prevent CORS errors - see the section on [Running Experiments](/overview/running-experiments.md) for more information.
-
-## Parameters
-
-In addition to the [parameters available in all plugins](/overview/plugins#parameters-available-in-all-plugins), this plugin accepts the following parameters. Parameters with a default value of *undefined* must be specified. Other parameters can be left unspecified if the default value is acceptable.
-
-| Parameter                      | Type             | Default Value           | Description                              |
-| ------------------------------ | ---------------- | ----------------------- | ---------------------------------------- |
-| stimulus                       | array            | *undefined*             | An array of file paths to the video. You can specify multiple formats of the same video (e.g., .mp4, .ogg, .webm) to maximize the [cross-browser compatibility](https://developer.mozilla.org/en-US/docs/Web/HTML/Supported_media_formats). Usually .mp4 is a safe cross-browser option. The plugin does not reliably support .mov files. The player will use the first source file in the array that is compatible with the browser, so specify the files in order of preference. |
-| prompt                         | string           | null                    | This string can contain HTML markup. Any content here will be displayed below the stimulus. The intention is that it can be used to provide a reminder about the action the subject is supposed to take (e.g., which key to press). |
-| width                          | numeric          | width of the video file | The width of the video display in pixels. |
-| height                         | numeric          | heigh of the video file | The height of the video display in pixels. |
-| autoplay                       | boolean          | true                    | If true, the video will begin playing as soon as it has loaded. |
-| controls                       | boolean          | false                   | If true, controls for the video player will be available to the subject. They will be able to pause the video or move the playback to any point in the video. |
-| start                          | numeric          | null                    | If given a value, the video will start at this time point in seconds. |
-| stop                           | numeric          | null                    | If given a value, the video will stop at this time point in seconds. |
-| rate                           | numeric          | null                    | The playback rate of the video. 1 is normal, <1 is slower, >1 is faster. |
-| choices                        | array of strings | `jsPsych.ALL_KEYS`      | This array contains the key(s) that the subject is allowed to press in order to respond to the stimulus. Keys should be specified as characters (e.g., `'a'`, `'q'`, `' '`, `'Enter'`, `'ArrowDown'`) - see [this page](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values) and [this page (event.key column)](https://www.freecodecamp.org/news/javascript-keycode-list-keypress-event-key-codes/) for more examples. Any key presses that are not listed in the array will be ignored. 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. |
-| trial_ends_after_video         | bool             | false                   | If true, then the trial will end as soon as the video file finishes playing. |
-| trial_duration                 | numeric          | null                    | How long to wait for the subject to make a response before ending the trial in milliseconds. If the subject fails to make a response before this timer is reached, the subject's response will be recorded as null for the trial and the trial will end. If the value of this parameter is null, then the trial will wait for a response indefinitely. |
-| response_ends_trial            | boolean          | true                    | If true, then the trial will end whenever the subject makes a response (assuming they make their response before the cutoff specified by the `trial_duration` parameter). If false, then the trial will continue until the value for `trial_duration` is reached. You can set this parameter to `false` to force the subject to view a stimulus for a fixed amount of time, even if they respond before the time is complete. |
-| response_allowed_while_playing | boolean          | true                    | If true, then responses are allowed while the video is playing. If false, then the video must finish playing before a keyboard response is accepted. Once the video has played all the way through, a valid keyboard response is allowed (including while the video is being re-played via on-screen playback controls). |
-
-## Data Generated
-
-In addition to the [default data collected by all plugins](/overview/plugins#data-collected-by-all-plugins), this plugin collects the following data for each trial.
-
-| Name      | Type    | Value                                    |
-| --------- | ------- | ---------------------------------------- |
-| response  | string | Indicates which key the subject pressed. |
-| rt        | numeric | The response time in milliseconds for the subject to make a response. The time is measured from when the stimulus first appears on the screen until the subject's response. |
-stimulus | array | The `stimulus` array. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. |
-
-## Example
-
-```javascript
-var trial = {
-	type: 'video-keyboard-response',
-	stimulus: [
-		'video/sample_video.mp4',
-		'video/sample_video.ogg'
-	],
-	choices: ['y','n'],
-	width: 640
-}
-```

package/docs/plugins/jspsych-video-slider-response.md

@@ -1,60 +0,0 @@
-# jspsych-video-slider-response plugin
-
-This plugin plays a video and allows the subject to respond by dragging a slider. The stimulus can be displayed until a response is given, or for a pre-determined amount of time. The trial can be ended automatically when the subject responds, when the video file has finished playing, or if the subject has failed to respond within a fixed length of time. You can also prevent the slider response from being made before the video has finished playing.
-
-Video files can be automatically preloaded by jsPsych using the [`preload` plugin](jspsych-preload.md). However, if you are using timeline variables or another dynamic method to specify the video stimulus, you will need to [manually preload](/overview/media-preloading/#manual-preloading) the videos. Also note that video preloading is disabled when the experiment is running as a file (i.e. opened directly in the browser, rather than through a server), in order to prevent CORS errors - see the section on [Running Experiments](/overview/running-experiments.md) for more information.
-
-## Parameters
-
-In addition to the [parameters available in all plugins](/overview/plugins#parameters-available-in-all-plugins), this plugin accepts the following parameters. Parameters with a default value of *undefined* must be specified. Other parameters can be left unspecified if the default value is acceptable.
-
-Parameter | Type | Default Value | Description
-----------|------|---------------|------------
-stimulus | array | *undefined* | An array of file paths to the video. You can specify multiple formats of the same video (e.g., .mp4, .ogg, .webm) to maximize the [cross-browser compatibility](https://developer.mozilla.org/en-US/docs/Web/HTML/Supported_media_formats). Usually .mp4 is a safe cross-browser option. The plugin does not reliably support .mov files. The player will use the first source file in the array that is compatible with the browser, so specify the files in order of preference.
-prompt | string | null | This string can contain HTML markup. Any content here will be displayed below the stimulus. The intention is that it can be used to provide a reminder about the action the subject is supposed to take (e.g., which key to press).
-width | numeric | width of the video file | The width of the video display in pixels.
-height | numeric | heigh of the video file | The height of the video display in pixels.
-autoplay | boolean | true | If true, the video will begin playing as soon as it has loaded.
-controls | boolean | false | If true, controls for the video player will be available to the subject. They will be able to pause the video or move the playback to any point in the video.
-start | numeric | null | If given a value, the video will start at this time point in seconds.
-stop| numeric | null | If given a value, the video will stop at this time point in seconds.
-rate | numeric | null | The playback rate of the video. 1 is normal, <1 is slower, >1 is faster.
-min | integer | 0 | Sets the minimum value of the slider.
-max | integer | 100 | Sets the maximum value of the slider.
-slider_start | integer | 50 | Sets the starting value of the slider
-step | integer | 1 | Sets the step of the slider. This is the smallest amount by which the slider can change.
-labels | array of strings | [] | Labels displayed at equidistant locations on the slider. For example, two labels will be placed at the ends of the slider. Three labels would place two at the ends and one in the middle. Four will place two at the ends, and the other two will be at 33% and 67% of the slider width.
-slider_width | integer | null | Set the width of the slider in pixels. If left null, then the width will be equal to the widest element in the display.
-require_movement | boolean | false | If true, the subject must move the slider before clicking the continue button.
-button_label | string | 'Continue' | Label of the button to end the trial.
-trial_ends_after_video | bool | false | If true, then the trial will end as soon as the video file finishes playing.
-trial_duration | numeric | null | How long to wait for the subject to make a response before ending the trial in milliseconds. If the subject fails to make a response before this timer is reached, the subject's response will be recorded as null for the trial and the trial will end. If the value of this parameter is null, then the trial will wait for a response indefinitely.
-response_ends_trial | boolean | true | If true, then the trial will end whenever the subject makes a response (assuming they make their response before the cutoff specified by the `trial_duration` parameter). If false, then the trial will continue until the value for `trial_duration` is reached. You can set this parameter to `false` to force the subject to view a stimulus for a fixed amount of time, even if they respond before the time is complete.
-response_allowed_while_playing | boolean | true | If true, then responses are allowed while the video is playing. If false, then the video must finish playing before the slider is enabled and the trial can end via the next button click. Once the video has played all the way through, the slider is enabled and a response is allowed (including while the video is being re-played via on-screen playback controls). 
-
-
-## Data Generated
-
-In addition to the [default data collected by all plugins](/overview/plugins#data-collected-by-all-plugins), this plugin collects the following data for each trial.
-
-Name | Type | Value
------|------|------
-response | numeric | The numeric value of the slider.
-rt | numeric | The response time in milliseconds for the subject to make a response. The time is measured from when the stimulus first appears on the screen until the subject's response.
-stimulus | array | The `stimulus` array. This will be encoded as a JSON string when data is saved using the `.json()` or `.csv()` functions. 
-slider_start | numeric | The starting value of the slider. 
-start | numeric | The start time of the video clip.
-
-## Example
-
-```javascript
-var trial = {
-	type: 'video-slider-response',
-	stimulus: [
-		'video/sample_video.mp4',
-		'video/sample_video.ogg'
-	],
-	labels: ["Did not like", "Liked"],
-	prompt: "<p>Please rate your enjoyment of the video clip.</p>"
-}
-```