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 verknüpften Variablen gespeichert und am Ende jedes Versuchs automatisch aufgezeichnet. Sie können Validierungsregeln konfigurieren, Platzhaltertext anzeigen, um den Teilnehmern vor dem Tippen zu helfen, und das Element über Ereignisse steuern.

Eingabeobjekt hinzufügen

Im Aufgabenbearbeitungstool öffnen Sie die Question Inputs-Gruppe und wählen Input aus, um ein Eingabeobjekt zum aktuellen Rahmen hinzuzufügen.

Wenn das Element hinzugefügt wird, fordert Labvanced Sie auf, den Namen der Variablen festzulegen, die die Antwort des Teilnehmers speichern wird. Geben Sie 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 verknüpften Variablen wird automatisch entsprechend festgelegt.

Eingabetyp	Variablen-Datentyp	Hinweise
`number`	Numerisch	Akzeptiert Ganzzahlen und Dezimalzahlen. Min-/Max-Wert-Validierung verfügbar.
`text`	Zeichenfolge	Akzeptiert beliebigen Text. Zeichenlängenvalidierung verfügbar.
`date`	Datum/Uhrzeit	Zeigt einen Datumsauswahl-Dialog an. Datumsformat konfigurierbar.
`time`	Uhrzeit	Zeigt einen Zeitwahl-Dialog an.
`color`	Zeichenfolge	Zeigt einen Farbauswahl-Dialog an. Speichert den ausgewählten Farbwert als Zeichenfolge.

Eigenschaften

Eigenschaft	Standard	Beschreibung
`Show Question Header`	Ein	Zeigt die Frage-Textbeschriftung über dem Eingabefeld an.
`Show Placeholder`	Aus	Wenn aktiviert, zeigt Platzhaltertext innerhalb des Feldes an, bevor der Teilnehmer mit dem Tippen beginnt. Nur verfügbar für `number` und `text` Typen.
`Placeholder`	(leer)	Der Platzhaltertext. Nur im Panel sichtbar, wenn `Show Placeholder` aktiviert ist.
`Required`	Aus	Wenn aktiviert, kann der Teilnehmer den Rahmen oder die Fragebogenseite nicht einreichen, 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`	false	Wenn auf true gesetzt, wird der Fokus der Tastatur auf dieses Feld verschoben. Pro Versuch über das Ereignissystem konfigurierbar.
`Min-Value`	(keine)	Nur für `number` Typ. Der niedrigste akzeptierte Wert.
`Max-Value`	(keine)	Nur für `number` Typ. Der höchste akzeptierte Wert.
`Min-Nr-Chars`	(keine)	Nur für `text` Typ. Die minimale Anzahl an benötigten Zeichen.
`Max-Nr-Chars`	(keine)	Nur für `text` Typ. Die maximale Anzahl an zulässigen Zeichen.
`Date Format`	`browser-locale`	Nur für `date` Typ. 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 beginnt, einen Wert einzugeben.

Um ihn zu aktivieren:

Aktivieren Sie im Eigenschaften-Panel Enable Placeholder.
Geben Sie den gewünschten Text in das Placeholder Text Feld ein.

Verwenden Sie Platzhaltertext, um den Teilnehmern einen Format-Hinweis zu geben (zum Beispiel 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 da und hat keinen Einfluss auf den Variablenwert.

Validierung

Das Eingabeobjekt umfasst integrierte Validierungsoptionen, um sicherzustellen, dass die Teilnehmer nutzbare Daten bereitstellen, bevor sie fortfahren.

Pflichtfeld: Aktivieren Sie Is Required, um die Einreichung von Rahmen oder 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 zu begrenzen. Wenn ein Teilnehmer einen Wert außerhalb des Bereichs eingibt und dann das Feld verlässt, wird der Wert automatisch auf die nächstgelegene 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 Versuchs aufgezeichnet.

Der Datentyp der Variablen wird automatisch basierend auf dem ausgewählten Eingabetyp festgelegt:

number → Numerische Variable
text → Zeichenfolgenvariable
date → Datums-/Uhrzeitvariable
time → Zeitvariable
color → Zeichenfolgenvariable

Um das Element mit einer anderen Variablen neu zu verknüpfen, verwenden Sie den Variablenwähler im Eigenschaften-Panel.

Ereignisintegration

Das Eingabeobjekt funktioniert auf zwei Arten mit Ereignissen: als Auslöseziel und als Aktionsziel.

Ereignisse vom Eingabeobjekt auslösen

Der Enter On Input-Trigger wird ausgelöst, 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 Triggerkonfiguration hinzu.

Beispiel: den Rahmen einreichen, 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 können zur Laufzeit über die Set Object Property Aktion geändert werden:

Änderbare Eigenschaft	Beschreibung
`Focused`	Wenn auf true gesetzt, wird der Fokus programmgesteuert auf das Eingabefeld verschoben.
`required`	Kann zur Laufzeit umgeschaltet werden, um bedingt das Feld basierend auf früheren Teilnehmerantworten erforderlich zu machen.

Beispiel: den Eingabefokus setzen, wenn der Rahmen beginnt

Trigger: On Frame StartAktion: Set Object Property → Set Target: Ihr Eingabeobjekt → Eigenschaft: Focused → Wert: true

Beispiel: das 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 verknüpften Variablen in jeder Ereignisaktion lesen, um beispielsweise den Versuchsfluss basierend auf dem, was der Teilnehmer eingegeben hat, zu verzweigen.

Eingabeobjekt

Inhaltsverzeichnis

Eingabeobjekt hinzufügen

Eingabetypen

Eigenschaften

Platzhaltertext

Validierung

Variablenintegration

Ereignisintegration

Weiterführende Literatur

Arbeiten mit Variablen

Variablentypen

Ereignissystem