/**
* jspsych-maxdiff
* Angus Hughes
*
* a jspsych plugin for maxdiff/conjoint analysis designs
*
*/
jsPsych.plugins['maxdiff'] = (function () {
var plugin = {};
plugin.info = {
name: 'maxdiff',
description: '',
parameters: {
alternatives: {
type: jsPsych.plugins.parameterType.STRING,
pretty_name: 'Alternatives',
array: true,
default: undefined,
description: 'Alternatives presented in the Maxdiff table.'
},
labels: {
type: jsPsych.plugins.parameterType.STRING,
array: true,
pretty_name: 'Labels',
default: undefined,
description: 'Labels to display for most or least preferred.'
},
randomize_alternative_order: {
type: jsPsych.plugins.parameterType.BOOL,
pretty_name: 'Randomize alternative Order',
default: false,
description: 'If true, the order of the alternatives will be randomized'
},
preamble: {
type: jsPsych.plugins.parameterType.STRING,
pretty_name: 'Preamble',
default: '',
description: 'String to display at top of the page.'
},
button_label: {
type: jsPsych.plugins.parameterType.STRING,
pretty_name: 'Button label',
default: 'Continue',
description: 'Label of the button.'
},
required: {
type: jsPsych.plugins.parameterType.BOOL,
pretty_name: 'Required',
default: false,
description: 'Makes answering the alternative required.'
}
}
}
plugin.trial = function (display_element, trial) {
// Set some trial parameters
const most_least = ["most", "least"]
var enable_submit = trial.required == true ? 'disabled = "disabled"' : '';
var html = "";
// inject CSS for trial
html += '';
// show preamble text
if (trial.preamble !== null) {
html += '
' + trial.preamble + '
';
}
html += '';
display_element.innerHTML = html;
// function to control responses
// first checks that the same alternative cannot be endorsed as 'most' and 'least' simultaneously.
// then enables the submit button if the trial is required.
most_least.forEach(function(p) {
// Get all elements either 'most' or 'least'
document.getElementsByName(p).forEach(function(alt) {
alt.addEventListener('click', function() {
// Find the opposite (if most, then least & vice versa) identified by the class (jspsych-maxdiff-alt-1, 2, etc)
var op = alt.name == 'most' ? 'least' : 'most';
var n = document.getElementsByClassName(alt.className).namedItem(op);
// If it's checked, uncheck it.
if (n.checked) {
n.checked = false;
}
// check response
if (trial.required){
// Now check if one of both most and least have been enabled to allow submission
var most_checked = [...document.getElementsByName('most')].some(c => c.checked);
var least_checked = [...document.getElementsByName('least')].some(c => c.checked);
if (most_checked && least_checked) {
document.getElementById("jspsych-maxdiff-next").disabled = false;
} else {
document.getElementById("jspsych-maxdiff-next").disabled = true;
}
}
});
});
});
// Get the data once the submit button is clicked
display_element.querySelector('#jspsych-maxdiff-form').addEventListener('submit', function(e){
e.preventDefault();
// measure response time
var endTime = performance.now();
var response_time = endTime - startTime;
// get the alternative number by the data-name attribute
var most = parseInt(display_element.querySelectorAll('[name="most"]:checked')[0].getAttribute('data-name'));
var least = parseInt(display_element.querySelectorAll('[name="least"]:checked')[0].getAttribute('data-name'));
// data saving
var trial_data = {
"rt": response_time,
"most": trial.alternatives[most],
"least": trial.alternatives[least]
};
// next trial
jsPsych.finishTrial(trial_data);
});
var startTime = performance.now();
};
return plugin;
})();