
入力オブジェクト
入力オブジェクトは、実験中に参加者から自由形式の応答を収集します。数値、テキスト、日付、時間、色の五つの入力タイプをサポートしています。応答はリンクされた変数に保存され、各トライアルの終了時に自動的に記録されます。検証ルールを設定し、参加者が入力を開始する前に案内するためのプレースホルダーテキストを表示し、イベントを通じて要素を制御することができます。
入力オブジェクトの追加
タスクエディタのツールバーで、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が有効なときにチェックされます。
変数の統合
各入力オブジェクトは、要素を追加する際に作成される1つのグローバル変数にリンクされています。変数は参加者の現在の応答値を保存し、トライアルの終了時に記録されます。
リンクされた変数のデータタイプは、選択された入力タイプに基づいて自動的に設定されます:
number→ 数値変数text→ 文字列変数date→ 日時変数time→ 時間変数color→ 文字列変数
要素を別の変数に再リンクするには、オブジェクトプロパティパネルの変数セレクタを使用します。
イベントの統合
入力オブジェクトは、イベントに2つの方法で作用します:トリガーターゲットおよびアクショントリガーターゲットとして。
入力オブジェクトからイベントをトリガーする
入力フィールドがフォーカスされているときに参加者がEnterまたはReturnを押すと、Enter On Inputトリガーが発動します。トリガー設定内のTargets:の下にあなたの入力オブジェクトを追加します。
例:参加者がEnterを押すとフレームを提出する
トリガー:
Enter On Input→Targets: あなたの入力オブジェクトを追加 アクション:Jump to Next Frame
アクションを介して入力オブジェクトを制御する
実行時にSet Object Propertyアクションを介して変更可能な2つのプロパティがあります。
| 変更可能なプロパティ | 説明 |
|---|---|
Focused | trueに設定すると、プログラム的に入力フィールドにフォーカスを移動します。 |
required | 実行時にトグルでき、以前の参加者の応答に基づいて条件付きでフィールドを必須にできます。 |
例:フレームが始まるときに入力フィールドにフォーカスを当てる
トリガー:
On Frame Startアクション:Set Object Property→Set Target: あなたの入力オブジェクト → プロパティ:Focused→ 値:true
例:以前の応答に基づいてフィールドを必須にする
トリガー:
Variable Value Changed→ あなたの条件変数 アクション:Set Object Property→Set Target: あなたの入力オブジェクト → プロパティ:required→ 値:true
イベントアクション内のリンクされた変数から現在の応答値を読み取ることもでき、たとえば参加者が入力した内容に基づいて実験フローを分岐させることができます。