溢出层与对话框
溢出层和对话框是置于实验之上的框架,它们在底下的框架和试验变化时仍然保持在屏幕上。正常框架位于试验时间轴中:它在试验到达时出现,并在试验继续时消失。溢出层或对话框则位于时间轴之外。只要其范围持续(一次试验、一次任务或整个会话),它就会被安装,事件可以随时显示或隐藏它。
有两种类型:
- 溢出层: 表现为置于实验之上的层。参与者继续使用底下的实验,只有溢出层上的对象会响应点击。将其用于计时器、分数或进度显示、帮助按钮或任何在试验间保持可见的元素。
- 对话框: 一个位于实验上方的弹出窗口。默认情况下,它会阻挡并暗淡其后面的实验,直到关闭为止。将其用于帮助文本、任务中的指令、确认或条件消息。
创建溢出层和对话框需要Overlays & Dialogs许可功能,从基本许可级别开始包含。使用免费许可证时,点击Canvas或Page在Overlays & Dialogs选项卡中打开许可升级对话框。
添加溢出层或对话框
- 在任务编辑器中打开一个任务。
- 在框架下方的面板中,点击
Overlays & Dialogs选项卡(位于Trial Timeline旁边)。 - 点击
Canvas或Page。
这两个按钮的默认设置不同。你可以在之后更改它们的所有设置。
| 添加方式 | 类型 | 初始状态 | 其他默认设置 | 默认名称 |
|---|---|---|---|---|
Canvas | 溢出层 | Shown | Match task display 尺寸, Transparent (see-through) 填充 | Overlay_1, Overlay_2, 等等 |
Page | 对话框 | Hidden | Centered 位置,阻挡并暗淡其后面的实验,可以拖动,带有关闭按钮 | Dialog_1, Dialog_2, 等等 |
两者都以范围This task开始。新的框架被选中,您可以像任何画布框架或页面框架一样进行编辑:从工具栏添加对象,排列它们,并添加框架事件。该选项卡仅提供Canvas和Page,因此不能将网站框架作为溢出层添加。
要删除溢出层或对话框,请使用Delete Frame图标,在Overlays & Dialogs面板中的条目上。
打开设置
在Overlays & Dialogs面板中选择溢出层或对话框。然后Frame Settings面板(页面的Page Settings面板)会显示一个摘要栏,例如Overlay · task · match task,带有齿轮图标。点击它打开设置弹出窗口。通过点击弹出窗口的标题中的✕或点击外部来关闭弹出窗口。
对于溢出层和对话框,不显示框架设置Duration、Color和Hide Mouse。它们从不自动推进,其背景颜色在弹出窗口中设置,鼠标光标由底下的框架控制。
类型、范围和初始状态
弹出窗口的Type组:
| 设置 | 选项 | 备注 |
|---|---|---|
Type | Overlay (layered on top), Dialog (popup window) | 可以随时更改。Style组会随之变化。 |
Scope | This trial, This task, Whole session | 框架保持安装的时间。请参见范围。每个任务的Whole session溢出层列在Overlays & Dialogs面板中。 |
Initial state | Shown, Hidden | 当框架安装时是否可见。如果事件稍后要显示它,请选择Hidden。 |
Also run trial events on it | 复选框,默认关闭 | 除非需要,否则保持关闭。当它开启时,任务的试验事件将在底下的框架和溢出层上运行,因此可以触发两次。切换则会立即返回。 |
溢出层样式
当Type为Overlay (layered on top)时,这些设置会出现。
| 设置 | 选项 | 备注 |
|---|---|---|
Sizing | Match task display (sits on the frames), Floating (place it yourself) | Match task display 完全按任务框架渲染溢出层,因此当两个框架的大小相同时,框架下的对象与其对齐。Floating 自己放置溢出层框。 |
Anchor(仅浮动) | Top left, Top center, Top right, Middle left, Center, Middle right, Bottom left, Bottom center, Bottom right | 框附着的角落、边缘或中心。默认值Top left。 |
Offset X / Y(仅浮动) | 两个数字,单位为像素 | 距离锚点的距离。默认20和20。 |
Fill | Transparent (see-through), Solid color, Semi-transparent | 溢出层的背景。默认值Transparent (see-through)。 |
Color(实心和半透明) | 颜色选择器 | 填充颜色。 |
Opacity(仅半透明) | 滑块从5%到100% | 默认50%。 |
浮动画布溢出层的大小来自框架自身的Width和Height在框架设置中。由页面构建的浮动溢出层使用500x350像素的框。
溢出层从不阻挡实验。空的、透明的区域允许点击通过到底下的框架,只有溢出层上的对象捕捉到它们。
对话框样式和交互
当Type为Dialog (popup window)时,这些设置会出现。
样式
| 设置 | 选项 | 备注 |
|---|---|---|
Placement | Centered, Pinned to a spot | Centered 将对话框放置在屏幕的中间。 |
Anchor(仅固定) | 与溢出层相同的九个位置 | 对话框与所选角落或边缘保持20像素的距离。 |
Size W / H(页面对话框) | 两个数字,单位为像素 | 默认500和350。页面没有设计大小,所以对话框需要一个。 |
Size(画布对话框) | 显示为“使用框架的宽度和高度” | 对话框使用框架的Width和Height,如果不合适,则按相同比例缩放。 |
Background | 颜色选择器 | 对话框背景。 |
Border | None, Solid | 默认Solid。 |
Rounded corners | 复选框,默认开启 | |
Drop shadow | 复选框,默认开启 | |
Title bar | 复选框,默认关闭 | 在对话框顶部添加一条横杆。 |
Title(带标题栏) | 文本 | 标题栏中的文字。 |
Close button | 复选框,默认开启 | 参与者可以点击以关闭对话框的✕。它位于标题栏中,或在没有标题栏的对话框的右上角。 |
交互
| 设置 | 默认值 | 备注 |
|---|---|---|
Block the experiment behind | 开启 | 参与者在对话框打开时无法点击实验。 |
Dim the experiment behind | 开启 | 使实验在对话框后面变暗。 |
Participant can drag it | 开启 | 允许参与者移动对话框。 |
Close when clicking outside | 关闭 | 当参与者单击对话框以外的区域时关闭对话框。 |
Close on Esc key | 关闭 | 当参与者按下Esc时关闭对话框。 |
关闭对话框会将其隐藏并保持安装,因此其状态将在下次显示时持续存在。
范围
Scope 决定何时安装溢出层或对话框以及何时将其删除。
| 范围 | 安装 | 删除 | 用于 |
|---|---|---|---|
This trial | 当任务开始时,然后在每个试验开始时重新安装 | 当任务结束时 | 每个试验应从头开始的反馈或帮助 |
This task | 当任务开始时 | 当任务结束时 | 一项任务的计时器、分数或进度显示,以及属于一个任务的帮助 |
Whole session | 当第一个任务开始时 | 当会话结束时 | 应该在所有任务中保持的元素,如帮助或暂停按钮 |
每个This trial溢出层在每个试验开始时重置,因此其对象及其状态从头开始。This task和Whole session溢出层在试验和任务之间保持其状态。变量在每个范围内与实验的其余部分共享,因此在溢出层上显示的分数变量保持其值。
溢出层和对话框始终使用默认试验的值。它们不随条件变化。
溢出层和对话框上的事件
溢出层或对话框运行其自己的框架事件,就像任何框架一样。它们每次显示时开始并在隐藏时停止。在溢出层上的键盘触发器也可以在底下的框架运行时工作。
任务的试验事件(Trial Event (on each frame))不会在溢出层上运行,也不会列在它们的事件面板中,除非勾选Also run trial events on it。
使用控制框架显示和隐藏
使用Control Frame操作来显示、隐藏或切换溢出层或对话框。你可以在Control Actions下的添加操作菜单中找到它。
- 在你的试验时间轴中的框架上,或在溢出层本身上打开事件编辑器。
- 添加一个带有任何触发器的事件。
- 添加操作
Control Frame。 - 在
Frame:中选择溢出层或对话框。列表显示所有任务的溢出层和对话框,以及具有Whole session范围的。 - 在
Command:中,选择Show、Hide或Toggle。
如果尚未存在溢出层或对话框,操作会在Overlays & Dialogs选项卡中显示添加一个的提示。目标为另一个任务的This task或This trial溢出层的操作没有效果,因为该溢出层仅在其任务运行时安装。两次在四分之一秒内触发的Toggle命令算作一次,因此触发器火两次不会立即打开和关闭对话框。
示例:单击按钮时显示隐藏的帮助对话框
触发器:
Mouse→Set Target: 你的帮助按钮 →Click
操作:Control Frame→Frame:你的帮助对话框 →Command:Show
示例:从其内部的按钮关闭对话框
在对话框框架上:
触发器:Mouse→Set Target: 它的继续按钮 →Click
操作:Control Frame→Frame:同一对话框 →Command:Hide
常见用例
跨试验的计时器: 添加一个范围为This task的Canvas溢出层,将Sizing设置为Floating (place it yourself),将Anchor设置为Top right,并在其上放置一个计时器对象。通过在溢出层上的On Frame Start事件启动计时器。它会在框架和试验间跳跃时持续运行,直到任务结束。
分数或进度显示: 添加一个范围为Match task display的Canvas溢出层,以及一个显示你的分数变量的Variable对象(工具栏组Text & Code)。变量是共享的,因此每当底下的框架上的事件改变分数时,显示就会更新。
帮助对话框: 添加一个默认隐藏的Page对话框,包含你的指令,并在This task溢出层或框架本身上放置一个帮助按钮。用命令Show的Control Frame操作打开对话框,参与者通过关闭按钮关闭它。
跨任务的暂停消息: 添加一个范围为Whole session的Page对话框,并将Initial state设置为Hidden。在任务结束时用Control Frame显示它,并用对话框内部的继续按钮隐藏它。对于块之间的常规休息,试验时间轴中的正常页面框架通常简单得多。