/** * jspsych-image-slider-response * a jspsych plugin for free response survey questions * * Josh de Leeuw * * documentation: docs.jspsych.org * */ jsPsych.plugins['image-slider-response'] = (function() { var plugin = {}; jsPsych.pluginAPI.registerPreload('image-slider-response', 'stimulus', 'image'); plugin.info = { name: 'image-slider-response', description: '', parameters: { stimulus: { type: jsPsych.plugins.parameterType.IMAGE, pretty_name: 'Stimulus', default: undefined, description: 'The image to be displayed' }, stimulus_height: { type: jsPsych.plugins.parameterType.INT, pretty_name: 'Image height', default: null, description: 'Set the image height in pixels' }, stimulus_width: { type: jsPsych.plugins.parameterType.INT, pretty_name: 'Image width', default: null, description: 'Set the image width in pixels' }, maintain_aspect_ratio: { type: jsPsych.plugins.parameterType.BOOL, pretty_name: 'Maintain aspect ratio', default: true, description: 'Maintain the aspect ratio after setting width or height' }, min: { type: jsPsych.plugins.parameterType.INT, pretty_name: 'Min slider', default: 0, description: 'Sets the minimum value of the slider.' }, max: { type: jsPsych.plugins.parameterType.INT, pretty_name: 'Max slider', default: 100, description: 'Sets the maximum value of the slider', }, slider_start: { type: jsPsych.plugins.parameterType.INT, pretty_name: 'Slider starting value', default: 50, description: 'Sets the starting value of the slider', }, step: { type: jsPsych.plugins.parameterType.INT, pretty_name: 'Step', default: 1, description: 'Sets the step of the slider' }, labels: { type: jsPsych.plugins.parameterType.HTML_STRING, pretty_name:'Labels', default: [], array: true, description: 'Labels of the slider.', }, slider_width: { type: jsPsych.plugins.parameterType.INT, pretty_name:'Slider width', default: null, description: 'Width of the slider in pixels.' }, button_label: { type: jsPsych.plugins.parameterType.STRING, pretty_name: 'Button label', default: 'Continue', array: false, description: 'Label of the button to advance.' }, require_movement: { type: jsPsych.plugins.parameterType.BOOL, pretty_name: 'Require movement', default: false, description: 'If true, the participant will have to move the slider before continuing.' }, prompt: { type: jsPsych.plugins.parameterType.STRING, pretty_name: 'Prompt', default: null, description: 'Any content here will be displayed below the slider.' }, 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.' }, response_ends_trial: { type: jsPsych.plugins.parameterType.BOOL, pretty_name: 'Response ends trial', default: true, description: 'If true, trial will end when user makes a response.' }, render_on_canvas: { type: jsPsych.plugins.parameterType.BOOL, pretty_name: 'Render on canvas', default: true, description: 'If true, the image will be drawn onto a canvas element (prevents blank screen between consecutive images in some browsers).'+ 'If false, the image will be shown via an img element.' } } } plugin.trial = function(display_element, trial) { var height, width; var html; // half of the thumb width value from jspsych.css, used to adjust the label positions var half_thumb_width = 7.5; if (trial.render_on_canvas) { var image_drawn = false; // first clear the display element (because the render_on_canvas method appends to display_element instead of overwriting it with .innerHTML) if (display_element.hasChildNodes()) { // can't loop through child list because the list will be modified by .removeChild() while (display_element.firstChild) { display_element.removeChild(display_element.firstChild); } } // create wrapper div, canvas element and image var content_wrapper = document.createElement('div'); content_wrapper.id = "jspsych-image-slider-response-wrapper"; content_wrapper.style.margin = "100px 0px"; var canvas = document.createElement("canvas"); canvas.id = "jspsych-image-slider-response-stimulus"; canvas.style.margin = 0; canvas.style.padding = 0; var ctx = canvas.getContext("2d"); var img = new Image(); img.onload = function() { // if image wasn't preloaded, then it will need to be drawn whenever it finishes loading if (!image_drawn) { getHeightWidth(); // only possible to get width/height after image loads ctx.drawImage(img,0,0,width,height); } }; img.src = trial.stimulus; // get/set image height and width - this can only be done after image loads because uses image's naturalWidth/naturalHeight properties function getHeightWidth() { if (trial.stimulus_height !== null) { height = trial.stimulus_height; if (trial.stimulus_width == null && trial.maintain_aspect_ratio) { width = img.naturalWidth * (trial.stimulus_height/img.naturalHeight); } } else { height = img.naturalHeight; } if (trial.stimulus_width !== null) { width = trial.stimulus_width; if (trial.stimulus_height == null && trial.maintain_aspect_ratio) { height = img.naturalHeight * (trial.stimulus_width/img.naturalWidth); } } else if (!(trial.stimulus_height !== null & trial.maintain_aspect_ratio)) { // if stimulus width is null, only use the image's natural width if the width value wasn't set // in the if statement above, based on a specified height and maintain_aspect_ratio = true width = img.naturalWidth; } canvas.height = height; canvas.width = width; } getHeightWidth(); // call now, in case image loads immediately (is cached) // create container with slider and labels var slider_container = document.createElement('div'); slider_container.classList.add("jspsych-image-slider-response-container"); slider_container.style.position = "relative"; slider_container.style.margin = "0 auto 3em auto"; if(trial.slider_width !== null){ slider_container.style.width = trial.slider_width.toString()+'px'; } // create html string with slider and labels, and add to slider container html =''; html += '