/**
* 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 += "
"+trial.html_when_wrong+"
";
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;
})();