mirror of
https://github.com/jspsych/jsPsych.git
synced 2025-05-10 11:10:54 +00:00
155 lines
4.0 KiB
JavaScript
155 lines
4.0 KiB
JavaScript
/**
|
|
* jspsych-html-keyboard-response
|
|
* Josh de Leeuw
|
|
*
|
|
* plugin for displaying a stimulus and getting a keyboard response
|
|
*
|
|
* documentation: docs.jspsych.org
|
|
*
|
|
**/
|
|
|
|
|
|
jsPsych.plugins["html-keyboard-response"] = (function() {
|
|
|
|
var plugin = {};
|
|
|
|
plugin.info = {
|
|
name: 'html-keyboard-response',
|
|
description: '',
|
|
parameters: {
|
|
stimulus: {
|
|
type: [jsPsych.plugins.parameterType.HTML_STRING],
|
|
default: undefined,
|
|
no_function: false,
|
|
description: ''
|
|
},
|
|
choices: {
|
|
type: [jsPsych.plugins.parameterType.KEYCODE],
|
|
array: true,
|
|
default: jsPsych.ALL_KEYS,
|
|
no_function: false,
|
|
description: ''
|
|
},
|
|
prompt: {
|
|
type: [jsPsych.plugins.parameterType.STRING],
|
|
default: '',
|
|
no_function: false,
|
|
description: ''
|
|
},
|
|
stimulus_duration: {
|
|
type: [jsPsych.plugins.parameterType.INT],
|
|
default: -1,
|
|
no_function: false,
|
|
description: ''
|
|
},
|
|
trial_duration: {
|
|
type: [jsPsych.plugins.parameterType.INT],
|
|
default: -1,
|
|
no_function: false,
|
|
description: ''
|
|
},
|
|
response_ends_trial: {
|
|
type: [jsPsych.plugins.parameterType.BOOL],
|
|
default: true,
|
|
no_function: false,
|
|
description: ''
|
|
},
|
|
|
|
}
|
|
}
|
|
|
|
plugin.trial = function(display_element, trial) {
|
|
|
|
// set default values for the parameters
|
|
trial.choices = trial.choices || jsPsych.ALL_KEYS;
|
|
trial.response_ends_trial = (typeof trial.response_ends_trial == 'undefined') ? true : trial.response_ends_trial;
|
|
trial.stimulus_duration = trial.stimulus_duration || -1;
|
|
trial.trial_duration = trial.trial_duration || -1;
|
|
trial.prompt = trial.prompt || "";
|
|
|
|
var new_html = '<div id="jspsych-html-keyboard-response-stimulus">'+trial.stimulus+'</div>';
|
|
|
|
// add prompt
|
|
new_html += trial.prompt;
|
|
|
|
// draw
|
|
display_element.innerHTML = new_html;
|
|
|
|
// store response
|
|
var response = {
|
|
rt: -1,
|
|
key: -1
|
|
};
|
|
|
|
// function to end trial when it is time
|
|
var end_trial = function() {
|
|
|
|
// kill any remaining setTimeout handlers
|
|
jsPsych.pluginAPI.clearAllTimeouts();
|
|
|
|
// kill keyboard listeners
|
|
if (typeof keyboardListener !== 'undefined') {
|
|
jsPsych.pluginAPI.cancelKeyboardResponse(keyboardListener);
|
|
}
|
|
|
|
// gather the data to store for the trial
|
|
var trial_data = {
|
|
"rt": response.rt,
|
|
"stimulus": trial.stimulus,
|
|
"key_press": response.key
|
|
};
|
|
|
|
// clear the display
|
|
display_element.innerHTML = '';
|
|
|
|
// move on to the next trial
|
|
jsPsych.finishTrial(trial_data);
|
|
};
|
|
|
|
// function to handle responses by the subject
|
|
var after_response = function(info) {
|
|
|
|
// after a valid response, the stimulus will have the CSS class 'responded'
|
|
// which can be used to provide visual feedback that a response was recorded
|
|
display_element.querySelector('#jspsych-html-keyboard-response-stimulus').className += ' responded';
|
|
|
|
// only record the first response
|
|
if (response.key == -1) {
|
|
response = info;
|
|
}
|
|
|
|
if (trial.response_ends_trial) {
|
|
end_trial();
|
|
}
|
|
};
|
|
|
|
// start the response listener
|
|
if (trial.choices != jsPsych.NO_KEYS) {
|
|
var keyboardListener = jsPsych.pluginAPI.getKeyboardResponse({
|
|
callback_function: after_response,
|
|
valid_responses: trial.choices,
|
|
rt_method: 'date',
|
|
persist: false,
|
|
allow_held_key: false
|
|
});
|
|
}
|
|
|
|
// hide stimulus if stimulus_duration is set
|
|
if (trial.stimulus_duration > 0) {
|
|
jsPsych.pluginAPI.setTimeout(function() {
|
|
display_element.querySelector('#jspsych-html-keyboard-response-stimulus').style.visibility = 'hidden';
|
|
}, trial.stimulus_duration);
|
|
}
|
|
|
|
// end trial if trial_duration is set
|
|
if (trial.trial_duration > 0) {
|
|
jsPsych.pluginAPI.setTimeout(function() {
|
|
end_trial();
|
|
}, trial.trial_duration);
|
|
}
|
|
|
|
};
|
|
|
|
return plugin;
|
|
})();
|