Formfields
Formfields define the input controls in your forms. Each field type has its own properties and behaviors for collecting different types of data.
AnsibleForms supports a wide variety of formfield types, from simple text inputs to complex tables and expressions. Choose the right field type based on the data you need to collect.
Common Properties
All formfields share two fundamental properties:
- name (string, required): The unique identifier for the field
- type (string, required): The field type - determines which page below describes the available properties
Each field type has additional properties specific to its functionality. Click on a field type below to see its complete property reference.
Browse the formfield types using the navigation sidebar, or refer to the table below:
| 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 |
| table | (deprecated) A table input field - use |
| list | A list of structured rows edited through a reusable subform (supersedes |
| yaml | A YAML editor field with syntax highlighting and validation |