Overview
The Text field is a form field type that allows users to input a single line of data (letters, numbers, or special characters) onto the form.
How to Add and Configure a Text Field
- In the Form Builder, select the Text field from the Add Fields menu on the left to add it to your form.
- Select the pencil icon next to the name of the field on the form to change its name. This will be the prompt that users will see on the form in the app (E.g., Enter your name).
- Optional: Use the Text Settings menu on the right to configure the character length, character format, hint text, and more. See below for a guide on the related terms and options:
Configuration
| Setting | Description |
|---|---|
| Field Label | The label displayed for the field. This is usually displayed at the top left corner above the field. |
| Field Key | A Key used to reference the field in submission data. The key is also used to reference the field in rules and calculations. |
| Default Value | The value that will be used to pre-populate the field when the form is initially opened. |
| Hint Text | The text that is displayed if the field has no value set, e.g. "Please enter a value" |
| Enforce Min/Max | If set will enforce the Min Length and Max Length settings. |
| Minimum Length | The minimum required length of characters required for a valid value. |
| Maximum Length | The maximum number of characters allow for entry into the field. |
| Memory Field | If a previous form containing the same Field Key has a value set, it's value will be pre-populated for this field when the form is first opened. |
| Rules | A Rule or JavaScript snippet that allows you to perform actions on fields or sections within the form. The actions can include hide, show, enable, disable, showSection and hideSection. Rules are executed on field value changes and when the form is opened. ex. if ($field1$ > 23) { hide(); } else { show(); } (Please see the Introduction to Rules Document for more information) |
| Required | Sets the field to have required input. You will not be able to submit the form until this field has valid input. |
| Enabled | If not set the field will be visible but cannot be edited or set to accept new input. |
| Hide Field Label | Hides the Field Label. |
| Hidden | If enabled the field and all labels are not visible. |
| Exclude From Reports | If checked, the field will be excluded from HTML and PDF reports and will also be excluded from Excel and CSV exports. |
| Capture Geo Location | Capture the current latitude and longitude when the acknowledgment button is clicked. |
| Capture Time Stamp | Capture the current date and time when the acknowledgment button is clicked. |
| Alert Type | Choose a theme to change the background and font colors of the field cell as displayed in the apps. |
| Secure | If set the input is masked from view with a * character. |
Result Data
| Data Type | Domain of Values | Example JSON |
|---|---|---|
| String | N/A | { "singlelinealpha_1": "hello" } |