输入对象
输入对象在实验中收集参与者的自由格式响应。它支持五种输入类型：数字、文本、日期、时间和颜色。响应存储在一个链接变量中，并在每个试验结束时自动记录。您可以配置验证规则，显示占位符文本以指导参与者开始输入之前进行输入，并通过事件控制该元素。
添加输入对象
在任务编辑器工具栏中，打开Question Inputs组并选择Input以将输入对象添加到当前帧。
当元素添加后，Labvanced会提示您命名将存储参与者响应的变量。给它一个描述性名称，以反映收集的数据（例如，response_text或age）。
输入类型
在对象属性面板中选择输入类型。链接变量的数据类型会自动设置以匹配。
| 输入类型 | 变量数据类型 | 备注 |
|---|---|---|
number | 数值型 | 接受整数和小数。可以进行最小/最大值验证。 |
text | 字符串 | 接受任何文本。字符长度验证可用。 |
date | 日期时间 | 显示日期选择器。日期格式可配置。 |
time | 时间 | 显示时间选择器。 |
color | 字符串 | 显示颜色选择器。将所选颜色值存储为字符串。 |
属性
| 属性 | 默认值 | 描述 |
|---|---|---|
Show Question Header | 开启 | 在输入字段上方显示问题文本标签。 |
Show Placeholder | 关闭 | 启用时，在参与者开始输入之前，在字段内显示占位符文本。仅适用于number和text类型。 |
Placeholder | (空) | 占位符文本。仅在Show Placeholder开启时在面板中可见。 |
Required | 关闭 | 启用时，参与者在该字段包含有效值之前无法提交帧或问卷页面。 |
Input type | number | 显示给参与者的输入字段类型。选项：number, text, date, time, color。 |
Focused | false | 设置为true时，将键盘焦点转移到此字段。可通过事件系统按试验进行配置。 |
Min-Value | (无) | 仅适用于number类型。最低接受值。 |
Max-Value | (无) | 仅适用于number类型。最高接受值。 |
Min-Nr-Chars | (无) | 仅适用于text类型。所需的最小字符数。 |
Max-Nr-Chars | (无) | 仅适用于text类型。允许的最大字符数。 |
Date Format | browser-locale | 仅适用于date类型。控制日期的显示和输入方式。选项：browser-locale, yyyy-mm-dd, dd.mm.yyyy, mm/dd/yyyy。仅在输入类型设置为date时在面板中可见。 |
占位符文本
当输入字段为空时，占位符文本会出现在字段内，参与者开始输入之前。参与者一旦开始输入值，占位符文本将立即消失。
要启用它：
- 在对象属性面板中，启用
Enable Placeholder。 - 在
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
您还可以在任何事件动作中读取链接变量的当前响应值，例如根据参与者输入的内容来分支实验流程。