Formfields
The input controls of a form
For form authors: the field types a form can hold, and the properties each one supports.
Formfields define the input controls of a form. Each field type has its own properties and behavior for collecting a particular kind of data.
Pick the field type that matches the data to collect, from plain text to structured lists.
Common Properties
All formfields share two fundamental properties:
- name (string, required): the unique identifier of the field
- type (string, required): the field type, which determines the page below that describes the available properties
Each field type adds properties specific to its function. Select a field type in the navigation sidebar or in the table below to open its complete property reference:
| Field Type | 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: |
| 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 |
| yaml | A YAML editor field with syntax highlighting and validation |