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 Versuchs automatisch aufgezeichnet. Sie können Validierungsregeln konfigurieren, Platzhaltertexte anzeigen, um die Teilnehmer zu leiten, bevor sie mit dem Tippen beginnen, und das Element über Ereignisse steuern.

Eingabeobjekt hinzufügen

Im Toolbalken des Aufgabeneditors öffnen Sie die Question Inputs-Gruppe und wählen Input aus, 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 Eigenschaftenpanel aus. Der Datentyp der verlinkten Variablen wird automatisch auf das entsprechende Format eingestellt.

Eingabetyp	Datentyp der Variablen	Hinweise
`number`	Numerisch	Akzeptiert ganze Zahlen und Dezimalzahlen. Validierung für Min/Max-Werte verfügbar.
`text`	Zeichenfolge	Akzeptiert beliebigen Text. Zeichenlängenvalidierung verfügbar.
`date`	Datum/Uhrzeit	Zeigt einen Datumswähler an. Datumsformat konfigurierbar.
`time`	Uhrzeit	Zeigt einen Zeitwähler an.
`color`	Zeichenfolge	Zeigt einen Farbauswähler an. Speichert den ausgewählten Farbwert als Zeichenfolge.

Eigenschaften

Eigenschaft	Standard	Beschreibung
`Show Question Header`	Ein	Zeigt das Frage-Textlabel über dem Eingabefeld an.
`Show Placeholder`	Aus	Bei Aktivierung 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 sichtbar im Panel, wenn `Show Placeholder` aktiviert ist.
`Required`	Aus	Bei Aktivierung kann der Teilnehmer den Frame 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`	falsch	Wenn auf wahr 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 Mindestanzahl an erforderlichen Zeichen.
`Max-Nr-Chars`	(keine)	Nur für `text`-Typ. Die maximal erlaubte Anzahl an 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 sichtbar im Panel, wenn der Eingabetyp auf `date` gesetzt ist.

Platzhaltertext

Platzhaltertext erscheint im Eingabefeld, wenn es leer ist, bevor der Teilnehmer zu tippen beginnt. Er verschwindet, sobald der Teilnehmer einen Wert eingibt.

Um ihn zu aktivieren:

Aktivieren Sie im Eigenschaftenpanel Enable Placeholder.
Geben Sie den gewünschten Text im 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 einem vollständigen Label einzunehmen.

Note: Platzhaltertext wird nicht als Antwort aufgezeichnet. Er ist nur zur Anzeige gedacht und beeinflusst den Variablenwert nicht.

Validierung

Das Eingabeobjekt enthält integrierte Validierungsoptionen, um sicherzustellen, dass Teilnehmer verwertbare Daten bereitstellen, bevor sie fortfahren.

Erforderliches Feld: 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, fortzufahren, ohne ein erforderliches Feld auszufüllen, wird das Feld hervorgehoben.

Numerischer Bereich: Für number-Eingaben stellen Sie Min Value und Max Value ein, um akzeptierte Einträge zu begrenzen. Wenn ein Teilnehmer einen Wert außerhalb des Bereichs eingibt und das Feld verlässt, wird der Wert automatisch auf die nächstgelegene Grenze korrigiert.

Zeichenlänge: Für text-Eingaben stellen Sie Min Nr Chars und Max Nr Chars ein, um Längenbeschränkungen durchzusetzen. Diese werden geprü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 eingestellt:

number → Numerische Variable
text → Zeichenfolgenvariable
date → Datum/Uhrzeit-Variable
time → Zeitvariable
color → Zeichenfolgenvariable

Um das Element mit einer anderen Variablen zu verknüpfen, verwenden Sie den Variablenauswähler im Eigenschaftenpanel.

Ereignisintegration

Das Eingabeobjekt arbeitet in zwei Weisen mit Ereignissen: als Auslöserziel und als Aktionsziel.

Ereignisse aus dem Eingabeobjekt auslösen

Der Enter On Input-Auslöser tritt in Kraft, wenn der Teilnehmer die Eingabetaste oder Eingabetaste drückt, während das Eingabefeld fokussiert ist. Fügen Sie Ihr Eingabeobjekt unter Targets: in der Auslöserkonfiguration hinzu.

Beispiel: den Frame einreichen, wenn der Teilnehmer die Eingabetaste drückt

Auslöser: Enter On Input → Targets: fügen Sie Ihr Eingabeobjekt hinzu Aktion: Jump to Next Frame

Das Eingabeobjekt über Aktionen steuern

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 erforderlich zu machen.

Beispiel: den Fokus auf das Eingabefeld setzen, wenn der Frame startet

Auslöser: On Frame StartAktion: Set Object Property → Set Target: Ihr Eingabeobjekt → Eigenschaft: Focused → Wert: true

Beispiel: das Feld basierend auf einer vorherigen Antwort erforderlich machen

Auslöser: 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 Ereignisaktion lesen, um den Experimentablauf basierend auf dem, was der Teilnehmer eingegeben hat, zu verzweigen.

Eingabeobjekt

Inhaltsverzeichnis

Eingabeobjekt hinzufügen

Eingabetypen

Eigenschaften

Platzhaltertext

Validierung

Variablenintegration

Ereignisintegration

Weiterführende Literatur

Ereignissystem

Arbeiten mit Variablen

Variablentypen