Champs de formulaire

Les contrôles de saisie d’un formulaire


Pour les auteurs de formulaires : les types de champ qu’un formulaire peut contenir, et les propriétés prises en charge par chacun.

Les champs de formulaire définissent les contrôles de saisie d’un formulaire. Chaque type de champ a ses propres propriétés et son propre comportement pour recueillir un type de données particulier.

Choisissez le type de champ qui correspond aux données à recueillir, du texte simple aux listes structurées.


Propriétés communes

Tous les champs de formulaire partagent deux propriétés fondamentales :

  • name (string, obligatoire) : l’identifiant unique du champ
  • type (string, obligatoire) : le type de champ, qui détermine laquelle des pages ci-dessous décrit les propriétés disponibles

Chaque type de champ ajoute des propriétés propres à sa fonction. Sélectionnez un type de champ dans la barre de navigation latérale ou dans le tableau ci-dessous pour ouvrir la référence complète de ses propriétés :

Type de champ Description
text

A text input field

textarea

A textarea input field

datetime

A datetime input field

html

An HTML field. The html is sanitized before it is rendered: <script>, event handlers (onclick, onerror, …) and javascript: links are always removed. A link may carry target="_blank" to open in a new tab ; rel="noopener noreferrer" is added automatically.

file

A file upload field, the file is uploaded prior to the job start and the extravars will contain the uploaded file info.

number

A number input field

password

A password masked input field

checkbox

A checkbox field

radio

A radio field (multi options)

enum

A multi-column filterable dropdown box

expression

A powerfull javascript driven expression field

list

A list of structured rows edited through a reusable subform (replaces the table field, removed in 7.0.0)

yaml

A YAML editor field with syntax highlighting and validation