University at Buffalo - The State University of New York
Skip to Content
UB Web Management

Transforming UB’s digital communications through process and tools

Text Field Component

Provide a place on your form for visitors to enter information such as a name, number, or email.

The UBCMS is not an appropriate place for ANY regulated private data, such as bank credit/debit card numbers, government-issued ID numbers, health information or computer passwords.

We discourage building forms in shared content -- this practice may interfere with normal functionality, such as validation.

The component after being dropped into a form.

The component after being dropped into a form.

Using This Component

Add the component to the page between the Start of Form and End of Form sections of the Form Container component. There are four tabs: Title and Text, Initial Values, Constraints, and Size.

Title and Text Tab

Element Name: Specify the name to be associated with this field when the data is stored or emailed. Required.

  • It may contain only numbers, letters and selected special characters (the underscore, period, backslash, colon and hyphen).
  • Not visible to the public.

Title: This is the descriptive label your visitor will see on the page.

Hint: Provide assistance for people completing the form. Appears in paler italics below the associated field.

 

The multiple values setting in use.

The multiple values setting in use.

Property is multi value: When selected, a small "+" is added to the field so that the visitor can add multiple separate values.  

 

Only show value - When this is selected, the field only displays a preset 'default value' or a value sent to the page through 'Use parameters'. This information will be displayed to the page visitor and also collected onc ethe form is submitted, but the visitor will not be able to change it.

The component opened for editing showing the Title and Text Tab settings.

The component opened for editing showing the Title and Text Tab settings.

Initial Values Tab

Default value: Stipulate a default value that will be displayed on the form and used unless the visitor makes a different selection.

Use parameters: Select if desired. Developers only!

  • Allows authors to preload this form value from the URL that loaded the form. 
  • e.g. If the field name is 'myfield' and the page URL is '…/form.html?myfield=123' then the default value of the field when the form is first loaded would be "123."
  • This can be useful to solve a variety of things, such as a contact form that is preloaded with a different 'To' address depending on which link was first clicked. While the initial destination would be pre-selected, the visitor could see that choice and adjust as necessary.
The component opened for editing showing the Initial Values Tab settings

The component opened for editing showing the Initial Values Tab settings

Contraints Tab

This tab controls whether completion of this field is required and what constraints are being enforced (for example, must be a phone number). May also be used to customize form error messages.

Required: Completion of this field is mandatory before submission of the form is permitted.

Required Message: Insert a custom message to be displayed if the submitter neglects to complete this field.

List of available constraints.

The component opened for editing showing the Constraints Tab settings.

Constraint: choose from the following:

  • None (default)
  • Date: Validates if the field contains a date. Acceptabled formats:
    • yyyy-MM-dd'T'HH:mm:ss.SSSZ    (like 2009-12-21T14:45:00.000+01:00)
    • yyyy-MM-dd'T'HH:mm:ss    (like 2009-12-21T14:45:00)
    • yyyy-MM-dd    (like 2009-12-21)
    • dd.MM.yyyy HH:mm:ss    (like 21.12.2009 14:45:00)
    • dd.MM.yyyy    (like 21.12.2009 14:45:00)
  • Email: Validates if the field contains an email address (a@b.c).
  • Event Basics Constraint: Validates if the field contains a title and valid date.
  • Link spam filter: Disallows basic link spam (rejects HTML that appears to be embedded links).
  • Month (numeric): Requires a month as a number (01-12).
  • Name (no umlauts): Requires letters (some additional characters are allowed, like a period or hyphen).
  • Numeric: Requires numbers.
  • UB Email: Requires a valid UB email address (something@buffalo.edu). 
  • US Date: Requires a valid date, in US format (i.e. month day year). Acceptabled formats:
    • MM-dd-yyyy'T'HH:mm:ss.SSSZ    (like 12-21-2009T14:45:00.000+01:00)
    • MM-dd-yyyy'T'HH:mm:ss    (like 12-21-2009T14:45:00)
    • MM-dd-yyyy    (like 12-21-2009)
    • MM/dd/yyyy HH:mm:ss    (like 12/21/2009 14:45:00)
    • MM/dd/yyyy    (like 12/21/2009)
  • Year: Requires a valid year number.

CIT privacy policy preclude the request for credit card information in the UBCMS. Please ignore the Luhn Algorithm Validator and the second Year ("Requires a CCV) constraint settings.

Constraint Message: Insert a custom message to be displayed if the submitter fails to successfully complete this field based on the above constraint.

Size Tab

Size: Set the prefered displayed size in columns and rows.

Width: Set a maximum display size in pixels.

The component opened for editing showing the Size Tab settings.

The component opened for editing showing the Size Tab settings.

Restrictions

  1. This component must be placed between the Start of Form and End of Form sections of the Form Container component.
  2. The UBCMS is not an appropriate place for ANY regulated private data, such as bank credit/debit card numbers, government-issued ID numbers, health information or computer passwords.
  3. We discourage building forms in shared content -- this practice may interfere with normal functionality, such as validation.

Was this page helpful?

(Required)
(Required)
(so we can thank you or request more details)
(Required)
(buffalo.edu addresses only please)

On this page:

Read more about forms in our Advanced Topics.

Want to start your form with preloaded values? See Use Parameters.

See an Example:

 
(this is a live example)

Related Components:

Last Reviewed:

October 26, 2016