0 0 0 0

NEX-Forms Documentation

Documentation & Tutorials for NEX-Forms version 8.0 and above

Single Line Text Fields

Single line text fields in NEX-Forms are perfect for capturing concise pieces of information from users. These fields allow users to input a single line of text, making them ideal for collecting short answers such as names, email addresses, phone numbers, or brief comments. With customizable options like placeholder text and validation rules, single line text fields provide a seamless and efficient way to gather essential data while ensuring its accuracy.

In this Article

How to add a single line text field to a form
Single Line Text Fields are found in the draggable fields and elements toolbar under the "Input Fields" section and is represented with this icon:
  1. Create a new form or edit an existing form
  2. Click to add the field to the form or drag the field from the tools menu into position inside the form.
    NEX-Forms - Figure Arrow
    NEX-Forms - Figure Arrow
    NEX-Forms - Form Fields and Elements - Text Fields - figure - 1
Text field input settings
This section provides a comprehensive guide to understanding and effectively utilizing all the input settings available for NEX-Forms Text Fields. Learn how to configure text fields to suit your needs.
  1. Edit the field by hovering over it and then click on the Edit Icon which will bring up the field settings panel.
    NEX-Forms - Figure Arrow
    NEX-Forms - Form Fields and Elements - Editing a Field
  2. Click on the "INPUT" tab from the settings panel.
    NEX-Forms - Figure Arrow
    NEX-Forms - Form Fields and Elements - Text Fields - figure - 3
General settings
The below table shows all General Input settings, their functions and actual NEX-Forms input field examples where applicable.
NEX-Forms - General Field Settings - Figure 5
General text field setting definitions
Setting Definition
Input Name

Sets the name of the input field itself. By default when you enter a field's Main Label the Input Name will reflect that text in an input name format.

Input Names are formatted to lowercase with special characters removed and spaces are replaced with underscores. For example: if you have a field called "What's Your Email Address?" the input field will automattically be formatted to whats_your_email_address. When using multi-selection fields the field name will have a [] postfix, for example: your_favourite_animals[]

IMPORTANT:
• One form can not have 2 or more fields with the same input names.
• All input names in a single form needs to be unique.
• An input field name can not be blank.
TIP: If you need two or more fields to have the same label then you can edit these field's input names to be unique while still having the same labels for the fields.
NOTE: Reserved WordPress terms (parameters) like name, page, post, category, id will be prefixed with an underscore to avoid conflict, for example: name will become _name
Input ID Gives the Input an ID. Useful if you need to tager fields by thier id's from 3rd party scripts or CSS (Cascading Style Sheets)
Setting Definition Example
Input Placeholder Sets the input's placeholder text - Placeholder text is displayed inside the input field when it is empty and not focused, serving as a temporary label or prompt for users. Once the user starts typing or focuses on the input field, the placeholder text disappears, making way for the user's input.

See example field to the right with placeholder Email Address
Disabled
NEX-Forms - Disabled Field - 1 Sets the field enabled - The field is made editable to the user.
NEX-Forms - Disabled Field - 2 Sets the field to be "Disabled" - The field is made uneditable to the user.
Default value & input styling
The below table shows all General Input settings, their functions and actual NEX-Forms input field examples.
NEX-Forms - General Field Settings - Figure 5
Default value & input styling definitions
Setting Definition Example
Default Value Sets the field default value. For example, give you user a head start for entering a website's address by giving the field a default value of https://
(bold) If active sets the input text to bold
(Italic) If active sets the input text to italic
(Underline) If active sets the input text underlined
Font Size Sets the font size of the input text
TX (Text color) Sets the input field's text color
BG (Background color) Sets the input field's background color
BRD (Border width and color) Sets the input field's border width (size) and border color
(Align Text Left) If active aligns the text to the left inside the input field
(Align Text Center) If active aligns the text center inside the input field
(Align Text Right) If active aligns the text to the right inside the input field
Input Size
NEX-Forms - Field Size - 1 Small - Sets the input field size to small
NEX-Forms - Field Size - 2 Normal - Sets the input field size to normal size
NEX-Forms - Field Size - 3 Large - Sets the input field size to large
Corners
NEX-Forms - Field Corners - 1 Squared - Sets the input field's corners square
NEX-Forms - Field Corners - 2 Rounded - Sets the input field's corners rounded
NEX-Forms - Field Corners - 3 Pilled - Sets the input field's corners fully rounded (pilled)
Text Field Validation
Text field validation in NEX-Forms ensures that the data entered by users meets specific criteria before the form can be successfully submitted. This helps maintain data integrity and prevents incorrect or incomplete submissions. Here’s a detailed explanation of how text field validation works in NEX-Forms:
  1. Edit the text field by hovering over it and then click on the Edit Icon which will bring up the field settings panel.
    NEX-Forms - Figure Arrow
    NEX-Forms - Form Fields and Elements - Editing a Field
  2. Click on the "VALIDATION" tab from the settings panel.
    NEX-Forms - Figure Arrow
    NEX-Forms - Form Fields and Elements - Text Fields - figure - 3
Input Format Validation
Allows you to specify the type of data that should be entered into a text field. This validation ensures that the user inputs data in the correct format, such as email addresses, phone numbers, URLs, or other specific types of text.
NEX-Forms - Figure Arrow
NEX-Forms - General Field Settings - Figure 5
Validate As Option Definitions
Validation Type Definition Example
Any Format Allows the user to enter anything into the text field.
Email Ensures the user inputs a valid email address format (e.g., user@example.com).
URL Ensures the user inputs a valid web address format (e.g., http://example.com).
Phone Number Ensures the user inputs a valid phone number format.
Numbers Only Ensures the user inputs only numeric values.
Text Only Ensures the user inputs alphabetical characters only, typically used for standard text fields without specific format requirements.


ALSO SEE: Essential Field Validation for learing how to make a field required/manditory.
Other Text Field Validation Options
NEX-Forms - General Field Settings - Figure 5
Other Text Field Validation Option Definitions
Option Definition Example
Secondary Error Message The secondary error message referes to the msssage displayed if a user does not enter the correct validation format. For example if you have a field set to be validated as an email address then you can set your secondary message to be something like "Invalid Email Address" if the user fails to input the correct format.
Maximum Characters Restricts the number of characters that can be entered into a text field. Once the user reaches the specified character limit, they will not be able to input any more characters into that field.

NOTE: Leave this setting empty for no limits.
Minimum Characters Sets the minimum number of characters a user must input into a text field for the form to be submitted successfully. This feature is useful for ensuring that users provide sufficient information, especially for fields where brief or incomplete responses would be inadequate.

NOTE: Leave this setting empty for no limits.


ALSO SEE: Essential Field Validation for learing how to make a field required/manditory.
Input Masking
Input masking in NEX-Forms text fields allows you to control the format of the input by enforcing a specific pattern. This is particularly useful for fields like phone numbers, dates, and social security numbers, where the input must follow a defined format. You can set an input's mask in text field's validation options:
NEX-Forms - Figure Arrow
NEX-Forms - General Field Settings - Figure 5
Input Mask Examples
An input mask defines the allowed characters and their positions in the input field. Common symbols used in input masks include:
0 = Numbers 0-9
S = Alphabetic A-Z a-z
A = Alphanomeric 0-9 A-Z a-z

Special characters like -, /, and ( are used as literal characters that the user must input.
Pattern Mask Example
License key:
AAAA-AAAA-AAAA-AAAA
Date:
00/00/0000
Time:
00:00:00
IP Address:
099.099.099.099
Was this article helpful?
Yes
No
Still having trouble? How can we help you?
This article was last updated on 19 November 2024
Stay in Touch
Get the latest NEX-Forms news and info by following us on:
In this article