Labvanced実験エディターの入力オブジェクト.

入力オブジェクト

入力オブジェクトは、実験中に参加者から自由形式の回答を収集します。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 typenumber参加者に表示される入力フィールドのタイプ。オプション: number, text, date, time, color。
Focusedfalsetrueに設定すると、このフィールドにキーボードフォーカスを移動します。イベントシステムを介して試行ごとに設定可能です。
Min-Value(なし)numberタイプのみに使用します。許可される最小値。
Max-Value(なし)numberタイプのみに使用します。許可される最大値。
Min-Nr-Chars(なし)textタイプのみに使用します。必要な最小文字数。
Max-Nr-Chars(なし)textタイプのみに使用します。許可される最大文字数。
Date Formatbrowser-localedateタイプのみに使用します。日付が表示され、入力される方法を制御します。オプション: browser-locale, yyyy-mm-dd, dd.mm.yyyy, mm/dd/yyyy。入力タイプがdateに設定されているときのみパネルに表示されます。

プレースホルダーテキスト

入力フィールドが空のとき（参加者が入力を始める前）にプレースホルダーテキストが表示されます。参加者が値を入力し始めるとすぐに消えます。

これを有効にするには:

  1. オブジェクトプロパティパネルでEnable Placeholderを有効にします。
  2. 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

アクションを介して入力オブジェクトを制御する

2つのプロパティは、Set Object Propertyアクションを介してランタイムで変更可能です。

修正可能プロパティ説明
Focusedtrueに設定すると、プログラム的に入力フィールドにフォーカスを移動します。
required過去の参加者の回答に基づいて、フィールドを条件付きで必須にするためにランタイムでトグルできます。

例: フレーム開始時に入力フィールドにフォーカスを当てる

トリガー: On Frame Startアクション: Set Object Property → Set Target: あなたの入力オブジェクト → プロパティ: Focused → 値: true

例: 以前の回答に基づいてフィールドを必須にする

トリガー: Variable Value Changed → あなたの条件変数 アクション: Set Object Property → Set Target: あなたの入力オブジェクト → プロパティ: required → 値: true

イベントアクション内でリンクされた変数から現在の回答値を読み取ることもでき、参加者が入力した内容に基づいて実験の流れを分岐させることができます。

さらに読む

Labvancedのイベントシステムの説明、Focusされた内容やRuntimeでのRequiredの設定に使用される

イベントシステム

トリガーとアクションの構造。入力オブジェクトのためのFocusされたおよびRequiredのコントロールを含む、ランタイムでのオブジェクトプロパティの設定について説明します。

変数を扱う

変数を扱う

変数を作成、設定、および記録する方法。入力オブジェクトの回答に適用されるデータタイプ、記録オプション、バリデーション設定を含みます。

変数タイプ

変数タイプ

Labvancedのすべての変数タイプの概要。各入力タイプが異なる変数データタイプにリンクされる理由を理解するのに役立ちます。