javery-free-sort-my-text.js

/**
 * jspsych-free-sort
 * plugin for drag-and-drop sorting of a collection of images
 * Josh de Leeuw
 *
 * documentation: docs.jspsych.org
 */


jsPsych.plugins['free-sort-my-text'] = (function() {

  var plugin = {};

  jsPsych.pluginAPI.registerPreload('free-sort', 'stimuli', 'image');

  plugin.info = {
    name: 'free-sort',
    description: '',
    parameters: {
      stimuli: {
        type: jsPsych.plugins.parameterType.STRING,
        pretty_name: 'Stimuli',
        default: undefined,
        array: true,
        description: 'Images to be displayed.'
      },
      stim_height: {
        type: jsPsych.plugins.parameterType.INT,
        pretty_name: 'Stimulus height',
        default: 30,
        description: 'Height of images in pixels.'
      },
      stim_width: {
        type: jsPsych.plugins.parameterType.INT,
        pretty_name: 'Stimulus width',
        default: 100,
        description: 'Width of images in pixels'
      },
      sort_area_height: {
        type: jsPsych.plugins.parameterType.INT,
        pretty_name: 'Sort area height',
        default: 400,
        // default: 800,
        description: 'The height of the container that subjects can move the stimuli in.'
      },
      sort_area_width: {
        type: jsPsych.plugins.parameterType.INT,
        pretty_name: 'Sort area width',
        default: 600,
        description: 'The width of the container that subjects can move the stimuli in.'
      },
      full_area_height: {
        type: jsPsych.plugins.parameterType.INT,
        pretty_name: 'Sort area height',
        default: 400,
        description: 'The height of the container that subjects can move the stimuli in.'
      },
      full_area_width: {
        type: jsPsych.plugins.parameterType.INT,
        pretty_name: 'Sort area width',
        default: 800,
        description: 'The width of the container that subjects can move the stimuli in.'
      },
      prompt: {
        type: jsPsych.plugins.parameterType.STRING,
        pretty_name: 'Prompt',
        default: null,
        description: 'It can be used to provide a reminder about the action the subject is supposed to take.'
      },
      prompt_location: {
        type: jsPsych.plugins.parameterType.SELECT,
        pretty_name: 'Prompt location',
        options: ['above','below'],
        default: 'above',
        description: 'Indicates whether to show prompt "above" or "below" the sorting area.'
      },
      button_label: {
        type: jsPsych.plugins.parameterType.STRING,
        pretty_name: 'Button label',
        default:  'Continue',
        description: 'The text that appears on the button to continue to the next trial.'
      },
      order:{
        type: jsPsych.plugins.parameterType.STRING,
        pretty_name: 'order of appearance',
        default:  '',
        description: 'order of appearance in test.'
      },
      trail_label: {
        type: jsPsych.plugins.parameterType.STRING,
        pretty_name: 'Button label',
        default:  'Continue',
        description: 'Label of the button.'
      }
    }
  }

  plugin.trial = function(display_element, trial) {

    var start_time = performance.now();

    var html = "";
    // check if there is a prompt and if it is shown above
    if (trial.prompt !== null && trial.prompt_location == "above") {
      html += trial.prompt;
    }


    html += '<div '+
      'id="jspsych-free-sort-arena-with-text" '+
      'class="jspsych-free-sort-arena" '+
      'style="position: relative; '+
      'background: darkgrey;'+
      'width:'+trial.full_area_width+'px;'+
      'height:'+trial.full_area_height+'px;'+
      'margin: 10px 0px 10px 0px;"'+
      '></div>';

    // check if prompt exists and if it is shown below
    if (trial.prompt !== null && trial.prompt_location == "below") {
      html += trial.prompt;
    }

    display_element.innerHTML = html;

    display_element.querySelector('#jspsych-free-sort-arena-with-text').innerHTML += '<div '+
      'id="jspsych-free-sort-arena" '+
      'class="jspsych-free-sort-arena" '+
      'style="position: relative;'+
      'background: white;'+
      'width:'+trial.sort_area_width+'px;'+
      'height:'+trial.sort_area_height+'px;'+
      'border:2px solid #444;"'+
      '></div>';

    // store initial location data
    var init_locations = [];

    for (var i = 0; i < trial.stimuli.length; i++) {
      var coords = initial_coordinate(i, trial.stim_height);

      display_element.querySelector("#jspsych-free-sort-arena").innerHTML +=
      '<div class="jspsych-free-sort-draggable" '+
      'unselectable="on";'+
      'src="'+trial.stimuli[i]+'" '+
      'onselectstart="return false;"'+
        'draggable="false" '+
        'style="position: absolute;'+
        ' cursor: move;'+
        ' font-family: helvetica;'+
        ' width:'+getTextWidth(trial.stimuli[i], "18px helvetica")+'px;'+ //add some cushion so don't get re-wrapping
        ' height:'+trial.stim_height+'px;'+
        ' top:'+coords.y+'px;'+
        ' left:'+coords.x+'px;'+
        ' color: black;'+
        ' user-select: none;">'
        +trial.stimuli[i]+
        '</div>';

      init_locations.push({
        "word": trial.stimuli[i],
        "x": coords.x,
        "y": coords.y
      });
    }
    // display_element.innerHTML += '<button id="jspsych-free-sort-done-btn" class="jspsych-btn">'+trial.button_label+'</button>';
    display_element.innerHTML += '<button id="jspsych-free-sort-done-btn" class="jspsych-btn" value="disable" disabled>'+trial.button_label+'</button>';

    var maxz = 1;

    var moves = [];

    var draggables = display_element.querySelectorAll('.jspsych-free-sort-draggable');

    for(var i=0;i<draggables.length; i++){
      draggables[i].addEventListener('mousedown', function(event){
        var x = event.pageX - event.currentTarget.offsetLeft;
        var y = event.pageY - event.currentTarget.offsetTop - window.scrollY;
        var elem = event.currentTarget;
        elem.style.zIndex = ++maxz;

        var mousemoveevent = function(e){
          elem.style.top =  Math.min(trial.sort_area_height - trial.stim_height, Math.max(0,(e.clientY - y))) + 'px';
          elem.style.left = Math.min(trial.sort_area_width  - elem.offsetWidth,  Math.max(0,(e.clientX - x))) + 'px';

          // if all elements are withing boundary, enable continue button!
          // get all draggable elements
          var new_draggable_positions = display_element.querySelectorAll('.jspsych-free-sort-draggable');
          // console.log(new_draggable_positions[0].offsetLeft);
          var x_vals = [];

          // get the x values for each draggable
          for(var j = 0; j < new_draggable_positions.length; j++){
            x_vals.push(parseInt(new_draggable_positions[j].offsetLeft));
          }
          // console.log(Math.max.apply(Math,x_vals))
          // get max x val
          var max_x = Math.max.apply(Math,x_vals);
          // console.log(max_x)
          // if max x val is less than width of bounded area, activate button
          if (max_x < trial.sort_area_width) {
            document.getElementById("jspsych-free-sort-done-btn").disabled = false;
          }
        }
        document.addEventListener('mousemove', mousemoveevent);

        var mouseupevent = function(e){
          document.removeEventListener('mousemove', mousemoveevent);
          moves.push({
            "word": elem.textContent,
            // "src": elem.dataset.src,
            "x": elem.offsetLeft,
            "y": elem.offsetTop
          });
          document.removeEventListener('mouseup', mouseupevent);
        }
        document.addEventListener('mouseup', mouseupevent);
      });
    }

    display_element.querySelector('#jspsych-free-sort-done-btn').addEventListener('click', function(){

      var end_time = performance.now();
      var rt = end_time - start_time;
      // gather data
      // get final position of all objects
      var final_locations = [];
      var matches = display_element.querySelectorAll('.jspsych-free-sort-draggable');
      for(var i=0; i<matches.length; i++){
        final_locations.push({
          "word": matches[i].textContent,
          "x": parseInt(matches[i].style.left),
          "y": parseInt(matches[i].style.top)
        });
      }

      var trial_data = {
        "init_locations": JSON.stringify(init_locations),
        "moves": JSON.stringify(moves),
        "final_locations": JSON.stringify(final_locations),
        "rt": rt,
        'order': trial.order,
        'trial_label': trial.trial_label
      };

      // advance to next part
      display_element.innerHTML = '';
      jsPsych.finishTrial(trial_data);
    });

  };

  // helper functions

  function random_coordinate(max_width, max_height) {
    var rnd_x = Math.floor(Math.random() * (max_width - 1));
    var rnd_y = Math.floor(Math.random() * (max_height - 1));

    return {
      x: rnd_x,
      y: rnd_y
    };
  }

  function initial_coordinate(num, height) {
    var rnd_x = 610;
    var rnd_y = num * height;

    return {
      x: rnd_x,
      y: rnd_y
    };
  }

  function getTextWidth(text, font) {
      // re-use canvas object for better performance
      var canvas = getTextWidth.canvas || (getTextWidth.canvas = document.createElement("canvas"));
      var context = canvas.getContext("2d");
      context.font = font;
      var metrics = context.measureText(text);
      return metrics.width + 5;
  }

  return plugin;
})();