
Eingabeobjekt
Das Eingabeobjekt sammelt freie Antworten von Teilnehmern während eines Experiments. Es unterstützt fünf Eingabetypen: Zahl, Text, Datum, Uhrzeit und Farbe. Die Antwort wird in einer verlinkten Variablen gespeichert und am Ende jedes Trials automatisch aufgezeichnet. Sie können Validierungsregeln konfigurieren, Platzhaltertext anzeigen, um Teilnehmer anzuleiten, bevor sie mit dem Tippen beginnen, und das Element über Ereignisse steuern.
Inhaltsverzeichnis
Hinzufügen des Eingabeobjekts
Öffnen Sie in der Task-Editor-Symbolleiste die Question Inputs-Gruppe und wählen Sie Input, um ein Eingabeobjekt zum aktuellen Frame hinzuzufügen.
Wenn das Element hinzugefügt wird, fordert Labvanced Sie auf, den Namen der Variablen anzugeben, die die Antwort des Teilnehmers speichern wird. Geben Sie ihm einen beschreibenden Namen, der die gesammelten Daten widerspiegelt (zum Beispiel response_text oder age).
Eingabetypen
Wählen Sie den Eingabetyp im Objekteigenschaften Panel aus. Der Datentyp der verlinkten Variablen wird automatisch entsprechend eingestellt.
| Eingabetyp | Variablen-Datentyp | Hinweise |
|---|---|---|
number | Numerisch | Akzeptiert Ganzzahlen und Dezimalzahlen. Min/Max-Wertvalidierung verfügbar. |
text | String | Akzeptiert jeden Text. Zeichenlängenvalidierung verfügbar. |
date | Datetime | Zeigt einen Datumsauswähler an. Datumsformat konfigurierbar. |
time | Zeit | Zeigt einen Zeitauswähler an. |
color | String | Zeigt einen Farbauswähler an. Speichert den ausgewählten Farbwert als String. |
Eigenschaften
| Eigenschaft | Standard | Beschreibung |
|---|---|---|
Show Question Header | Ein | Zeigt die Fragenbeschriftung über dem Eingabefeld an. |
Show Placeholder | Aus | Wenn aktiviert, wird Platzhaltertext im Feld angezeigt, bevor der Teilnehmer mit dem Tippen beginnt. Nur für number und text-Typen verfügbar. |
Placeholder | (leer) | Der Platzhaltertext. Nur im Panel sichtbar, wenn Show Placeholder aktiviert ist. |
Required | Aus | Wenn aktiviert, kann der Teilnehmer das Frame oder die Fragebogen-Seite nicht absenden, bis dieses Feld einen gültigen Wert enthält. |
Input type | number | Der Typ des Eingabefelds, das dem Teilnehmer angezeigt wird. Optionen: number, text, date, time, color. |
Focused | falsch | Wenn auf wahr gesetzt, wird der Fokus der Tastatur auf dieses Feld verschoben. Konfigurierbar pro Trial über das Ereignissystem. |
Min-Value | (keine) | Nur für number-Typen. Der niedrigste akzeptierte Wert. |
Max-Value | (keine) | Nur für number-Typen. Der höchste akzeptierte Wert. |
Min-Nr-Chars | (keine) | Nur für text-Typen. Die minimale Anzahl an erforderlichen Zeichen. |
Max-Nr-Chars | (keine) | Nur für text-Typen. Die maximale Anzahl an erlaubten Zeichen. |
Date Format | browser-locale | Nur für date-Typen. Steuert, wie das Datum angezeigt und eingegeben wird. Optionen: browser-locale, yyyy-mm-dd, dd.mm.yyyy, mm/dd/yyyy. Nur im Panel sichtbar, wenn der Eingabetyp auf date gesetzt ist. |
Platzhaltertext
Platzhaltertext erscheint im Eingabefeld, wenn es leer ist, bevor der Teilnehmer mit dem Tippen beginnt. Er verschwindet, sobald der Teilnehmer mit der Eingabe eines Wertes beginnt.
Um ihn zu aktivieren:
- Aktivieren Sie im Panel Eigenschaften für das Objekt
Enable Placeholder. - Geben Sie den gewünschten Text im Feld
Placeholder Textein.
Verwenden Sie Platzhaltertext, um den Teilnehmern einen Format-Hinweis zu geben (z.B. Enter a number between 1 and 100) oder eine kurze Anleitung, ohne Platz über dem Feld mit einer vollständigen Beschriftung einzunehmen.
Note: Platzhaltertext wird nicht als Antwort aufgezeichnet. Er ist nur zur Anzeige und hat keinen Einfluss auf den Variablenwert.
Validierung
Das Eingabeobjekt umfasst integrierte Validierungsoptionen, um sicherzustellen, dass Teilnehmer brauchbare Daten liefern, bevor sie fortfahren.
Pflichtfeld: Aktivieren Sie Is Required, um die Einreichung des Frames oder der Seite zu verhindern, bis das Feld einen gültigen, nicht leeren Wert enthält. Wenn ein Teilnehmer versucht, ohne Ausfüllen eines Pflichtfeldes fortzufahren, wird das Feld hervorgehoben.
Numerischer Bereich: Für number-Eingaben, setzen Sie Min Value und Max Value, um akzeptierte Eingaben einzuschränken. Wenn ein Teilnehmer einen Wert außerhalb des Bereichs eingibt und dann das Feld verlässt, wird der Wert automatisch auf die nächste Grenze korrigiert.
Zeichenlänge: Für text-Eingaben, setzen Sie Min Nr Chars und Max Nr Chars, um Längenbeschränkungen durchzusetzen. Diese werden überprüft, wenn Is Required aktiviert ist.
Variablenintegration
Jedes Eingabeobjekt ist mit einer globalen Variablen verknüpft, die erstellt wird, wenn Sie das Element hinzufügen. Die Variable speichert den aktuellen Antwortwert des Teilnehmers und wird am Ende des Trials aufgezeichnet.
Der Datentyp der Variablen wird automatisch basierend auf dem ausgewählten Eingabetyp eingestellt:
number→ Numerische Variabletext→ String-Variabledate→ Datetime-Variabletime→ Zeit-Variablecolor→ String-Variable
Um das Element mit einer anderen Variablen neu zu verknüpfen, verwenden Sie den Variablenauswähler im Panel Eigenschaften für das Objekt.
Ereignisintegration
Das Eingabeobjekt funktioniert mit Ereignissen auf zwei Arten: als Auslöserziel und als Aktionsziel.
Ereignisse aus dem Eingabeobjekt auslösen
Der Enter On Input-Trigger wird aktiviert, wenn der Teilnehmer die Eingabetaste oder Rücktaste drückt, während das Eingabefeld fokussiert ist. Fügen Sie Ihr Eingabeobjekt unter Targets: in der Trigger-Konfiguration hinzu.
Beispiel: Frame absenden, wenn der Teilnehmer die Eingabetaste drückt
Trigger:
Enter On Input→Targets: Fügen Sie Ihr Eingabeobjekt hinzu Aktion:Jump to Next Frame
Steuerung des Eingabeobjekts über Aktionen
Zwei Eigenschaften sind zur Laufzeit über die Set Object Property Aktion modifizierbar:
| Modifizierbare Eigenschaft | Beschreibung |
|---|---|
Focused | Wenn auf wahr gesetzt, wird der Fokus programmgesteuert auf das Eingabefeld verschoben. |
required | Kann zur Laufzeit umgeschaltet werden, um das Feld basierend auf früheren Teilnehmerantworten bedingt zu verlangen. |
Beispiel: Fokus auf das Eingabefeld setzen, wenn das Frame startet
Trigger:
On Frame StartAktion:Set Object Property→Set Target: Ihr Eingabeobjekt → Eigenschaft:Focused→ Wert:true
Beispiel: Feld basierend auf einer vorherigen Antwort erforderlich machen
Trigger:
Variable Value Changed→ Ihre Bedingungsvariable Aktion:Set Object Property→Set Target: Ihr Eingabeobjekt → Eigenschaft:required→ Wert:true
Sie können auch den aktuellen Antwortwert aus der verlinkten Variablen in jeder Aktionsereignis lesen, um den Fluss des Experiments basierend darauf zu verzweigen, was der Teilnehmer eingegeben hat.
Weitere Informationen
Ereignissystem
Wie Trigger und Aktionen strukturiert sind. Behandelt das Setzen von Objekteigenschaften zur Laufzeit, einschließlich der Steuerungen Fokussiert und Erforderlich für das Eingabeobjekt.
Arbeiten mit Variablen
Wie man Variablen erstellt, konfiguriert und aufzeichnet. Behandelt die Datentypen, Aufzeichnungsoptionen und Validierungseinstellungen, die auf die Antworten des Eingabeobjekts zutreffen.
Variablenarten
Ein Überblick über alle Variablenarten in Labvanced. Hilft Ihnen zu verstehen, warum jeder Eingabetyp mit einem anderen Variablen-Datentyp verknüpft ist.