Auswahl-Fragetypen | NueForm Docs

Multiple Choice

Präsentiere eine Liste von Textoptionen, aus denen der Teilnehmer wählen kann. Unterstützt Einzelauswahl, Mehrfachauswahl, freien „Sonstiges"-Text, Zufallsreihenfolge und alphabetische Sortierung.

Typ-Bezeichner: multiple_choice

Eigenschaften

Eigenschaft	Typ	Beschreibung	Standard
`choices`	Choice[]	Array der Auswahloptionen. Jede Auswahl hat eine `id`, ein `label` und eine optionale `imageUrl`.	`[]`
`allowMultiple`	boolean	Erlaubt dem Teilnehmer, mehr als eine Option auszuwählen.	`false`
`allowOther`	boolean	Zeigt eine „Sonstiges"-Option mit Freitext-Eingabe, in die der Teilnehmer eine eigene Antwort tippen kann.	`false`
`randomize`	boolean	Mischt die Reihenfolge der Optionen bei jeder Anzeige der Frage neu.	`false`
`alphabeticalOrder`	boolean	Sortiert Optionen alphabetisch. Wird ignoriert, wenn `randomize` aktiviert ist (Zufallsreihenfolge hat Vorrang).	`false`

Choice-Objekt

Jede Auswahl im choices-Array hat:

Feld	Typ	Beschreibung
`id`	string	Eindeutiger Bezeichner dieser Auswahl. Wird in Logiksprüngen und der Bewertung verwendet.
`label`	string	Der Anzeigetext der Auswahl.
`imageUrl`	string	Optionale Bild-URL der Auswahl (bei Standard-Multiple-Choice unüblich; siehe Bildauswahl).

Validierung

Ist required auf true gesetzt, muss der Teilnehmer mindestens eine Option auswählen, bevor er fortfahren kann.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Bei equals oder not_equals ist der Vergleichswert die Auswahl-ID. Bei Mehrfachauswahl-Fragen prüft equals, ob der Wert unter den ausgewählten Elementen ist.

Antwortformat

Einzelauswahl (allowMultiple: false): Ein string (die ausgewählte Auswahl-ID).
Mehrfachauswahl (allowMultiple: true): Ein Array von Strings (die ausgewählten Auswahl-IDs).

Bewertung im Quiz-Modus

Multiple Choice ist in allen Quiz-Modi ein bewertbarer Fragetyp:

Wissensquiz: Setze correctAnswers (Array der richtigen Auswahl-IDs) und correctAnswerScore (Punkte pro richtiger Antwort).
Lead-Qualifizierung: Setze choiceScores (Zuordnung von Auswahl-ID zu Punktwert).
Match-Quiz: Setze choiceOutcomes (Zuordnung von Auswahl-ID zu Endbildschirm-Fragen-IDs).

Für die Auswahl stehen Tastenkürzel zur Verfügung. Teilnehmer können Buchstabentasten (A, B, C usw.) drücken, um Optionen auszuwählen — die Kürzel erscheinen als Indikatoren neben jeder Option.

Ein Dropdown-Menü zur Auswahl aus einer Optionsliste. Unterstützt dieselbe Konfiguration wie Multiple Choice, zeigt die Optionen aber in einem kompakten Dropdown-Format.

Dropdown-Frage — Eine Dropdown-Auswahlfrage.

Typ-Bezeichner: dropdown

Eigenschaften

Eigenschaft	Typ	Beschreibung	Standard
`choices`	Choice[]	Array der Auswahloptionen.	`[]`
`allowMultiple`	boolean	Erlaubt die Auswahl mehrerer Optionen aus dem Dropdown.	`false`
`allowOther`	boolean	Zeigt eine „Sonstiges"-Option mit Freitext-Eingabe.	`false`
`placeholder`	string	Platzhaltertext, der vor einer Auswahl angezeigt wird.	Keiner
`randomize`	boolean	Mischt die Reihenfolge der Optionen.	`false`
`alphabeticalOrder`	boolean	Sortiert Optionen alphabetisch.	`false`

Validierung

Ist required auf true gesetzt, muss der Teilnehmer mindestens eine Option auswählen.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

Einzelauswahl: Ein string (die ausgewählte Auswahl-ID).
Mehrfachauswahl: Ein Array von Strings (die ausgewählten Auswahl-IDs).

Bewertung im Quiz-Modus

Dropdown ist ein bewertbarer Fragetyp. Die Bewertungskonfiguration ist identisch mit Multiple Choice.

Bildauswahl

Präsentiere bildbasierte Optionen, aus denen der Teilnehmer wählen kann. Jede Option zeigt ein Bild mit einer optionalen Textbeschriftung darunter.

Typ-Bezeichner: picture_choice

Eigenschaften

Eigenschaft	Typ	Beschreibung	Standard
`choices`	Choice[]	Array der Auswahloptionen. Jede Auswahl sollte zusätzlich zu `id` und `label` eine `imageUrl` haben.	`[]`
`allowMultiple`	boolean	Erlaubt die Auswahl mehrerer Bilder.	`false`
`allowOther`	boolean	Zeigt eine „Sonstiges"-Option mit Freitext-Eingabe.	`false`
`randomize`	boolean	Mischt die Reihenfolge der Bildoptionen.	`false`
`alphabeticalOrder`	boolean	Sortiert Optionen alphabetisch nach Beschriftung.	`false`

Choice-Objekt (Bildauswahl)

Feld	Typ	Beschreibung
`id`	string	Eindeutiger Bezeichner dieser Auswahl.
`label`	string	Textbeschriftung, die unter dem Bild angezeigt wird.
`imageUrl`	string	URL des Bildes, das für diese Auswahl angezeigt wird.

Validierung

Ist required auf true gesetzt, muss der Teilnehmer mindestens ein Bild auswählen.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

Einzelauswahl: Ein string (die ausgewählte Auswahl-ID).
Mehrfachauswahl: Ein Array von Strings (die ausgewählten Auswahl-IDs).

Bewertung im Quiz-Modus

Bildauswahl ist ein bewertbarer Fragetyp. Die Bewertungskonfiguration ist identisch mit Multiple Choice.

Bildauswahl-Optionen werden in einem responsiven Rasterlayout angezeigt. Auf dem Desktop erscheinen Bilder in einem mehrspaltigen Raster; auf Mobilgeräten stapeln sie sich vertikal.

Ja / Nein

Eine einfache binäre Frage mit „Ja"- und „Nein"-Schaltflächen.

Typ-Bezeichner: yes_no

Eigenschaften

Der Ja/Nein-Fragetyp hat über die gemeinsamen Frageeigenschaften hinaus keine zusätzlichen Eigenschaften.

Validierung

Ist required auf true gesetzt, muss der Teilnehmer entweder „Ja" oder „Nein" anklicken.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Vergleiche bei equals gegen true (Ja) oder false (Nein). Die String-Werte "true" und "false" werden ebenfalls akzeptiert.

Antwortformat

Die Antwort wird als boolean gespeichert (true für Ja, false für Nein, oder null, wenn unbeantwortet).

Bewertung im Quiz-Modus

Ja/Nein ist ein bewertbarer Fragetyp:

Wissensquiz: Setze correctAnswers mit einem einzelnen Wert "true" oder "false".
Lead-Qualifizierung: Setze choiceScores mit den Schlüsseln "true" und "false".
Match-Quiz: Setze choiceOutcomes mit den Schlüsseln "true" und "false".

Die Ja/Nein-Frage springt sofort nach der Auswahl automatisch zur nächsten Frage weiter. Es gibt keine separate „OK"-Schaltfläche.

Ranking

Präsentiere eine Liste von Elementen, die der Teilnehmer per Drag-and-drop in seine bevorzugte Reihenfolge bringt.

Typ-Bezeichner: ranking

Eigenschaften

Eigenschaft	Typ	Beschreibung	Standard
`choices`	Choice[]	Array der zu sortierenden Elemente. Jedes hat eine `id` und ein `label`.	`[]`

Validierung

Ist required auf true gesetzt, muss der Teilnehmer ein Ranking übermitteln (alle Elemente müssen in einer definierten Reihenfolge sein).

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

Die Antwort wird als Array von Strings gespeichert (Auswahl-IDs in der vom Teilnehmer gewählten Reihenfolge, von zuerst bis zuletzt).

json

["choice_3", "choice_1", "choice_2"]

Das Ranking-Feld nutzt Drag-and-drop-Interaktion. Auf Mobilgeräten können Teilnehmer Elemente per Touch-Gesten umsortieren.

Matrix

Ein rasterbasierter Fragetyp, bei dem Teilnehmer mehrere Elemente (Zeilen) über mehrere Kategorien (Spalten) bewerten. Jeder Schnittpunkt aus Zeile und Spalte ist eine auswählbare Option.

Typ-Bezeichner: matrix

Eigenschaften

Eigenschaft	Typ	Beschreibung	Standard
`rows`	string[]	Array der Zeilenbeschriftungen (die zu bewertenden Elemente).	`[]`
`columns`	string[]	Array der Spaltenbeschriftungen (die Bewertungskategorien).	`[]`
`randomizeRows`	boolean	Mischt die Reihenfolge der Zeilen.	`false`
`randomizeColumns`	boolean	Mischt die Reihenfolge der Spalten.	`false`

Validierung

Ist required auf true gesetzt, muss der Teilnehmer pro Zeile eine Option auswählen.

Logiksprung-Operatoren

equals, not_equals, is_answered, is_not_answered

Antwortformat

Die Antwort wird als object (Record<string, string>) gespeichert, das jede Zeilenbeschriftung der ausgewählten Spaltenbeschriftung zuordnet:

json

{
  "Product Quality": "Excellent",
  "Customer Service": "Good",
  "Value for Money": "Average"
}

Matrix-Fragen werden auf dem Desktop als responsives Raster angezeigt und passen sich auf Mobilgeräten für bessere Bedienbarkeit einem gestapelten Format an. Zeilen und Spalten unterstützen unabhängige Zufallsreihenfolgen.

Liste

Erfasse mehrere Einträge derselben Art. Eine Liste enthält entweder einfache Textelemente (tippen und Enter drücken oder auf Hinzufügen tippen) oder wiederholbare Composite-Elemente — strukturierte Einträge auf Basis eines wiederverwendbaren Composites, etwa um beliebig viele Vorstandsmitglieder in einer einzigen Frage hinzuzufügen.

Typ-Bezeichner: list

Eigenschaften

Eigenschaft	Typ	Beschreibung	Standard
`itemType`	string	`string` für einfache Textelemente, `composite` für wiederholbare Composite-Instanzen.	`string`
`compositeId`	string	Das referenzierte Composite (nur Composite-Elemente). Wird über die Auswahl gesetzt.	—
`itemPlaceholder`	string	Platzhaltertext für das Eingabefeld (Textelemente).	—
`addButtonLabel`	string	Eigene Beschriftung für die Hinzufügen-Schaltfläche in beiden Element-Modi.	—
`minItems`	number	Minimale Anzahl an Elementen, die zum Absenden erforderlich ist.	—
`maxItems`	number	Maximale Anzahl an Elementen. Harte Obergrenze 100.	`100`
`itemRegex`	string	Validierungsmuster pro Element (Textelemente).	—
`itemRegexError`	string	Fehlermeldung, wenn das Muster nicht erfüllt ist.	—
`itemMinLength`	number	Minimale Zeichenanzahl pro Element (Textelemente).	—
`itemMaxLength`	number	Maximale Zeichenanzahl pro Element (Textelemente).	—
`allowDuplicates`	boolean	Erlaubt, dasselbe Textelement zweimal hinzuzufügen (Textelemente).	`true`
`allowReorder`	boolean	Lässt Teilnehmer Elemente per Ziehen umsortieren (Textelemente).	`true`
`defaultItems`	string[]	Beim ersten Laden der Frage vorbefüllte Elemente (Textelemente, Web-Formulare).	`[]`
`displayMode`	string	Wie ein eingeklappter Composite-Eintrag gerendert wird: `compact` (einzeilige Zusammenfassung) oder `card` (jede Feldbeschriftung + Wert).	`compact`
`compactFields`	string[]	Geordnete Unterfeld-IDs, die in der kompakten eingeklappten Zusammenfassung angezeigt werden. Standard ist das erste Feld des Composites.	—

Validierung

Ist required auf true gesetzt, muss mindestens ein Element hinzugefügt werden. minItems / maxItems werden beim Absenden durchgesetzt; Muster- und Längenregeln pro Element (Textelemente) werden beim Hinzufügen jedes Elements durchgesetzt.

Logiksprung-Operatoren

list_count_equals, list_count_greater_than, list_count_less_than, contains, not_contains, is_answered, is_not_answered

Die Zähloperatoren vergleichen gegen die Anzahl der Elemente in der Antwort.

Antwortformat

Textelemente: ein Array von Strings.
Composite-Elemente: ein Array von Objekten, jeweils mit Unterfeld-IDs als Schlüssel:

json

[
  { "sub_first_name": "Ada", "sub_email": "ada@example.com" },
  { "sub_first_name": "Grace", "sub_email": "grace@example.com" }
]

Jedes Composite-Element wird zusätzlich als eigenständiger Composite-Eintrag erfasst — siehe die Composites-Anleitung für die formularübergreifende Einträge-Ansicht und die eingeklappten Anzeigemodi.