Champs et validation

Les champs sont facultatifs. Un formulaire sans champs accepte toutes les données qu'il reçoit. Dès que vous publiez des champs, Ikiform valide chaque soumission par rapport à eux côté serveur, refuse les données invalides avec des messages clairs et stocke des valeurs propres et typées.

Définir les champs

Ouvrez un formulaire dans le tableau de bord et allez dans Fields. Ajoutez des champs dans l'éditeur visuel ou modifiez directement la définition JSON. L'id de chaque champ est le name d'input que votre formulaire doit envoyer.

{
  "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." }
}

La définition

Les clés inconnues sont refusées, à la racine comme sur chaque champ, donc une faute de frappe comme requried apparaît comme une erreur à l'enregistrement.

Clés communes à tous les champs

Bac à sable

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

Types de champs

text

Les patterns s'exécutent avec le flag u et doivent correspondre à la valeur entière. À l'enregistrement, Ikiform refuse les patterns susceptibles d'un backtracking catastrophique : références arrière, groupes répétés contenant des répétitions ou des alternatives ((a+)+, (a|b)*), et trop de répétitions imbriquées.

textarea

email

Les adresses de plus de 254 caractères sont refusées. La partie domaine est stockée en minuscules ; la partie avant @ est gardée telle qu'envoyée.

number

select, radio et multi_select

Seules les valeurs listées sont acceptées. select et radio prennent une seule valeur ; envoyez multi_select sous forme de noms répétés, de name[] ou d'un tableau JSON.

checkbox

Pas de clé supplémentaire. Une case absente vaut false. required: true signifie qu'elle doit être cochée, ce qui convient aux cases de consentement. Les valeurs autres que on, true, 1, yes, off, false, 0, no ou vide sont refusées.

date

url

Seules les URL http: et https: avec un nom d'hôte contenant un point, sans nom d'utilisateur ni mot de passe, sont acceptées. La valeur stockée est l'URL normalisée.

phone

Sans e164, un numéro de téléphone doit avoir de 6 à 15 chiffres et est stocké tel qu'envoyé. Avec, +1 (415) 555-0123 est stocké sous la forme +14155550123.

rating

Conversion

Les formulaires HTML envoient tout sous forme de texte. Ikiform convertit chaque valeur dans le type déclaré par le champ avant de la stocker. Avec name en texte, email, guests en nombre, newsletter en case à cocher, site en URL et phone en téléphone :

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"
}

• Les espaces en début et fin de valeur sont retirés. Une chaîne vide compte comme absente.
• Un champ qui attend une seule valeur refuse un tableau de plus d'un élément.
• Les nombres acceptent la notation décimale et exponentielle jusqu'à 64 caractères, comme 3, -2.5 ou 1e3.

Erreurs de validation

Une soumission qui échoue à la validation est refusée avec 422 validation_failed et rien n'est stocké. error.fields associe chaque id de champ à ses messages. Les envois depuis un navigateur affichent les mêmes messages sur une page d'erreur hébergée, avec les libellés de vos champs.

{
  "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"
}

Champs inconnus

Avec des champs définis, tout champ absent de la définition est refusé avec Unknown field "name". Les champs réservés qui commencent par _, le honeypot et cf-turnstile-response ne comptent pas. Sans définition, tous les noms de champs sont acceptés.

Messages

Valider dans le navigateur

Le validate du SDK reproduit les règles et messages du serveur pour les 12 types de champs, ce qui permet d'afficher les erreurs avant l'envoi. Le serveur reste la référence. Voir validate.