入力オブジェクト
入力オブジェクトは、実験中に参加者から自由形式の応答を収集します。数値、テキスト、日付、時刻、色の5種類の入力タイプをサポートしています。応答はリンクされた変数に保存され、各トライアルの終了時に自動的に記録されます。バリデーションルールを設定し、参加者が入力を始める前にガイドとなるプレースホルダーテキストを表示し、イベントを通じて要素を制御できます。
入力オブジェクトの追加
タスクエディタのツールバーで、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
イベントアクションの中で、リンクされた変数から現在の応答値を読み取ることもできます。たとえば、参加者が入力した内容に基づいて実験の流れを分岐させることができます。