Felder und Validierung

Felder sind optional. Ein Formular ohne Felder akzeptiert alle Daten, die dein Formular sendet. Sobald du Felder veröffentlichst, validiert Ikiform jede Einsendung auf dem Server dagegen, lehnt fehlerhafte Daten mit klaren Meldungen ab und speichert saubere, typisierte Werte.

Felder definieren

Öffne ein Formular im Dashboard und gehe zu Fields. Füge Felder im visuellen Editor hinzu oder bearbeite die JSON-Definition direkt. Die id jedes Felds ist der Input-name, den dein Formular senden muss.

{
  "version": 1,
  "title": "Contact",
  "fields": [
    { "id": "name", "type": "text", "label": "Name", "required": true, "validation": { "max_length": 120 } },
    { "id": "email", "type": "email", "label": "Email", "required": true },
    {
      "id": "topic",
      "type": "select",
      "label": "Topic",
      "options": [
        { "value": "sales", "label": "Sales" },
        { "value": "support", "label": "Support" }
      ]
    },
    { "id": "message", "type": "textarea", "label": "Message", "validation": { "min_length": 10 } }
  ],
  "settings": { "submit_label": "Send", "success_message": "Thanks, we'll reply within a day." }
}

Die Definition

Unbekannte Schlüssel werden abgelehnt, auf oberster Ebene und bei jedem Feld, sodass ein Tippfehler wie requried beim Speichern als Fehler erscheint.

Schlüssel jedes Felds

Playground

{
  "ok": true,
  "id": "sub_01k7v2c9t3e8m5q4x6z0a1b2c3"
}

Feldtypen

text

Patterns laufen mit dem Flag u und müssen auf den ganzen Wert passen. Beim Speichern lehnt Ikiform Patterns ab, die katastrophales Backtracking verursachen könnten: Rückreferenzen, wiederholte Gruppen, die Wiederholungen oder Alternativen enthalten ((a+)+, (a|b)*), und zu viele verschachtelte Wiederholungen.

textarea

email

Adressen mit mehr als 254 Zeichen werden abgelehnt. Der Domain-Teil wird in Kleinbuchstaben gespeichert; der Teil vor @ bleibt wie gesendet.

number

select, radio und multi_select

Nur aufgelistete Werte werden akzeptiert. select und radio nehmen einen Wert; sende multi_select als wiederholte Namen, name[] oder als JSON-Array.

checkbox

Keine zusätzlichen Schlüssel. Eine fehlende Checkbox ist false. required: true bedeutet, dass sie angehakt sein muss, was zu Einwilligungs-Checkboxen passt. Andere Werte als on, true, 1, yes, off, false, 0, no oder leer werden abgelehnt.

date

url

Akzeptiert werden nur http:- und https:-URLs mit einem Hostnamen, der einen Punkt enthält, und ohne Benutzername oder Passwort. Gespeichert wird die normalisierte URL.

phone

Ohne e164 braucht eine Telefonnummer 6 bis 15 Ziffern und wird wie gesendet gespeichert. Damit wird +1 (415) 555-0123 als +14155550123 gespeichert.

rating

Typumwandlung

HTML-Formulare senden alles als Text. Ikiform wandelt es vor dem Speichern in den Typ um, den jedes Feld deklariert. Mit name als Text, email, guests als Zahl, newsletter als Checkbox, site als URL und phone als Telefonfeld:

name=++Ada+Lovelace++&email=Ada@Example.COM&guests=3&newsletter=on&site=example.com&phone=%2B1%20415%20555%200123

{
  "name": "Ada Lovelace",
  "email": "Ada@example.com",
  "guests": 3,
  "newsletter": true,
  "site": "https://example.com/",
  "phone": "+14155550123"
}

• Werte werden getrimmt. Ein leerer String gilt als fehlend.
• Ein Feld, das einen Wert erwartet, lehnt ein Array mit mehr als einem Element ab.
• Zahlen akzeptieren einfache Dezimal- und Exponentialschreibweise mit bis zu 64 Zeichen, etwa 3, -2.5 oder 1e3.

Validierungsfehler

Eine Einsendung, die die Validierung nicht besteht, wird mit 422 validation_failed abgelehnt, und nichts wird gespeichert. error.fields ordnet jeder Feld-ID ihre Meldungen zu. Bei Posts aus dem Browser erscheinen dieselben Meldungen auf einer gehosteten Fehlerseite, beschriftet mit deinen Feld-Labels.

{
  "ok": false,
  "error": {
    "code": "validation_failed",
    "message": "Some fields are invalid.",
    "fields": {
      "email": ["Enter a valid email address"],
      "website": ["Unknown field \"website\""]
    }
  },
  "request_id": "req_01k7v2c9t3e8m5q4x6z0a1b2c3"
}

Unbekannte Felder

Wenn Felder definiert sind, wird jedes Feld, das nicht in der Definition steht, als Unknown field "name" abgelehnt. Reservierte Felder, die mit _ beginnen, der Honeypot und cf-turnstile-response zählen nicht. Ohne Definition werden beliebige Feldnamen akzeptiert.

Meldungen

Im Browser validieren

validate im SDK spiegelt die Server-Regeln und -Meldungen für alle 12 Feldtypen, sodass du Fehler schon vor dem Absenden anzeigen kannst. Der Server bleibt die maßgebliche Instanz. Siehe validate.