Skip to main content

Text Input

Overview

Text input fields allows users to enter any combination of letters, numbers and symbols. Text inputs can span single or multiple lines. It’s recommended that a character count be set for each field, especially multi-line boxes.

text field

Contents

Usability Guidelines Rules

Use an appropriate length for input. For instance, a field for collecting Zip Code information should be single line and only as long as a Zip Code. While a paragraph entry should use a multi-line box.

Users should be able to paste content for ease of filling out information.

Consider context, it may be easier to collect information using a different field type especially on touch screen keyboards.

Make sure each field has a label.

All fields are required unless marked as optional.

Auto-fill, when choosing from specific options, auto-fill options should be made available to the users. For instance U.S. States and Territories.

Avoid splitting numbers such as phone numbers, social security, credit cards into different boxes. Use one field with text masking to help guide the users (see example below).

text box options

Accessibility

Along with the guidance above, be sure to follow the general accessibility requirements from the USWDS.

Validation

Do not show error messages until after the user has left the field. Validation errors that can be displayed before form submission should be. For example leaving a required field empty after leaving the field.

Provide visual feedback to the state of the current field: text box focus text box error text box success

Code

HTML

  ![text field](../assets/img/forms/text-field.png "Text Field")

SCSS