オーバーレイとダイアログ
オーバーレイとダイアログは、あなたの実験の上に配置され、下のフレームや試行が変化している間も画面に留まるフレームです。通常のフレームは、試行タイムラインに存在します:試行がそのフレームに達したときに表示され、試行が進むと消えます。オーバーレイやダイアログはタイムラインの外に存在します。そのスコープが続く限り(1試行、1タスクまたはセッション全体)、イベントによっていつでも表示または非表示にできます。
目次
2種類があります:
- オーバーレイ: 実験の上に重ねられます。参加者は下の実験を引き続き使用し、オーバーレイ上のオブジェクトだけがクリックを受け取ります。タイマー、スコアや進捗表示、ヘルプボタン、または試行の間も表示されるべき要素に使用します。
- ダイアログ: 実験の上にポップアップウィンドウがあります。デフォルトでは、閉じるまでその背後の実験をブロックし、暗くします。ヘルプテキスト、タスクの途中での指示、確認、または条件付きメッセージに使用します。
オーバーレイとダイアログを作成するには、Overlays & Dialogsライセンス機能が必要で、これは基本ライセンス階層から含まれています。無料ライセンスでは、CanvasまたはPageをOverlays & Dialogsタブでクリックすると、ライセンスアップグレードダイアログが開きます。
オーバーレイまたはダイアログの追加
- タスクエディタでタスクを開きます。
- フレームの下にあるパネルで、
Overlays & Dialogsタブをクリックします(Trial Timelineの隣)。 CanvasまたはPageをクリックします。
2つのボタンは異なるデフォルトで始まります。後でこれらをすべて変更できます。
| 追加方法 | タイプ | 初期状態 | その他のデフォルト | デフォルト名 |
|---|---|---|---|---|
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 | チェックボックス、デフォルトはオフ | 必要な場合を除いてオフにします。オンにすると、タスクの試行イベントが下のフレームとオーバーレイの両方で実行されるため、2回発生する可能性があります。トグルはその後すぐに元に戻ります。 |
オーバーレイスタイル
これらの設定は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(浮動のみ) | 2つの数字、ピクセル単位 | アンカーからの距離。デフォルトは20と20。 |
Fill | Transparent (see-through), Solid color, Semi-transparent | オーバーレイの背景。デフォルトはTransparent (see-through)。 |
Color(不透明および半透明) | カラーピッカー | フィル色。 |
Opacity(半透明のみ) | スライダー5%から100% | デフォルト50%。 |
浮動キャンバスオーバーレイは、フレームの自分のWidthとHeightからサイズを取得します。ページから作られた浮動オーバーレイは、500 x 350ピクセルのボックスを使用します。
オーバーレイは実験をブロックしません。空の透明な領域は下のフレームにクリックを通さないようにし、オーバーレイ上のオブジェクトだけがクリックを受け取ります。
ダイアログスタイルとインタラクション
これらの設定はTypeがDialog (popup window)のときに表示されます。
スタイル
| 設定 | オプション | メモ |
|---|---|---|
Placement | Centered, Pinned to a spot | Centeredは、ダイアログを画面の中央に配置します。 |
Anchor(ピン留めのみ) | オーバーレイと同じ9つの位置 | ダイアログは、選択された角またはエッジから20ピクセルの距離を保持します。 |
Size W / H(ページダイアログ) | 2つの数字、ピクセル単位 | デフォルト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 | タスク開始時にマウント | タスクが終了したとき | 1つのタスクに属するタイマー、スコアや進捗表示、ヘルプ |
Whole session | 最初のタスクが開始したとき | セッションが終了したとき | ヘルプまたはポーズボタンなど、すべてのタスクにわたって維持すべき要素 |
This trialオーバーレイは、各試行の開始時にリセットされるため、そのオブジェクトと状態が最初からやり直されます。This taskおよびWhole sessionオーバーレイは、試行やタスクを超えてその状態を保持します。変数はすべてのスコープで実験の残りと共有されるため、オーバーレイに表示されたスコア変数はその値を保持します。
オーバーレイとダイアログは常にデフォルトの試行の値を使用します。条件ごとに変更されることはありません。
オーバーレイとダイアログのイベント
オーバーレイまたはダイアログは、通常のフレームのように独自のフレームイベントを実行します。表示されるたびに開始し、非表示にされると停止します。オーバーレイでのキーボードトリガーは、下のフレームが実行中でも動作します。
タスクの試行イベント(Trial Event (on each frame))は、オーバーレイ上では実行されず、そのイベントパネルにはリストされません(Also run trial events on itがチェックされていない限り)。
Control Frameでの表示と非表示
Control Frameアクションを使用して、オーバーレイまたはダイアログを表示、非表示、またはトグルします。これはControl Actionsのアクションメニューで見つけられます。
- 試行タイムラインのフレームまたはオーバーレイ自体でイベントエディタを開きます。
- 任意のトリガーでイベントを追加します。
- アクション
Control Frameを追加します。 Frame:で、オーバーレイまたはダイアログを選択します。リストには、すべてのタスクのオーバーレイとダイアログ、Whole sessionスコープを持つものが表示されます。Command:で、Show、Hide、またはToggleを選択します。
まだオーバーレイまたはダイアログが存在しない場合、アクションはOverlays & Dialogsタブに1つを追加するヒントを表示します。別のタスクのThis taskまたはThis trialオーバーレイをターゲットにしたアクションは効果がありません。なぜなら、そのオーバーレイは自分のタスクが実行されている間だけマウントされるからです。0.25秒以内に2つのToggleコマンドは1つとしてカウントされるため、2回発生するトリガーはダイアログを開いてすぐに閉じることはありません。
例:ボタンがクリックされたときに隠されたヘルプダイアログを表示
トリガー:
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イベントでタイマーを開始します。これは、タスクが終了するまでフレームと試行間で実行され続けます。
スコアや進捗表示: CanvasオーバーレイをMatch task displayで追加し、スコア変数を表示するVariableオブジェクト(ツールバーグループText & Code)を追加します。変数は共有されているため、下のフレームでスコアが変更されるたびに表示が更新されます。
ヘルプダイアログ: デフォルトでは非表示のPageダイアログを追加し、あなたの指示を含め、オーバーレイやフレーム自体にヘルプボタンを追加します。Control Frameアクションは、コマンドShowでダイアログを開き、参加者は閉じるボタンでそれを閉じます。
タスク間のポーズメッセージ: スコープWhole sessionのPageダイアログを追加し、Initial stateをHiddenに設定します。タスクの最後にControl Frameで表示し、ダイアログ内にある続行ボタンで非表示にします。ブロック間の通常の休憩には、試行タイムライン内の通常のページフレームの方が簡単です。