/** * jspsych-iat * Kristin Diep * * plugin for displaying a stimulus and getting a keyboard response * * documentation: docs.jspsych.org * **/ jsPsych.plugins['iat-image'] = (function() { var plugin = {}; jsPsych.pluginAPI.registerPreload('iat-image', 'stimulus', 'image'); plugin.info = { name: 'iat-image', description: '', parameters: { stimulus: { type: jsPsych.plugins.parameterType.IMAGE, default: undefined, no_function: false, description: '' }, left_category_key: { type: jsPsych.plugins.parameterType.HTML, default: 'E', no_function: false, description: '' }, right_category_key: { type: jsPsych.plugins.parameterType.STRING, default: 'I', no_function: false, description: '' }, left_category_label: { type: jsPsych.plugins.parameterType.STRING, array: true, default: ['left'], no_function: false, description: '' }, right_category_label: { type: jsPsych.plugins.parameterType.STRING, array: true, default: ['right'], no_function: false, description: '' }, key_to_move_forward: { type: jsPsych.plugins.parameterType.KEYCODE, array: true, default: jsPsych.ALL_KEYS, no_function: false, description: '' }, display_feedback: { type: jsPsych.plugins.parameterType.BOOL, default: false, no_function: false, description: '' }, html_when_wrong: { type: jsPsych.plugins.parameterType.HTML_STRING, default: 'X', no_function: false, description: '' }, bottom_instructions: { type: jsPsych.plugins.parameterType.HTML_STRING, default: '

If you press the wrong key, a red X will appear. Press any key to continue.

', no_function: false, description: '' }, force_correct_key_press: { type: jsPsych.plugins.parameterType.BOOL, default: false, no_function: false, description: '' }, stim_key_association: { type: jsPsych.plugins.parameterType.HTML, default: 'undefined', no_function: false, description: '' }, response_ends_trial: { type: jsPsych.plugins.parameterType.BOOL, default: true, no_function: false, description: '' }, timing_response: { type: jsPsych.plugins.parameterType.INT, default: -1, no_function: false, description: '' }, } } plugin.trial = function(display_element, trial) { // set default values for the parameters trial.left_category_key = trial.left_category_key || 'E'; trial.right_category_key = trial.right_category_key || 'I'; trial.left_category_label = trial.left_category_label || ['left']; trial.right_category_label = trial.right_category_label || ['right']; trial.key_to_move_forward = trial.key_to_move_forward || jsPsych.ALL_KEYS; trial.display_feedback = typeof trial.display_feedback == 'undefined' ? false : trial.display_feedback; trial.html_when_wrong = trial.html_when_wrong || 'X'; trial.bottom_instructions = trial.bottom_instructions || "

If you press the wrong key, a red X will appear. Press any key to continue.

"; trial.force_correct_key_press = trial.force_correct_key_press || false; //If true, key_to_move_forward is no longer needed trial.stim_key_association = trial.stim_key_association || 'undefined'; trial.response_ends_trial = (typeof trial.response_ends_trial == 'undefined') ? true : trial.response_ends_trial; trial.trial_duration = trial.trial_duration || -1; trial.key_to_move_forward = trial.key_to_move_forward || jsPsych.ALL_KEYS; var html_str = ""; html_str += "
"; html_str += "
"; if(trial.left_category_label.length == 1) { html_str += "

Press " + trial.left_category_key + " for:
" + trial.left_category_label[0].bold() + "

"; } else { html_str += "

Press " + trial.left_category_key + " for:
" + trial.left_category_label[0].bold() + "
" + "or
" + trial.left_category_label[1].bold() + "

"; } html_str += "
"; if(trial.right_category_label.length == 1) { html_str += "

Press " + trial.right_category_key + " for:
" + trial.right_category_label[0].bold() + '

'; } else { html_str += "

Press " + trial.right_category_key + " for:
" + trial.right_category_label[0].bold() + "
" + "or
" + trial.right_category_label[1].bold() + "

"; } html_str += "
"; if(trial.display_feedback === true) { html_str += ""; html_str += "
"+trial.bottom_instructions+"
"; } else { html_str += "
"+trial.bottom_instructions+"
"; } html_str += "
"; display_element.innerHTML = html_str; // store response var response = { rt: -1, key: -1, correct: false }; // 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, "correct": response.correct }; // clears the display display_element.innerHTML = ''; // move on to the next trial jsPsych.finishTrial(trial_data); }; var leftKeyCode = jsPsych.pluginAPI.convertKeyCharacterToKeyCode(trial.left_category_key); var rightKeyCode = jsPsych.pluginAPI.convertKeyCharacterToKeyCode(trial.right_category_key); // function to handle responses by the subject var after_response = function(info) { var wImg = document.getElementById("wrongImgContainer"); // 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-iat-stim').className += ' responded'; // only record the first response if (response.key == -1 ) { response = info; } if(trial.stim_key_association == "right") { if(response.rt > -1 && response.key == rightKeyCode) { response.correct = true; if (trial.response_ends_trial) { end_trial(); } } else { response.correct = false; if(!trial.response_ends_trial && trial.display_feedback == true) { wImg.style.visibility = "visible"; } if (trial.response_ends_trial && trial.display_feedback == true) { wImg.style.visibility = "visible"; if(trial.force_correct_key_press) { var keyListener = jsPsych.pluginAPI.getKeyboardResponse({ callback_function: end_trial, valid_responses: [trial.right_category_key] }); } else { var keyListener = jsPsych.pluginAPI.getKeyboardResponse({ callback_function: end_trial, valid_responses: trial.key_to_move_forward });} } else if(trial.response_ends_trial && trial.display_feedback != true) { var keyListener = jsPsych.pluginAPI.getKeyboardResponse({ callback_function: end_trial, valid_responses: [jsPsych.ALL_KEYS] }); } else if(!trial.response_ends_trial && trial.display_feedback != true) { } } } else if(trial.stim_key_association == "left") { if(response.rt > -1 && response.key == leftKeyCode) { response.correct = true; if (trial.response_ends_trial) { end_trial(); } } else { response.correct = false; if(!trial.response_ends_trial && trial.display_feedback == true) { wImg.style.visibility = "visible"; } if (trial.response_ends_trial && trial.display_feedback == true) { wImg.style.visibility = "visible"; if(trial.force_correct_key_press) { var keyListener = jsPsych.pluginAPI.getKeyboardResponse({ callback_function: end_trial, valid_responses: [trial.left_category_key] }); } else { var keyListener = jsPsych.pluginAPI.getKeyboardResponse({ callback_function: end_trial, valid_responses: trial.key_to_move_forward });} } else if(trial.response_ends_trial && trial.display_feedback != true) { var keyListener = jsPsych.pluginAPI.getKeyboardResponse({ callback_function: end_trial, valid_responses: [jsPsych.ALL_KEYS] }); } else if(!trial.response_ends_trial && trial.display_feedback != true) { } } } }; // start the response listener if (trial.left_category_key != jsPsych.NO_KEYS && trial.right_category_key != jsPsych.NO_KEYS) { var keyboardListener = jsPsych.pluginAPI.getKeyboardResponse({ callback_function: after_response, valid_responses: [trial.left_category_key, trial.right_category_key], rt_method: 'date', persist: false, allow_held_key: false }); } // end trial if time limit is set if (trial.trial_duration > 0 && trial.response_ends_trial != true) { jsPsych.pluginAPI.setTimeout(function() { end_trial(); }, trial.trial_duration); } }; return plugin; })();