canvas-slider-response¶

这一插件的作用是在HTML canvas元素上绘制刺激，并通过拖动滑动条的方式记录被试反应。canvas元素对于呈现动态、随参数变化的图形以及控制多个图形元素（图形、文字、图像）的位置十分有用。试次可以在被试做反应时结束，或持续事先设定好的时长。如果被试在规定时间内没有做反应，试次可以自动结束。

参数¶

除了适用于所有插件的参数，当前插件还接受以下参数。我们必须对默认值为 undefined 的参数进行赋值，而对于其他参数，如果不需要则不用进行赋值。

参数	类型	默认值	描述
stimulus	函数	undefined	在canvas上绘图的函数。该函数唯一的参数是一个canvas元素，例如`function(c) {...}`或`function drawStim(c) {...}`，这里`c`指的是一个canvas元素。注意，当前函数中仍然需要设定正确的context，如`let ctx = c.getContext("2d")`。
canvas_size	数组	[500, 500]	定义canvas元素大小的数组，单位为像素。数组的第一个元素是canvas元素的高，第二个元素是canvas元素的宽。
labels	字符串数组	[]	滑动条上显示等距显示的标签。例如，如果有2个标签，则会呈现在滑动条的两端；如果有3个标签，则两个会呈现在滑动条的两端，另一个呈现在滑动条的中间；如果有4个标签，则两个会呈现在滑动条的两端，另外两个会在滑动条宽度33%和67%的位置。
button_label	字符串	'Continue'	结束当前试次的按钮的文字。
min	整数	0	滑动条最小值。
max	整数	100	滑动条最大值。
slider_start	整数	50	滑动条起始值。
step	整数	1	滑动条步长，即滑块改变的最小值。
slider_width	整数	null	滑动条宽度的像素值。如果为`null`，则其宽度和呈现的最宽的元素相等。
require_movement	布尔	false	如果为true，则被试在点击继续前必须移动滑动条。
prompt	字符串	null	可以包含HTML元素。该参数的内容会在`stimulus`下面进行呈现，从而起到提示被试该做什么的作用（例如：该按哪个/些键）。
stimulus_duration	数值	null	呈现刺激的毫秒数。在超过这个时间后，CSS的`visibility`属性会被设置为`hidden`。如果当前参数值为`null`，则刺激会在试次结束后才消失。
trial_duration	数值	null	允许被试做反应的时间限制。如果被试在设定的时间内没有做反应，那么其反应会被记为`null`，试次会在超出时间后结束。如果当前参数值为`null`，则试次会一直等待被试做反应。
response_ends_trial	布尔	true	如果为true，则当前试次会在被试做出反应时结束（假定被试是在`trial_duration`指定的时间范围内做出的反应）如果为false，则当前试次会持续到`trial_duration`指定的时间才结束。你可以把当前参数设置为`false`以让被试即便提前做了反应，看当前刺激的时间也要达到固定的时长。

数据¶

除了所有插件默认都会收集的数据，当前插件还会记录以下数据。

名称	类型	值
response	数值	滑动条的数值。
rt	数值	反应时（单位：毫秒），从刺激播放开始计时，到被试做出反应结束。

注意：这里没有记录stimulus因为它是一个函数。如果stimulus中有什么是你需要记录的，可以通过data参数进行添加。

示例¶

绘制两个正方形

Code

var colors = ['#FF3333', '#FF6A33'];

function twoSquares(c) {    
    var ctx = c.getContext('2d');
    ctx.fillStyle = colors[0];
    ctx.fillRect(200, 70, 40, 40);
    ctx.fillStyle = colors[1];
    ctx.fillRect(260, 70, 40, 40);
}

var trial = {
    type: jsPsychCanvasSliderResponse,
    stimulus: twoSquares,
    labels: ['0','10'],
    canvas_size: [150, 500],
    prompt: '<p>How different would you say the colors of these two squares are on a scale from 0 (the same) to 10 (completely different)</p>',
    data: {color1: colors[0], color2: colors[1]}
}

Demo

在新标签页中打开

绘制两个正方形并添加额外的参数

Code

var colors;

function twoSquares(c, colors) {
    var ctx = c.getContext('2d');
    ctx.fillStyle = colors[0];
    ctx.fillRect(200, 70, 40, 40);
    ctx.fillStyle = colors[1];
    ctx.fillRect(260, 70, 40, 40);
}

var trial = {
    type: jsPsychCanvasSliderResponse,
    stimulus: function(c) {
        colors = ['darkred', 'cyan'];
        twoSquares(c, colors);
    },
    labels: ['Exactly<br>the same','Totally<br>different'],
    canvas_size: [200, 500],
    prompt: '<p>How different would you say the colors of these two squares are?</p>',
    on_finish: function(data) {
        data.color1 = colors[0];
        data.color2 = colors[1];
    }
};

Demo

在新标签页中打开