Campos de formulário

Os controlos de entrada de um formulário


Para autores de formulários: os tipos de campo que um formulário pode conter e as propriedades que cada um suporta.

Os campos de formulário definem os controlos de entrada de um formulário. Cada tipo de campo tem as suas próprias propriedades e comportamento para recolher um tipo de dados concreto.

Escolha o tipo de campo que corresponde aos dados a recolher, desde texto simples até listas estruturadas.


Propriedades comuns

Todos os campos de formulário partilham duas propriedades fundamentais:

  • name (string, obrigatório): o identificador único do campo
  • type (string, obrigatório): o tipo de campo, que determina a página abaixo que descreve as propriedades disponíveis

Cada tipo de campo acrescenta propriedades próprias da sua função. Selecione um tipo de campo na barra lateral de navegação ou na tabela abaixo para abrir a referência completa das suas propriedades:

Tipo de campo Descrição
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