/** * jspsych-image-button-response * Josh de Leeuw * * plugin for displaying a stimulus and getting a keyboard response * * documentation: docs.jspsych.org * **/ jsPsych.plugins["image-button-response"] = (function() { var plugin = {}; jsPsych.pluginAPI.registerPreload('image-button-response', 'stimulus', 'image'); plugin.info = { name: 'image-button-response', description: '', parameters: { stimulus: { type: jsPsych.plugins.parameterType.IMAGE, pretty_name: 'Stimulus', default: undefined, description: 'The image to be displayed' }, choices: { type: jsPsych.plugins.parameterType.KEYCODE, pretty_name: 'Choices', default: [], array: true, description: 'The labels for the buttons.' }, button_html: { type: jsPsych.plugins.parameterType.STRING, pretty_name: 'Button html', default: '', array: true, description: 'The html of the button. Can create own style.' }, prompt: { type: jsPsych.plugins.parameterType.STRING, pretty_name: 'Prompt', default: null, description: 'Any content here will be displayed under the button.' }, stimulus_duration: { type: jsPsych.plugins.parameterType.INT, pretty_name: 'Stimulus duration', default: null, description: 'How long to hide the stimulus.' }, trial_duration: { type: jsPsych.plugins.parameterType.INT, pretty_name: 'Trial duration', default: null, description: 'How long to show the trial.' }, margin_vertical: { type: jsPsych.plugins.parameterType.STRING, pretty_name: 'Margin vertical', default: '0px', description: 'The vertical margin of the button.' }, margin_horizontal: { type: jsPsych.plugins.parameterType.STRING, pretty_name: 'Margin horizontal', default: '8px', description: 'The horizontal margin of the button.' }, response_ends_trial: { type: jsPsych.plugins.parameterType.BOOL, pretty_name: 'Response ends trial', default: true, description: 'If true, then trial will end when user responds.' }, } } plugin.trial = function(display_element, trial) { if(typeof trial.choices === 'undefined'){ console.error('Required parameter "choices" missing in image-button-response'); } if(typeof trial.stimulus === 'undefined'){ console.error('Required parameter "stimulus" missing in image-button-response'); } // display stimulus var html = ''; //display buttons var buttons = []; if (Array.isArray(trial.button_html)) { if (trial.button_html.length == trial.choices.length) { buttons = trial.button_html; } else { console.error('Error in image-button-response plugin. The length of the button_html array does not equal the length of the choices array'); } } else { for (var i = 0; i < trial.choices.length; i++) { buttons.push(trial.button_html); } } html += '
'; display_element.innerHTML=html; for (var i = 0; i < trial.choices.length; i++) { var str = buttons[i].replace(/%choice%/g, trial.choices[i]); display_element.querySelector('#jspsych-image-button-response-btngroup').insertAdjacentHTML('beforeend', '
'+str+'
'); display_element.querySelector('#jspsych-image-button-response-button-' + i).addEventListener('click', function(e){ var choice = e.currentTarget.getAttribute('data-choice'); // don't use dataset for jsdom compatibility after_response(choice); }); } //show prompt if there is one if (trial.prompt !== null) { display_element.insertAdjacentHTML('beforeend', trial.prompt); } // store response var response = { rt: null, button: null }; // start time var start_time = 0; // function to handle responses by the subject function after_response(choice) { // measure rt var end_time = Date.now(); var rt = end_time - start_time; response.button = choice; response.rt = rt; // 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-image-button-response-stimulus').className += ' responded'; // disable all the buttons after a response var btns = document.querySelectorAll('.jspsych-image-button-response-button button'); for(var i=0; i