Labvanced 实验编辑器中的输入对象。

输入对象

输入对象在实验中收集参与者的自由格式响应。它支持五种输入类型：数字、文本、日期、时间和颜色。响应存储在关联变量中，并在每次试验结束时自动记录。您可以配置验证规则，在参与者开始输入之前显示占位符文本以引导他们，并通过事件控制此元素。

目录

添加输入对象

在任务编辑器工具栏中，打开 Question Inputs 组并选择 Input 以将输入对象添加到当前帧。

添加元素后，Labvanced 会提示您命名将存储参与者响应的变量。给它一个描述性的名称，以反映所收集的数据（例如，response_text 或 age）。

输入类型

在 对象属性 面板中选择输入类型。链接变量的数据类型会自动设置为匹配。

输入类型变量数据类型注释
number数字接受整数和小数。可用最小/最大值验证。
text字符串接受任何文本。可用字符长度验证。
date日期时间显示日期选择器。可配置日期格式。
time时间显示时间选择器。
color字符串显示颜色选择器。将选定的颜色值存储为字符串。

属性

属性默认值描述
Show Question Header开显示输入字段上方的问题文本标签。
Show Placeholder关启用时，在参与者开始输入之前在字段内显示占位符文本。仅适用于 number 和 text 类型。
Placeholder(空)占位符文本。仅在 Show Placeholder 开启时在面板中可见。
Required关启用时，参与者在字段包含有效值之前无法提交帧或问卷页面。
Input typenumber显示给参与者的输入字段类型。选项：number, text, date, time, color。
Focusedfalse设置为 true 时，将键盘焦点移动到此字段。可以通过事件系统按试验配置。
Min-Value(无)仅适用于 number 类型。最低接受值。
Max-Value(无)仅适用于 number 类型。最高接受值。
Min-Nr-Chars(无)仅适用于 text 类型。所需的最小字符数。
Max-Nr-Chars(无)仅适用于 text 类型。允许的最大字符数。
Date Formatbrowser-locale仅适用于 date 类型。控制日期的显示和输入方式。选项：browser-locale, yyyy-mm-dd, dd.mm.yyyy, mm/dd/yyyy。仅在输入类型设置为 date 时在面板中可见。

占位符文本

当输入字段为空时，占位符文本会出现在字段内，参与者开始输入之前。参与者一开始输入值时，它会立即消失。

要启用它：

  1. 在对象属性面板中，启用 Enable Placeholder。
  2. 在 Placeholder Text 字段中输入所需文本。

使用占位符文本为参与者提供格式提示（例如，Enter a number between 1 and 100）或简短说明，而不占用字段上方的空间。

Note: 占位符文本不会被记录为响应。它仅用于显示，不会影响变量值。

验证

输入对象包含内置验证选项，以确保参与者在继续之前提供可用数据。

必填字段： 启用 Is Required，以防止在字段包含有效和非空值之前提交帧或页面。如果参与者尝试在未填写必填字段的情况下继续，该字段会被高亮显示。

数字范围： 对于 number 输入，设置 Min Value 和 Max Value 来限制接受的条目。如果参与者输入的值超出范围，然后离开字段，该值会自动纠正为最近边界。

字符长度： 对于 text 输入，设置 Min Nr Chars 和 Max Nr Chars 来强制执行长度限制。当 Is Required 启用时会进行检查。

变量集成

每个输入对象都链接到一个全局变量，在您添加元素时创建。该变量存储参与者的当前响应值，并在试验结束时记录。

变量数据类型会基于所选的输入类型自动设置：

  • number → 数字变量
  • text → 字符串变量
  • date → 日期时间变量
  • time → 时间变量
  • color → 字符串变量

要将元素重新链接到不同的变量，请在对象属性面板中使用变量选择器。

事件集成

输入对象以两种方式与事件配合使用：作为触发器目标和作为动作目标。

从输入对象触发事件

当参与者在输入字段获得焦点时按 Enter 或 Return 键时，触发器 Enter On Input 会触发。在触发器配置中将输入对象添加到 Targets: 下。

示例：当参与者按 Enter 时提交帧

触发器： Enter On Input → Targets：添加您的输入对象 动作： Jump to Next Frame

通过动作控制输入对象

可通过 Set Object Property 动作在运行时修改两个属性：

可修改属性描述
Focused设置为 true 时，以编程方式将焦点移动到输入字段。
required可以在运行时切换，以根据先前的参与者响应有条件地要求该字段。

示例：当帧开始时聚焦输入字段

触发器： On Frame Start动作： Set Object Property → Set Target：您的输入对象 → 属性：Focused → 值：true

示例：根据先前的响应使字段必填

触发器： Variable Value Changed → 您的条件变量 动作： Set Object Property → Set Target：您的输入对象 → 属性：required → 值：true

您还可以在任何事件动作中从链接的变量读取当前响应值，例如，根据参与者输入的内容进行实验流程分支。

进一步阅读

Labvanced 中事件系统的插图，用于在运行时设置对象属性，如聚焦和必填

事件系统

触发器和动作的结构。涵盖在运行时设置对象属性，包括输入对象的聚焦和必填控件。

处理变量

处理变量

如何创建、配置和记录变量。涵盖适用于输入对象响应的数据类型、记录选项和验证设置。

变量类型

变量类型

Labvanced 中所有变量类型的概述。帮助您理解为什么每种输入类型链接到不同的变量数据类型。