Camps de formulari

Els controls d’entrada d’un formulari


Per als autors de formularis: els tipus de camp que pot contenir un formulari i les propietats que admet cadascun.

Els camps de formulari defineixen els controls d’entrada d’un formulari. Cada tipus de camp té les seves pròpies propietats i el seu propi comportament per recollir un tipus concret de dades.

Tria el tipus de camp que correspongui a les dades que vols recollir, des de text pla fins a llistes estructurades.


Propietats comunes

Tots els camps de formulari comparteixen dues propietats fonamentals:

  • name (string, obligatori): l’identificador únic del camp
  • type (string, obligatori): el tipus de camp, que determina quina de les pàgines següents descriu les propietats disponibles

Cada tipus de camp afegeix propietats pròpies de la seva funció. Selecciona un tipus de camp a la barra lateral de navegació o a la taula següent per obrir la referència completa de les seves propietats:

Tipus de camp Descripció
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