
输入对象
输入对象在实验过程中收集参与者的自由格式响应。它支持五种输入类型:数字、文本、日期、时间和颜色。响应存储在一个关联变量中,并在每次试验结束时自动记录。您可以配置验证规则,显示占位符文本以指导参与者在开始输入前的操作,并通过事件控制该元素。
添加输入对象
在任务编辑工具栏中,打开 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
您还可以在任何事件动作中从链接变量读取当前响应值,例如根据参与者输入的内容分支实验流程。