# Feldeinstellungen

Bezeichnungen, Platzhalter, Standardwerte, Validierungsregeln und feldspezifische Optionen.

## Feldeinstellungen

Jede Frage hat gemeinsame Einstellungen — Titel, Pflichtfeld, Platzhalter — sowie typspezifische Optionen wie Zeichenlimits, Dateieinschränkungen und Validierungsregeln. Diese Seite erklärt alles.

<h2 id="accessing-settings">Feldeinstellungen aufrufen</h2>
<p>
  Tippe den Titel und die Optionen einer Frage direkt auf der Arbeitsfläche ein. Alles andere liegt im Blockmenü: Klicke auf den Ziehpunkt
  am linken Rand des Blocks (oder tippe auf den Blockindikator bei Touch-Bedienung) und wähle aus <strong>Umwandeln in</strong>,{' '}
  <strong>Optionen</strong>, <strong>Validierung</strong> sowie den üblichen Aktionen Duplizieren / Verschieben / Ausblenden / Löschen.
</p>

<h2 id="common-settings">Allgemeine Einstellungen</h2>
<p>Diese Optionen sind bei jedem Fragefeld verfügbar, unabhängig vom Typ.</p>

<p>
  Der Schlüssel eines Feldes — der Name, unter dem Automatisierungen es vorausfüllen und auslesen — wird in der Tabelle{' '}
  <strong>Schlüssel</strong> festgelegt, die das Schlüssel-Symbol in der Symbolleiste für das ganze Formular öffnet: ein Schlüssel pro Feld,
  Option, Zeile und Spalte. Einen Schlüssel leer lassen, um den aus dem Titel oder der Bezeichnung abgeleiteten zu verwenden. Das Bearbeiten
  eines Schlüssels in einem veröffentlichten Formular warnt dich, dass Automatisierungen, die den alten Schlüssel verwenden, nicht mehr
  funktionieren. Die Hinweiszeile jeder Option trägt ihren Schlüssel außerdem als Chip, den du direkt bearbeiten kannst. Siehe{' '}
  <a href="/de/requests/field-keys">Feldschlüssel</a> dafür, wie Schlüssel abgeleitet, bei der Veröffentlichung eingefroren und von
  aufrufenden Systemen verwendet werden.
</p>

> 💡 **Hilfetext hinzufügen**
> <p>
>     Formstep ist ein dokumentenähnlicher Editor — um Hilfetext oder Anweisungen zu einer Frage hinzuzufügen, füge einen Absatz- oder
>     Überschriftenblock oberhalb oder unterhalb des Feldes auf der Arbeitsfläche ein. Inhaltsblöcke zwischen Fragen sind für Befragte
>     sichtbar und funktionieren wie jeder andere Block.
>   </p>

> ℹ️ **Titelsichtbarkeit und Daten**
> <p>
>     Das Ausblenden eines Titels entfernt das Feld nicht aus den Einreichungen. Es erscheint weiterhin als Spaltenüberschrift in Exporten —
>     gib Feldern mit ausgeblendetem Titel daher einen aussagekräftigen internen Namen.
>   </p>

<h2 id="text-options">Textoptionen</h2>
<p>
  <strong>Min. Länge</strong> und <strong>Max. Länge</strong> liegen unter <strong>Validierung</strong> im Blockmenü und gelten für{' '}
  <strong>Text Input</strong>, <strong>Text Area</strong> und <strong>Website URL</strong>. Text Area ist die mehrzeilige Variante von Text
  Input — wechsle zwischen ihnen über <strong>Umwandeln in</strong>.
</p>

<h2 id="number-options">Zahlenoptionen</h2>
<p>
  <strong>Minimum</strong> und <strong>Maximum</strong> liegen unter <strong>Validierung</strong> und gelten für <strong>Number</strong>,{' '}
  <strong>Star Rating</strong> und eine lineare Skala. <strong>Number</strong> hat außerdem <strong>Schrittweite</strong>: Die Antwort muss
  ein Vielfaches davon sein, sodass eine Schrittweite von 1 nur ganze Zahlen akzeptiert und 0,5 auch halbe Werte zulässt. Lass das Feld
  leer, um jede Zahl zuzulassen.
</p>

<h2 id="choice-options">Auswahloptionen</h2>
<p>
  Diese Einstellungen gelten für auswahlbasierte Felder: <strong>Radio Buttons</strong>, <strong>Checkboxes</strong>,{' '}
  <strong>Dropdown</strong>, <strong>Ranking</strong>, <strong>Single Picture Choice</strong> und <strong>Multi Picture Choice</strong>.
</p>

<p>
  Einzelne Optionen können auch von der Arbeitsfläche aus ausgeblendet oder vorausgewählt werden: Setze den Cursor in eine Option und drücke
  ⌘ + H (Strg + H), um sie auszublenden, oder ⌘ + D (Strg + D), um sie standardmäßig auszuwählen.
</p>

<h2 id="rating-scale-options">Bewertungs- und Skalenoptionen</h2>

<h3 id="rating">Rating</h3>
<p>
  Das <strong>Star Rating</strong>-Feld zeigt standardmäßig 5 Sterne. Nutze <strong>Maximale Sterne erhöhen</strong> und{' '}
  <strong>Maximale Sterne verringern</strong> im Blockmenü, um einen Wert zwischen 1 und 10 festzulegen. Wandle es über dasselbe Menü in
  eine lineare Skala um; das Maximum wird übernommen, und die Menüeinträge werden zu <strong>Skalenmaximum erhöhen / verringern</strong>.
</p>

<h3 id="matrix">Matrix</h3>
<p>
  Das <strong>Matrix / Grid</strong>-Feld erstellt ein Auswahlraster. Definiere <strong>Zeilen</strong> (die Unterfragen) und{' '}
  <strong>Spalten</strong> (die Antworten). Der Befragte wählt eine Spalte pro Zeile. Unter <strong>Validierung</strong> kannst du{' '}
  <strong>Alle Zeilen erforderlich</strong> aktivieren oder <strong>Min. beantwortete Zeilen</strong> festlegen.
</p>

<h2 id="file-payment-options">Datei-Upload- und Zahlungsoptionen</h2>

<h3 id="file-upload">Datei-Upload</h3>
<p>
  <strong>File Upload</strong> nutzt <strong>Min. Dateien</strong>, <strong>Max. Dateien</strong>, <strong>Max. Größe (MB)</strong> und{' '}
  <strong>Akzeptierte Typen</strong> unter <strong>Validierung</strong>. Siehe{' '}
  <a href="/de/building-forms/file-uploads-signatures">Datei-Uploads &amp; Unterschriften</a> für die Details.
</p>

<h3 id="payment">Zahlung</h3>
<p>
  Das <strong>Payment</strong>-Feld erhebt eine einmalige Gebühr. Lege den <strong>Betrag</strong> und die <strong>Währung</strong> am Block
  fest — USD, EUR, GBP, JPY, CAD, AUD, CHF, SEK, NOK, DKK, NZD, SGD, HKD, AED oder TRY. Jede Währung hat einen Mindestbetrag (0,50 für USD
  und EUR), und die Veröffentlichung ist gesperrt, bis Stripe verbunden und der Betrag gültig ist. Siehe{' '}
  <a href="/de/building-forms/payment-collection">Zahlungserhebung</a>.
</p>

<h2 id="default-values">Standardwerte aus anderen Feldern</h2>
<p>
  Der Standardwert eines Feldes kann statt aus festem Text aus einem anderen Feld im selben Formular stammen — einem versteckten Feld (zum
  Beispiel einem URL-Parameter) oder einem berechneten Feld. Es funktioniert bei den sechs Eingaben, die einen Standardwert-Slot haben:{' '}
  <strong>Text Input</strong>, <strong>Text Area</strong>, <strong>Email</strong>, <strong>Website URL</strong>,{' '}
  <strong>Phone Number</strong> und <strong>Number</strong>.
</p>
<p>So richtest du es ein:</p>
<ol>
  <li>Klicke in das Eingabefeld.</li>
  <li>
    Tippe <kbd>@</kbd> als erstes Zeichen. Ein Menü listet deine versteckten und berechneten Felder auf; tippe weiter, um zu filtern.
  </li>
  <li>
    Wähle ein Feld aus. Die Eingabe wechselt von selbst in den <strong>Standardwert</strong>-Modus und zeigt das Feld als Chip, zum Beispiel{' '}
    <strong>@recipient</strong>.
  </li>
</ol>
<p>
  Um die Verknüpfung zu entfernen, klicke auf das <strong>×</strong> am Chip, drücke <kbd>Backspace</kbd>, oder drücke erneut <kbd>⌘</kbd> +{' '}
  <kbd>D</kbd>. Wenn du stattdessen ein wörtliches <kbd>@</kbd> möchtest — etwa einen Platzhalter wie <code>@yourhandle</code> —, drücke{' '}
  <kbd>Esc</kbd>, um das Menü zu schließen, und tippe weiter; die Eingabe bleibt in dem Modus, in dem sie sich befand. Ein Chip wird rot,
  wenn das zugehörige Feld gelöscht wurde; fügst du ein Feld mit demselben Namen erneut hinzu, wird die Verknüpfung wiederhergestellt.
</p>
<p>
  Der Chip ersetzt den Platzhaltertext des Feldes. Das <kbd>@</kbd> öffnet das Menü nur als erstes Zeichen, sodass ein Standardwert wie{' '}
  <code>jeff@example.com</code> als reiner Text erhalten bleibt.
</p>
<p>
  Wenn jemand das Formular öffnet, wird das Feld mit dem referenzierten Wert vorausgefüllt — ein Link, der zum Beispiel mit{' '}
  <code>?recipient=Jeff</code> endet, füllt ein Text Input-Feld, das auf das versteckte Feld <code>recipient</code> verweist, mit "Jeff". So
  verhält es sich:
</p>
<ul>
  <li>Befragte können den Wert ändern oder löschen. Ihre eigene Antwort wird nie überschrieben.</li>
  <li>
    Ein berechnetes Feld füllt die Eingabe mit seinem ersten Wert — meist dem Anfangswert. Spätere Änderungen durch Logikregeln ersetzen
    nicht, was bereits in der Eingabe steht.
  </li>
  <li>
    Hat das referenzierte Feld keinen Wert, bleibt die Eingabe zunächst leer. Ein Number-Feld bleibt außerdem leer, wenn der Wert keine Zahl
    ist (zum Beispiel <code>?age=abc</code>).
  </li>
  <li>Die Einreichung speichert beide Werte: das versteckte oder berechnete Feld und die endgültige Antwort auf die Frage.</li>
</ul>
<p>
  Siehe <a href="/de/building-forms/hidden-fields">Versteckte Felder</a> und{' '}
  <a href="/de/building-forms/calculated-fields">Berechnete Felder</a>.
</p>

<h2 id="examples">Beispiele</h2>

<ul>
  <li>
    <strong>Kontaktformular</strong> — Email-Feld als Pflichtfeld markiert, Text Area für die Nachricht mit Platzhalter "Wie können wir
    helfen?", Phone Number-Feld als optional markiert, mit einem Absatz darunter: "Wir rufen nur an, wenn wir Rückfragen zu deiner Anfrage
    haben"
  </li>
  <li>
    <strong>NPS-Umfrage</strong> — Star Rating auf 10 Sterne gesetzt, gefolgt von einer Text Area (standardmäßig ausgeblendet, per Logik
    eingeblendet bei einem Wert von 6 oder weniger) mit Platzhalter "Was könnten wir verbessern?"
  </li>
  <li>
    <strong>Produktbestellung</strong> — Number-Feld für die Menge mit min. 1 / max. 100, Checkboxes für Zusatzoptionen und ein
    Zahlungsfeld, dessen Betrag von einem berechneten Feld gesteuert wird
  </li>
  <li>
    <strong>Veranstaltungs-RSVP</strong> — Radio Buttons für die Teilnahme, Checkboxes für Ernährungsanforderungen mit zufälliger
    Reihenfolge zur Vermeidung von Verzerrungen, Date Picker mit einem festgelegten frühesten Datum
  </li>
</ul>
<h2 id="validation-rules">Validierungsregeln</h2>

<p>
  Die Validierung läuft, während der Befragte dein Formular ausfüllt. Formstep hebt fehlerhafte Eingaben direkt hervor und verweigert das
  Absenden, bis alles korrekt ist.
</p>

<h3 id="built-in-validation">Integriert nach Feldtyp</h3>

<p>
  Jeder Fragetyp prüft seine eigene Form, ohne dass etwas zu konfigurieren wäre. <strong>Email</strong> prüft das Adressformat.{' '}
  <strong>Website URL</strong> akzeptiert nur http- und https-Links und lehnt einen Host ab, der keine echte Domain ist.{' '}
  <strong>Phone Number</strong> prüft die Nummer gegen das ausgewählte Land. <strong>Number</strong>, <strong>Date Picker</strong> und{' '}
  <strong>Time Picker</strong> lehnen alles ab, was keine Zahl, kein Datum oder keine Uhrzeit ist.
</p>

<p>
  Im Business-Plan können E-Mail-Fragen zusätzlich eine Verifizierung erfordern — der Befragte bestätigt seine Adresse mit einem Einmalcode,
  bevor das Formular die Einreichung annimmt. Der Schalter liegt unter <strong>Validierung → Verifizierung</strong>. Siehe{' '}
  <a href="/de/building-forms/email-verification">E-Mail-Verifizierung für Befragte</a>.
</p>

<h3 id="optional-rules">Optionale Regeln pro Feld</h3>

<p>
  Öffne das Blockmenü und wähle <strong>Validierung</strong>. Welche Regeln verfügbar sind, hängt vom Fragetyp ab; dies sind die exakten
  Menübezeichnungen.
</p>

<p>
  Radio Buttons, Dropdown, Toggle Switch, Signature, Ranking, Payment und Schedule appointment haben keine Validierungsregeln — erforderlich
  oder nicht ist die einzige Wahl. Innerhalb einer Wiederholungsgruppe wird keine E-Mail-Verifizierung angeboten.
</p>

<h3 id="custom-patterns">Beispiele für benutzerdefinierte Muster</h3>

<ul>
  <li>
    <strong>US-Postleitzahl</strong> — <code>{`^\\d{5}(-\\d{4})?$`}</code>
  </li>
  <li>
    <strong>Hex-Farbcode</strong> — <code>{`^#[0-9a-fA-F]{6}$`}</code>
  </li>
  <li>
    <strong>URL-freundlicher Slug</strong> — <code>{`^[a-z0-9-]+$`}</code>
  </li>
</ul>

<p>
  Ein nicht passender Wert zeigt den allgemeinen Fehler „Ungültiger Wert", füge daher einen Absatz in der Nähe des Feldes hinzu, der das
  erwartete Format beschreibt. Ein ungültiger Regex wird ignoriert und blockiert das Absenden nie. Längenregeln zählen Zeichen, nachdem
  führende und nachgestellte Leerzeichen entfernt wurden.
</p>

<h3 id="how-validation-runs">So läuft die Validierung ab</h3>

<p>
  Formstep prüft die Validierung live im Browser, während der Befragte tippt. Format- und Regelfehler erscheinen sofort mit einer
  Inline-Meldung; ein Fehler „Dieses Feld ist erforderlich" erscheint, sobald das Feld berührt wurde oder wenn der Befragte versucht
  abzusenden.
</p>

> ⚠️ **Sensible Daten nicht nur mit Regex validieren**
> <p>
>     Für Dinge wie Kreditkarten oder Ausweisdaten nutze den passenden Feldtyp oder eine Integration. Regex prüft die Form, nicht die
>     Gültigkeit.
>   </p>

<h2 id="next-steps">Nächste Schritte</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [Antwort-Piping](/de/building-forms/answer-piping) — Verwende @-Erwähnungen, um Antworten überall in deinem Formular zu referenzieren.
  - [Bedingte Logik](/de/building-forms/conditional-logic) — Felder basierend auf Antworten ein- oder ausblenden
  - [Versteckte Felder](/de/building-forms/hidden-fields) — URL-Parameter unsichtbar erfassen
  - [Berechnete Felder](/de/building-forms/calculated-fields) — Punkte, Summen und dynamische Werte berechnen
</div>