survey-multi-select plugin¶

这个插件的作用是呈现一系列多选题。被试可以选择多个答案。

参数¶

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

参数	类型	默认值	描述
questions	数组	undefined	数组中的每个元素都是对象，代表了屏幕上呈现的一个问题。每个对象都包含了prompt, options, required, 和horizontal参数，用于对其对应的问题进行设置，详见下面的示例。`prompt`: 类型为字符串，默认值是undefined，这些问题会和一系列选项（多选框）进行绑定。所有问题都呈现在同一页上（同一个试次内）。`options`: 类型为数组，默认值是undefined，数组的每个元素都是字符串，每个元素代表问题下的一个选项。`horizontal`: 类型为布尔，默认值为false。如果为true，则问题居中，所有选项水平排列。`required`: 类型为布尔，默认值为false，指定当前问题是否为必答（true为必答，false为非必答），其实现是通过HTML5中的`required`属性完成的。`name`: 问题的name属性，主要用在数据存储部分。如果不定义，则使用默认名（`Q0`, `Q1`, `...`）。
randomize_question_order	布尔	`false`	如果为true，则`questions`的呈现顺序在试次开始时进行随机。在数据对象中，`Q0`指的还是数组中的第一个问题，不管它在实验中排在第几位。
preamble	字符串	空字符串	呈现在页面顶端、所有问题上方的HTML字符串。
button_label	字符串	'Continue'	按钮的文本。
required_message	字符串	'You must choose at least one response for this question'	必答题没有作答时的提示文本。
autocomplete	布尔	false	页面上的input元素是否允许自动补全。如果该参数为true，则表单元素允许自动填充。

数据¶

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

名称	类型	值
response	对象	记录了所有问题作答情况的对象。对于每一个问题，对象都会添加一个属性，第一个问题记录在`Q0`属性下，第二个问题记录在`Q1`属性下，以此类推。被试的作答以数组形式记录，内容是其选择的所有选项名（字符串）。如果定义了`name`参数，则会使用`name`的值作为当前属性名（而非`Q0`这种形式）。后面使用`.json()`或`.csv()`方法保存数据时，该数组会以JSON形式存储起来。
rt	数值	反应时（单位：毫秒）。问题刚开始出现时开始计时，被试完成作答后结束计时。
question_order	数组	记录问题顺序的数组。例如，`[2,0,1]`代表呈现的第一个问题是`trial.questions[2]` (`questions`参数下的第三个问题), 呈现的第二个问题是`trial.questions[0]`, 呈现的最后一个问题是`trial.questions[1]`。后面使用`.json()`或`.csv()`方法保存数据时，该数组会以JSON形式存储起来。

示例¶

在同一页上呈现多个问题

CodeDemo

var trial = {
  type: jsPsychSurveyMultiSelect,
  questions: [
    {
      prompt: "Which of these colors do you like?", 
      options: ["Red", "Yellow", "Green", "Blue", "Black"], 
      horizontal: true,
      required: true,
      name: 'Colors'
    }, 
    {
      prompt: "Which of these foods do you like?", 
      options: ["Apples", "Bananas", "Carrots", "Donuts", "Eggplant"], 
      horizontal: true,
      required: true,
      name: 'Foods'
    }
  ], 
  randomize_question_order: true
};

在新标签页中打开