# html-keyboard-response
Current version: 1.1.2. [See version history](https://github.com/jspsych/jsPsych/blob/main/packages/plugin-html-keyboard-response/CHANGELOG.md).
This plugin displays HTML content and records responses generated with the keyboard.The stimulus can be displayed until a response is given, or for a pre-determined amount of time. The trial can be ended automatically if the participant has failed to respond within a fixed length of time.
{{ plugin_parameters('html-keyboard-response') }}
## Data Generated
In addition to the [default data collected by all plugins](../overview/plugins.md#data-collected-by-all-plugins), this plugin collects the following data for each trial.
| Name | Type | Value |
| --------- | ------- | ---------------------------------------- |
| response | string | Indicates which key the participant pressed. |
| rt | numeric | The response time in milliseconds for the participant to make a response. The time is measured from when the stimulus first appears on the screen until the participant's response. |
| stimulus | string | The HTML content that was displayed on the screen. |
## Install
Using the CDN-hosted JavaScript file:
```js
```
Using the JavaScript file downloaded from a GitHub release dist archive:
```js
```
Using NPM:
```
npm install @jspsych/plugin-html-keyboard-response
```
```js
import htmlKeyboardResponse from '@jspsych/plugin-html-keyboard-response';
```
## Examples
???+ example "Displaying trial until participant gives a response"
=== "Code"
```javascript
var trial = {
type: jsPsychHtmlKeyboardResponse,
stimulus: 'BLUE
',
choices: ['r', 'g', 'b'],
prompt: "Is the ink color (r)ed, (g)reen, or (b)lue?
"
};
```
=== "Demo"
Open demo in new tab
???+ example "Showing a 1 second fixation cross; no response allowed"
=== "Code"
```javascript
var trial = {
type: jsPsychHtmlKeyboardResponse,
stimulus: '+
',
choices: "NO_KEYS",
trial_duration: 1000,
};
```
=== "Demo"
Open demo in new tab